الانتقال إلى المحتوى الرئيسي
يشرح هذا الدليل اللبنات الأساسية لمنصة Truthlocks. يعد فهم هذه المفاهيم ضروريًا للتكامل الفعال.

المستأجرون

المستأجر هو الوحدة التنظيمية العليا في Truthlocks. يمثل كل مستأجر عميلاً أو مؤسسة مميزة مع عزل كامل للبيانات.

ضوابط تعدد المستأجرين

  • عزل البيانات: يتم عزل بيانات كل مستأجر بالكامل على مستوى قاعدة البيانات
  • حدود الموارد: يتم فرض حدود المعدل والحصص لكل مستأجر
  • تحديد نطاق مفتاح API: مفاتيح API مرتبطة بمستأجر واحد ولا يمكنها الوصول إلى بيانات المستأجرين الآخرين
  • فصل التدقيق: يتم تقسيم سجلات التدقيق حسب المستأجر

المصدرون

المصدر هو كيان يمكنه إنشاء وتوقيع التصديقات. يمثل المصدرون منظمات أو مؤسسات أو خدمات تقدم مطالبات حول الموضوعات.

الهوية

لكل مُصدر نطاق مُتحقق منه (مثل acme.edu) يؤسس هويته الهوية الحقيقية.

المفاتيح التشفيرية

تسجل الجهات المصدرة مفاتيح Ed25519 العامة المستخدمة للتحقق من توقيعات الشهادات.

حالة الثقة

يتم تفعيل الجهات المصدرة الجديدة فور إنشائها. تتطلب مستويات الثقة الأعلى مراجعة الطلب: نشط ← معلق.

مستوى الثقة

أساسي، أو موثق، أو مميز بناءً على عمق التحقق من الهوية.

دورة حياة المصدر

يتم تفعيل المصدرين الجدد فورًا بمستوى الثقة الأساسي. لا يلزم موافقة يدوية لبدء سك الإثباتات. للترقية إلى مستوى ثقة أعلى (مؤسسة معتمدة، كيان حكومي، أو مؤسسة معتمدة)، قدم طلب مصدر للمراجعة.

الشهادات

التصديق هو مطالبة موقعة تشفيريًا يقدمها مصدر حول موضوع. التصديقات هي البدائية الأساسية لنظام Truthlocks.

هيكل التصديق

خصائص التصديق

حماية المستهلك

إن حماية المستهلك هي شهادة تم إنشاؤها من خلال تدفق سك العملات للمستهلك المبسّط، والمصمم للمبدعين الأفراد. تقوم بتجزئة ملفك من جانب العميل (SHA-256) وتقديم التجزئة مع بيانات وصفية مثل العنوان والفئة ونوع المحتوى. يقوم Truthlocks بتوفير هوية التوقيع الخاصة بك تلقائيًا عند الاستخدام الأول. يتضمن رد سك المستهلك: ينشئ كل حماية صفحة إثبات عامة. يمكن لأي شخص جلب بيانات تعريف صفحة الإثبات عبر GET /v1/public/proof/{attestation_id} — لا يلزم المصادقة. تم تصميم نقطة النهاية هذه لعرض صفحات الإثبات وإنشاء معاينات روابط Open Graph لعنوان URL المشتركة. راجع نقطة نهاية بيانات تعريف الإثبات للحصول على التفاصيل.

إشارات المخاطر

إشارة المخاطر هي ملاحظة مسجلة من مصدر للكشف عن الاحتيال — بصمات الجهاز، سمعة IP، التحقق من البريد الإلكتروني، تحليل المستندات، أو محرك القواعد الخاص بك. يمكنك استيعاب الإشارات مباشرة عبر واجهة برمجة التطبيقات، أو إرسال أحداث الهوية الخام والسماح للمنصة بتطبيعها إلى إشارات تلقائيًا. تتضمن كل إشارة:

تسوية الأحداث

بدلاً من إنشاء إشارات المخاطر يدويًا، يمكنك إرسال أحداث الهوية الأولية — عمليات تسجيل الدخول الفاشلة، التوقيعات غير الصالحة، المشتبه بهم في التزييف العميق — إلى POST /v1/risk/events. تقوم المنصة بربط كل حدث بنوع إشارة قانوني ودرجة مخاطر أساسية تلقائيًا. راجع مرجع واجهة برمجة تطبيقات تطبيع أحداث الهوية. إشارات المخاطر معزولة تمامًا للمستأجر باستخدام أمان على مستوى الصف وتشكل أساس جدار حماية الهوية لمكافحة الاحتيال. راجع دليل إشارات المخاطر للحصول على تفاصيل التكامل.

وكلاء الآلة

إن وكيل الآلة هو وكيل ذكاء اصطناعي، أو روبوت، أو خدمة آلية مسجلة ببروتوكول هوية وكيل الآلة (MAIP). يحصل كل وكيل على معرف فريد (maip-agent:<ulid>) وزوج مفاتيح Ed25519 لتوقيع الإيصالات. يعمل الوكلاء ضمن جلسات — سياقات تنفيذ قصيرة الأجل ومحددة النطاق مع انتهاء صلاحية تلقائي. كل إجراء يتخذه الوكيل يولد إيصالًا موقعًا تشفيريًا يتسلسل إلى الإيصال السابق لمسارات تدقيق مقاومة للتلاعب. تغطي تسعة أنواع من الإيصالات دورة حياة الوكيل الكاملة: التكوين، التفويض، الإجراء، الإلغاء، تصديق البيانات، تصديق النموذج، الامتثال، مطالبة الحقيقة، والتحقق. راجع دليل هوية الجهاز للإعداد و دليل ترخيص الوكيل لنموذج النطاق والجلسة.

حزم الإثبات

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

نموذج التحقق

تتحقق Truthlocks من طبقات متعددة لتحديد ما إذا كان يجب الوثوق بشهادة:
1

التحقق التشفيري

تحقق من تطابق توقيع Ed25519 مع الحمولة باستخدام المفتاح العام للمصدر. المفتاح.
2

التحقق من الحالة

تحقق مما إذا كانت الشهادة قد تم إلغاؤها أو استبدالها من قبل المصدر. ترتبط الشهادات المستبدلة ببديلها عبر superseded_by_attestation_id.
3

حالة ثقة المُصدر

تأكد من أن المصدر في حالة نشطة وغير معلق.
4

صلاحية المفتاح

تحقق من أن مفتاح التوقيع كان نشطًا وقت إنشاء الإثبات.

الخطوات التالية

البيئات

تعرف على بيئات التطوير مقابل الإنتاج والتكوين.

المصادقة

تعمق في مفاتيح API، ورموز JWT، وتكامل OAuth.