DAT
الوثائق

DAT Ruby مكتبة

GitHub RubyGems

التثبيت

bash

بدء سريع

يجلب هذا التدفق الكامل الشهادات من CMS، وينشئ DAT يحتوي بيانات JSON، ثم يتحقق منه.

ruby

خطوة بخطوة

1. الاتصال بـ CMS

تستخدم خدمة الإصدار رمزًا للشهادات الكاملة. وتمنع المزامنة الفورية عند بدء التشغيل الإصدار قبل توفر الشهادات.

ruby

2. إصدار DAT

يضع هذا المثال JSON عامًا في plain ومعلومات مستخدم محمية بصيغة JSON في secure.

ruby

3. التحقق من DAT

يتحقق parse من انتهاء الصلاحية والتوقيع ثم يفك تشفير secure. لا تستخدم إلا payload أعيد بعد تحقق ناجح.

ruby

الدوال الأساسية

الدالةالغرض
sync_or_raiseيزامن الشهادات فورًا.
issue(plain, secure)ينشئ string لـ DAT.
parse(dat)يتحقق من DAT ويعيد DatPayload.
last_errorيعيد آخر خطأ في المزامنة.

مناطق البيانات

  • plain: بايتات موقّعة لكنها غير مشفّرة.
  • secure: بايتات مشفّرة.
  • payload: لا تثق به إلا بعد نجاح parse.

خيارات غير JSON

تستخدم الأمثلة صيغة JSON المألوفة. وللمعالجة الأسرع، يمكن للبيانات الثنائية تجنب تسلسل JSON وتحليله مع تقليل حجم البيانات.

خزّن القيم البسيطة كنص، أو ضع البيانات المنظمة بصيغ ثنائية مثل Protobuf أو MessagePack داخل plain وsecure.

ruby

مرّر strings ثنائية واسترجعها عبر plain_bytes وsecure_bytes.

خدمات التحقق فقط

تستخدم الخدمة التي لا تصدر DAT خيار verify-only ورمز verify-only، ولا تستدعي إلا parse.

الإغلاق والأخطاء

عند تفعيل المزامنة التلقائية، استدعِ stop لإنهاء الخيط الخلفي.

استخدم رموز الخطأ وتصنيفات إعادة المحاولة بدلًا من رسائل الخطأ.