> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# مواصفات السجل الموقع

> كيفية إنشاء إشهاد والاحتفاظ به والتحقق منه دون الخلط بين الادعاءات ونتائج التحقق.

المراجعة: 2026-10-13.

## الحمولة الموقعة

يقبل الصك إما `schema` و `claims` منظمين، أو `payload_b64url` يحتوي على البايتات الدقيقة للتوقيع. لا تقدم كلا الشكلين. احتفظ بالحمولة والاستجابة ومفتاح عدم التكرار. الحمولة المشفرة ليست تشفيرًا.

يتضمن السجل معرفه، والمُصدر، ووقت الإصدار، وملخص الحمولة، وخوارزمية التوقيع المعلنة، ومعرف المفتاح، والتوقيع، ومراجع الشفافية. اختر مفتاحًا نشطًا ومتاحًا للتوقيع ويدعم الخوارزمية المطلوبة. تسجيل المفتاح العام وحده لا يجعل مفتاح التوقيع الخاص متاحًا.

## انتهاء الصلاحية

بالنسبة للمدخلات المهيكلة، `expires_at_unix` الاختياري هو طابع زمني يونكس صحيح بالثواني. يصبح جزءًا من حمولة JSON الموقعة. بالنسبة للمدخلات المشفرة، ضع هذا الحقل في جذر حمولة JSON قبل تشفيرها؛ لا ترسل حقل انتهاء صلاحية غير موقع منفصل.

يجب أن يكون التاريخ بعد الإصدار. تعيد عملية التحقق `EXPIRED` بعد تلك اللحظة. لا يمكن تمديد أو إزالة تاريخ انتهاء الصلاحية المخزن في مكانه؛ قم بإصدار بديل. حذف تاريخ انتهاء الصلاحية لا ينشئ عمرًا افتراضيًا. لا يتم تعيين تاريخ انتهاء صلاحية للسجلات التاريخية التي لا تحتوي على تاريخ انتهاء صلاحية مخزن بأثر رجعي. التواريخ داخل المطالبات، مثل `claims.expiry_date`، لا تحدد تلقائيًا تاريخ انتهاء صلاحية الإثبات.

## مخاطر المصدرين والمطالبات

يسجل لقطة الحوكمة تصنيف المصدر عند الإصدار. تصنيف مخاطر المصدر ليس درجة مخاطر آلية لمحتويات المستند. `unknown` يعني عدم تسجيل أي تقييم. تتطلب الموافقات الجديدة للموظفين تقييمًا مدعومًا بالأدلة؛ ولا تعيد كتابة اللقطات القديمة.

## مراجع الشفافية

`log.leaf_index` مستند إلى الصفر: يمكن أن يكون الصفر هو الإدخال الحقيقي الأول. المرجع المفقود أو غير المتاح يختلف عن الصفر. `log.leaf_hash` يحدد الورقة المسجلة. هذه الحقول وحدها لا تثبت التحقق الناجح من التضمين؛ تحقق من الإثبات ونقطة التفتيش مقابل مفتاح موثوق به.

## التحقق والتصدير

قم بتوفير الحمولة الأصلية للتحقق من سلامة الحمولة وتوقيعها. اقرأ الحكم والأسباب معًا: `INCOMPLETE` مع `signature_verified: false` و`payload_not_provided` يعني أن التحقق من توقيع الحمولة لم يتم إجراؤه. تتحقق مقارنة تجزئة الملف من البصمة المقدمة مقابل البصمة المخزنة؛ ولا تثبت الملكية أو صحة محتويات الملف.

تتطلب شهادات Console الخاصة الوصول إلى مساحة العمل. لا يؤدي تنزيل الشهادة إلى نشر سجل. يخضع التحقق العام للسجل والبيئة المتاحة للمحقق العام.

استخدم [Mint Attestation](https://docs.truthlocks.com/ar/api-reference/attestations/mint.md)، [verification](https://docs.truthlocks.com/ar/api-reference/verify.md) و[quickstart](https://docs.truthlocks.com/ar/quickstart.md) لتنسيقات الطلب. احتفظ بطلب غير متغير عند إعادة محاولة سك؛ تغيير الحقول الموقعة تحت نفس مفتاح التكرار هو تعارض.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.