كيف أربط Keygen لإصدار مفاتيح ترخيص البرمجيات تلقائيًا؟
ألصق معرّف حساب Keygen ورمز API، فيُصدر كل شراء لمنتج مرخَّص مفتاح ترخيص Keygen حقيقيًا يظهر في طلب المشتري — ويُعلَّق إذا استرجعت الطلب.
يُصدر موصل Keygen مفتاح ترخيص برمجيات حقيقيًا لحظة شراء أحدهم منتجًا رقميًا مرخَّصًا — دون توليد يدوي للمفاتيح ودون جدول بيانات لمتابعة الرموز المستعملة.
تثبيت الإضافة وقائمة استكشاف الأخطاء العامة مشتركان في كل التكاملات؛ وهما مكتوبان مرة واحدة في الدليل المشترك للتكاملات. وما يلي خاص بـ Keygen.
الخطوة 1 — اجمع بيانات Keygen
تحتاج في Keygen إلى ثلاثة أشياء. معرّف حسابك (Account ID أو الاسم المختصر للحساب) تجده ضمن Account Settings. ورمز API تحصل عليه من Tokens؛ فاستخدم رمز منتج أو رمز مسؤول يُسمح له بإنشاء التراخيص. أما السياسات (Policies) في Keygen فهي التي تحدّد ما يتيحه الترخيص، كعدد المقاعد والانتهاء والاستحقاقات، فدوّن معرّف كل سياسة تريد الإصدار بموجبها.
الخطوة 2 — املأ لوحة Keygen
افتح «لوحة التحكم ← الإضافات ← Keygen» وأدخل «رقم الحساب» و«رمز API». ثم اضبط «رقم السياسة الافتراضية»، وهي المستخدمة لأي منتج لا يملك ربطًا خاصًا به. ويبدأ مفتاح «إصدار مفاتيح الترخيص عند الشراء» مفعّلًا، فلا تحتاج إلى تفعيل شيء. اضغط «حفظ الإعدادات».
الخطوة 3 — اربط منتجات محددة بسياسات (اختياري)
إذا كانت المنتجات المختلفة تحتاج شروط ترخيص مختلفة — فئة Pro بمقاعد أكثر، أو سياسة تجريبية محدودة المدة — فاملأ «ربط المنتج بالسياسة» بكائن JSON يقرن كل معرّف منتج في VeloCMS بمعرّف سياسة في Keygen. يمكنك قراءة معرّف المنتج من رابط تعديله ضمن «لوحة التحكم ← المنتجات». وما لا يرد في القائمة يعود إلى السياسة الافتراضية.
{
"<VeloCMS product ID>": "<Keygen policy ID for the Pro tier>",
"<another product ID>": "<Keygen policy ID for the trial>"
}يُرفض الربط غير الصالح كـ JSON عند الحفظ، مع رسالة تقول إنه يجب أن يكون كائن JSON صالحًا.
«اختبار الاتصال» يُصدر ترخيصًا حقيقيًا
لا يملك Keygen نقطة فحص خفيفة، لذا ينشئ «اختبار الاتصال» ترخيصًا فعليًا اسمه VeloCMS Connection Test على سياستك الافتراضية. ويستلزم حفظ رقم السياسة الافتراضية أولًا، ويستخدم الإعدادات المحفوظة لا المكتوبة في الحقول. ألغِ ذلك الترخيص (revoke) من لوحة تحكم Keygen بعد ذلك.
ماذا يحدث عند الشراء
- لا يحصل على مفتاح إلا البنود الخاصة بمنتجات رقمية أو مرخَّصة. وتُتجاهَل المنتجات المادية في الطلب نفسه.
- كل بند مؤهَّل يحصل على ترخيصه الخاص، يُنشأ بموجب سياسة المنتج المربوطة أو السياسة الافتراضية، ويُسمّى برقم الطلب وبريد المشتري لتجده بسهولة في Keygen.
- يُرفق المفتاح الصادر ببند الطلب ويظهر في صفحة حالة الطلب لدى المشتري بجانب تنزيله.
- البند الذي يحمل مفتاحًا بالفعل يُتخطّى، فلا تُصدر إعادة معالجة الطلب مفتاحًا ثانيًا.
لا يعطّل إصدار التراخيص تنفيذ الطلب ولا يؤخّره أبدًا. إذا تعذّر الوصول إلى Keygen فلا تفشل إلا خطوة مفتاح الترخيص. والمنتج الذي لا يملك سياسة مربوطة ولا سياسة افتراضية يُتخطّى عمدًا، لأن إصدار مفتاح بسياسة خاطئة أسوأ من عدم إصدار أي مفتاح.
الاسترجاع يعلّق الترخيص
عندما تسترجع طلبًا، يعلّق VeloCMS التراخيص التي صدرت له في Keygen. والترخيص الذي يُبلغ Keygen أنه غير موجود أو معلَّق أصلًا يُعدّ منتهيًا. يعلّق VeloCMS ولا يحذف، فيمكنك أن ترى الترخيص في Keygen. ويظهر أي فشل في «التكاملات ← نشاط المزامنة» مقرونًا بذلك الطلب.
قطع الاتصال
أوقف «إصدار مفاتيح الترخيص عند الشراء» أو امسح رمز API لإيقاف إصدار تراخيص جديدة. تبقى المفاتيح الصادرة سارية في Keygen، لأن إيقاف الموصل لا يلغيها؛ والاسترجاع الذي يُعالَج والموصل فعّال هو وحده الذي يعلّق ترخيصًا.