تنزيل Markdownالوثيقة الأصلية على GitHub
تكامل حساب Licentivo والشراء
يصف هذا الدليل موفّر Licentivo الحالي. يمكن للتجار الذين يستخدمون نظام ترخيص آخر اختيار موفّر HTTP المخصص؛ ولا يستدعي ذلك الوضع Licentivo أو يتطلب مفتاح API الخاص به.
إعداد المسؤول
- أنشئ المنتجات والسياسات في Licentivo.
- هيئ مفتاح إدارة للقراءة/الكتابة في إعدادات النظام → Licentivo في Launch. مصدر Licentivo ثابت عند
https://www.licentivo.com. - اختر السياسة لكل إصدار خطة بيع في Launch. يقرأ Launch المنتج وإصدار السياسة وإعدادات عرض التشغيل.
- يسجل Launch اتصالات ثقة حساب منفصلة لـ sandbox/live تحت اتصال إدارة Licentivo واحد، بما في ذلك مفتاحه العام لتوقيع الهوية ومصدر التاجر.
يبقى مفتاح الإدارة مشفرًا على خادم التاجر. لا تحتوي ملفات تثبيت العميل إلا على معلومات توجيه عامة ومفاتيح منتج عامة مثبتة.
تسلسل API على الخادم
جميع المسارات التالية على Licentivo ويستدعيها Launch ببيانات اعتماد الإدارة:
| الواجهة | الغرض |
|---|---|
GET /api/v1/products |
اكتشاف المنتجات |
GET /api/v1/policies, GET /api/v1/policies/{id} |
اكتشاف السياسات وفحص الإصدارات |
GET /api/v1/launch/connections |
العثور على اتصالات ثقة المصدر/البيئة |
POST /api/v1/launch/connections, PUT /api/v1/launch/connections/{id} |
تسجيل/تحديث مفاتيح الهوية العامة والتوجيه |
PUT /api/v1/launch/connections/{id}/plans/{plan} |
تسجيل إصدار خطة البيع غير القابل للتغيير وتعيين سياسة Licentivo |
POST /api/v1/launch/connections/{id}/events |
إرسال لقطة شراء مطلقة ذات إصدار |
GET /api/v1/launch/connections/{id}/events/{event} |
استعادة/استعلام النتيجة الأصلية |
POST /api/v1/launch/connections/{id}/events/{event}/retry |
إعادة محاولة الحدث نفسه بعد المراجعة |
POST /api/v1/launch/connections/{id}/session-revocations |
الإخطار بإلغاء الحساب/الجلسة |
GET /api/v1/launch/connections/{id}/session-revocations/{event} |
التحقق من إيصال الإلغاء |
يسجل Launch المدفوعات المتحقق منها والتغطية المدفوعة غير القابلة للتغيير والمهمة الصادرة في معاملة محلية واحدة. يرسل العامل تواريخ شراء مطلقة كاملة ومعرّف حدث ثابتًا. يؤكد إيصال applied وحده المزامنة؛ ولا يؤكدها استلام HTTP وحده.
تزيل الاستردادات وعمليات العكس المؤكدة تغطية الطلب المقابل. قد تحافظ اللقطة الكاملة التالية على شراء أساسي نشط أو تقصر مدته أو تستعيد خطة أقل أو تنهي التغطية كلها. لا تضيف إعادة المحاولة عددًا آخر من الأيام مطلقًا. تستخدم روابط التراخيص القديمة الصادرة أحداث ترحيل صريحة بدلًا من إعادة أوامر الإدارة القديمة تلقائيًا.
تدفق تطبيق العميل
- يسجل التطبيق الدخول إلى Launch باستخدام جلسة حساب سطح المكتب.
- تعيد واجهة
POST /api/v1/software/products/{id}/identityفي Launch تأكيد هوية لا يتجاوز 120 ثانية ومرتبطًا بالجلسة الحقيقية والمنتج والبيئة والمُصدر والجمهور. - تمرره حزمة Launch في الذاكرة إلى SDK الرسمي، الذي يتبادله مع Licentivo عبر
POST /api/v1/launch/exchange. - يصدر Licentivo بيانات اعتماد الجهاز والإذن الموقع. يفحص SDK كل إجراء محمي وسياسة الجهاز وحالة التشغيل وقاعدة عدم الاتصال.
لا يعد دخول Launch أو الطلب المدفوع أو الشراء المتزامن إذن تشغيل. تعيد واجهة /credential القديمة HTTP 410. تسليم الموفّر المخصص واجهة منفصلة ضمن نطاق المالك ولا يعيد تلك الواجهة.
تظل قائمة الأجهزة وحصص التحرير وأجيال الربط واستعادة الخروج من مسؤوليات Licentivo. تستخدم إلغاءات الجلسة/الحساب إشعارات دائمة مع إيصالات لكل بيئة؛ ويظل الإلغاء دون اتصال مقيدًا بمنح SDK الصادرة بالفعل.
راجع تكامل التطبيق وحدود الشراء/الحساب والتكامل اليدوي والقبول. يوجد التنفيذ في internal/adapters/licentivo/launch_bridge.go وinternal/app/launch_trust.go وinternal/app/purchase_sync.go وinternal/app/identity.go.