الانتقال إلى المحتوى الرئيسي
تحمل حزمة إثبات Truthlocks أدلة للفحوصات التشفيرية المدعومة لسجل ما. تتطلب عملية التحقق دون اتصال الحمولة المقابلة، والتنسيق المدعوم، ومفاتيح الجهة المصدرة والسجل الموثوق بها بشكل مستقل. لا تثبت حالة الإلغاء الحالية، أو سلطة الجهة المصدرة، أو الحقيقة الواقعية، أو ما إذا كان إجراء حقيقي قد حدث.
المواصفات الإصدار 1.0

1. نظرة عامة

حزمة إثبات Truthlocks هي وثيقة إثبات محمولة. استخدم التنسيق والمحقق الموثقين لنقطة النهاية التي أنتجتها. دعم CBOR مدرج أدناه كامتداد مستقبلي، وليس ضمانًا للصادرات الحالية. يمكن أن تتضمن الأدلة بيانات إثبات، ومراجع مفاتيح، وإثباتات سجل الشفافية. تحقق من التوقيع وتضمين السجل بشكل منفصل؛ يجب عدم الإبلاغ عن الأدلة الغائبة كفحص ناجح. لا تثق أبدًا بمفتاح عام لمجرد أنه مضمن في الحزمة: قم بتحديد المفتاح المصرح به عبر قناة موثوقة. المخطط أدناه هو وصف مرجعي؛ طابق إصدار التصدير الفعلي وعقد البايت الموقع الخاص به قبل تنفيذ أداة التحقق.

2. هيكل الحزمة

يتم تسلسل حزم الإثبات ككائنات JSON وتتبع هذا المخطط:

3. تعريفات الحقول

3.1 الرأس

3.1.1 تجزئة سلامة الحزمة

3.2 التصديق

3.3 البراهين (سجل الشفافية)

3.4 شهادة المُصدر

4. خوارزمية التحقق

للتحقق من حزمة إثبات Truthlocks، اتبع الخطوات التالية بالترتيب. إذا فشلت أي خطوة، فإن الحزمة غير صالحة.

الخطوة 1: التحقق من سلامة الحزمة

احسب تجزئة SHA-256 لجميع حقول الحزمة باستثناء bundle_hash_b64url و bundle_signature. فك ترميز Base64url لقيمة bundle_hash_b64url وقارنها بالتجزئة المحسوبة. إذا لم تتطابق، فقد تم التلاعب بالحزمة.

الخطوة 2: التحقق من توقيع الإشهاد

باستخدام المفتاح العام من issuer_certificate.public_key_der والخوارزمية المحددة في attestation.signature_format، تحقق من attestation.signature مقابل حمولة التصديق القانونية (جميع حقول التصديق باستثناء signature و status).

الخطوة 3: التحقق من تجزئة المحتوى

إذا كان لديك الملف الأصلي، فاحسب تجزئة SHA-256 الخاصة به وقارنها بـ attestation.content_hash. يؤكد هذا أن الملف لم يتم تعديله منذ التصديق. إذا كانت قيمة document_hash موجودة، يمكنك أيضًا مقارنتها بالتجزئة المحسوبة لديك. document_hash هي تجزئة سداسية عشرية SHA-256 محسوبة مسبقًا قام المُنشئ بتمريرها وقت الإنشاء، مما يوفر فحصًا إضافيًا للسلامة مستقلاً عن ترميز الحمولة.

الخطوة 4: التحقق من تضمين سجل الشفافية

لكل إدخال في proofs، تحقق من إثبات تضمين Merkle. بدءًا من leaf_hash في الموضع leaf_index، أعد حساب الجذر عن طريق التجزئة مع كل شقيق في inclusion_proof. يجب أن تتطابق النتيجة مع root_hash.

الخطوة 5: التحقق من صلاحية المفتاح

تأكد من أن issuer_certificate.valid_from ≤ attestation.issued_at ≤ issuer_certificate.valid_until (إذا كانت موجودة).

5. الخوارزميات المدعومة

6. أدوات التحقق

يمكن التحقق من حزم الإثبات باستخدام أي من هذه الطرق:
  • CLI: truthlock verify -b bundle.json -f original-file --trusted-log-key "$TRUTHLOCKS_LOG_PUBLIC_KEY" --trusted-issuer-key "$TRUTHLOCKS_ISSUER_PUBLIC_KEY". قم بتثبيت كلا المفتاحين العموميين بشكل مستقل عن الحزمة. لا تؤسس الفحوصات غير المتصلة بالإنترنت حالة الإلغاء الحالية.
  • الويب: التحميل على verify.truthlocks.com/proof/[id]
  • SDK: client.verify.verifyBundle(bundleJson, fileBuffer)
  • يدوي: اتبع خوارزمية التحقق أعلاه مع أي مكتبة Ed25519/ECDSA

7. نقاط التوسع

الحقل metadata في كائن الشهادة قابل للتوسيع. يمكن أن تتضمن المخططات المخصصة حقولًا إضافية دون كسر التحقق. تعتمد خوارزمية التحقق الأساسية فقط على content_hash وsignature وإثباتات سجل الشفافية. قد تقدم إصدارات التنسيق المستقبلية:
  • ترميز CBOR للتمثيل الثنائي المضغوط
  • حزم الشهادات المتعددة (التحقق الدفعي)
  • إثباتات الاتساق عبر السجلات
  • إثباتات حالة الإلغاء (مضمنة)

8. مبادئ التصميم

  • ذاتي الاحتواء: لا يتطلب الوصول إلى الشبكة للتحقق
  • تقليل الثقة: قابل للتحقق حتى لو توقفت Truthlocks عن العمل
  • متوافق مع المستقبل: يتم تجاهل الحقول غير المعروفة بواسطة أدوات التحقق الأقدم
  • حتمي: يضمن ترميز JSON الكنسي تجزئة متسقة
  • مفتوح: يستخدم بدائيات تشفير قياسية (لا توجد تنسيقات خاصة)