تُستخدم الوجوه المخزّنة مرجعاً لـالمصادقة البيومترية: أنشئ جلسة مصادقة بيومترية باستخدام
vendor_data الخاص بالمستخدم، واترك portrait_image دون تضمينها، وسيعيد Didit استخدام الوجه المخزّن تلقائياً (أولاً وجه كشف الحيوية المقبول، ثم صورة الشريحة في جواز السفر الإلكتروني، ثم صورة وثيقة الهوية، وأخيراً وجه ملف التعريف المسجّل يدوياً).كيف ترتبط الوجوه بالمستخدم
1
يُلتقط أثناء كشف الحيوية
عندما يجتاز المستخدم جلسة مع تفعيل كشف الحيوية، يلتقط Didit صورة سيلفي، ويُجري كشف الحيوية السلبي، ويستخرج أكبر وجه، ويولّد تضميناً متجهياً للبحث.
2
يُخزَّن في ملف المستخدم
يُربط الوجه بالجلسة وبالكيان الأب للمستخدم. يظهر عنوان URL للصورة في ملف المستخدم بوصفه
portrait_image.3
يُفهرَس للبحث
يُضاف التضمين إلى فهرس البحث. ويمكن للجلسات اللاحقة تنفيذ عمليات بحث 1:N على هذا الفهرس.
البحث بالوجه (1:N)
يتيح البحث بالوجه العثور على مستخدم عبر رفع صورة ومطابقتها مع كل وجه مسجّل في تطبيقك. حالات الاستخدام:- كشف التكرار عند التسجيل: منع الشخص نفسه من إنشاء حسابين.
- البحث العكسي: تحديد المستخدم الذي يظهر في إطار كاميرا مراقبة أو في صورة ضمن تحقيق احتيال.
- التعرف على العميل المتكرر: تخطي KYC للعميل العائد.
POST /v3/face-search/— البحث المستقل بالوجه
كشف التكرار
يمكن مقارنة كل وجه جديد بالوجوه المسجّلة الموجودة لرصد التكرارات. يعيّن Didit لكل وجه القيمةapproved_duplicate_status:
يمكن ضبط سير العمل ليقوم بما يلي:
- رفض الجلسات المُعلَّمة بالتكرار تلقائياً.
- الإحالة للمراجعة: توجيه الجلسة إلى محلل بشري.
- التحذير فقط: السماح بالجلسة مع إضافة وسم مخاطر.
قائمة حظر الوجوه
رفض الجلسة لا يضيف الوجه إلى أي قائمة حظر. لرفض الجلسات المستقبلية بالوجه نفسه، أضفه إلى قائمة الحظر بنفسك: من صفحة قائمة الحظر أو عبر Lists API. فأي جلسة جديدة تطابق فيها صورة السيلفي الخاصة بكشف الحيوية ذلك الإدخال تُرفض تلقائياً.رفع وجه مستورد إلى ملف مستخدم
إذا كنت تنتقل من مزوّد KYC آخر، يمكنك إنشاء المستخدم أولاً ثم إرفاق صورة وجه موثوقة بملفه. يبقى المستخدم محدداً بواسطةvendor_data الخاص بك، لكن endpoint رفع الوجه يستخدم معرّف المستخدم الداخلي في Didit (didit_internal_id) لضمان تحديد الهدف بوضوح.
1
أنشئ المستخدم أو استرجعه
استدعِ
POST /v3/users/create/ مع vendor_data الثابت لديك، أو استدعِ GET /v3/users/{vendor_data}/ إذا كان المستخدم موجوداً مسبقاً.2
اقرأ didit_internal_id
تتضمن استجابة المستخدم القيمة
didit_internal_id. واصل استخدام vendor_data في نظامك، واستخدم didit_internal_id فقط مع endpoints إرفاق الملف الشخصي.3
ارفع الوجه
استدعِ
POST /v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/ مع صورة وجه مرمّزة بصيغة base64.كيف يحدث الحظر
رفع وجه إلى قائمة الحظر
لحظر مستخدم بالوجه برمجياً، ارفع صورة الوجه إلى قائمة حظر من نوع الوجه عبر endpoint رفع الوجه إلى القائمة المخصص لذلك. يستخرج Didit التضمين البيومتري ويدرجه في فهرس المطابقة، فأي جلسة مستقبلية تطابق فيها صورة السيلفي ذلك الوجه تُرفض تلقائياً.رفع ملف الوجه الشخصي ورفع الوجه إلى قائمة الحظر عمليتان مختلفتان. استخدم رفع الملف الشخصي لإرفاق وجه مستورد موثوق بمستخدم، لأغراض الأدلة وكشف التكرار والبحث بالوجه. واستخدم Lists API لحظر وجه، بحيث تُرفض الجلسات المطابقة المستقبلية.
إزالة وجه من قائمة الحظر
أزل الإدخال من الكونسول عبر Blocklist ← Faces ← إجراءات الصف ← Remove، أو استخدم endpoint حذف الإدخال.القوالب البيومترية المحفوظة بعد حذف الجلسة
يؤدي حذف الجلسة إلى حذف صورة الوجه، وبشكل افتراضي تضمين الوجه، فيخرج الشخص من اكتشاف التكرار ومن البحث بالوجه. إذا كنت تحذف الجلسات بعد وقت قصير من الموافقة عليها، لكنك ما زلت بحاجة إلى رصد عمليات التسجيل المتكررة، فقم بتفعيل الاحتفاظ بالقوالب البيومترية في التطبيق، أو أرسلretain_face_embeddings: true مع طلب الحذف.
تحذف Didit بعد ذلك الجلسة وجميع بياناتها كالمعتاد، وتحتفظ بقالب بيومتري واحد للوجه مُدار بشكل منفصل، لا يحتوي على الصورة، ومرتبط بالمستخدم:
- يحتوي على القالب الرقمي للوجه والبيانات الوصفية للاحتفاظ فقط. لا يحتوي أبداً على صورة الوجه، أو فيديو الحيوية، أو بيانات المستند، أو حقول الهوية المستخرجة، أو القرار، أو معرّف الجلسة المحذوفة.
- يشارك في اكتشاف التكرار، والبحث بالوجه، والمصادقة البيومترية، وقوائم الوجوه لديك تماماً كوجه في جلسة نشطة. تُعرض النتائج بالقيمة
source: "retained_template"، وvendor_user_idوvendor_dataالخاصين بالمستخدم، وكذلكbiometric_template_id. - وهو بيانات بيومترية ذات
expires_atمحدد. يُحذف عند حذف المستخدم، أو عند حذف أي جلسة تابعة له باستخدامdeletion_instruction: "privacy_erasure"، أو عند انتهاء صلاحيته، أو عند حذفه يدوياً من Lists → القوالب البيومترية أو عبر Biometric Templates API. - الجلسة التي تُنشأ دون
vendor_dataلا يكون لها مستخدم يُربط به القالب؛ عند حذفها يُبلَّغ عن الحالةineligible_no_vendor_userويُحذف التضمين مع الجلسة. - القوالب المحفوظة لا تُضاف إلى قائمة الحظر أبداً. أما إدخال في قائمة حظر الوجه الذي أُنشئ من الجلسة المحذوفة فيحتفظ ببيانات بيومترية مستقلة ودورة حياة مستقلة خاصة به.
ملخص دورة حياة الوجه
رفع وجه من وحدة التحكم
يمكن لمشغلي الامتثال رفع الوجوه يدوياً:- انتقل إلى Users → [user] → Actions → Upload face.
- اختر صورة؛ تستخرج Didit أكبر وجه فيها وتخزن سجل وجه جديداً مرتبطاً بالمستخدم.
- يُسجَّل الوجه لأغراض أدلة الملف الشخصي، واكتشاف التكرار، والبحث بالوجه. استخدم منطقة قائمة الحظر عندما يكون الهدف رفض الجلسات المطابقة مستقبلاً.
- تملك صورة شخصية معروفة لعميل جرى التحقق منه عبر قناة غير متصلة بالإنترنت.
- تريد تعبئة قائمة الحظر مسبقاً بالمحتالين المعروفين من قاعدة بيانات الاحتيال لديك.
الخصوصية والاحتفاظ بالبيانات
- تضمينات الوجه متجهات عددية وليست صوراً. تُخزَّن الصور نفسها في مساحة تخزين كائنات مشفرة، ويكون الوصول إليها عبر رابط موقّع. تضمين الوجه بيانات بيومترية.
- يتبع الاحتفاظ سياسة الاحتفاظ بالبيانات في تطبيقك. تتبع القوالب البيومترية المحفوظة مدة الاحتفاظ بالقوالب البيومترية الأشد صرامة والمحددة بزمن.
- يؤدي حذف الجلسة إلى حذف الصورة، وبشكل افتراضي التضمين. إذا اشترك تطبيقك في الاحتفاظ بالقوالب البيومترية، فإن حذف الجلسة يُبقي قالباً بلا صورة حتى ينتهي صلاحيته أو يُحذف يدوياً.
- بالنسبة إلى طلب الحق في النسيان وفق GDPR أو CCPA، احذف جلسات الشخص باستخدام
deletion_instruction: "privacy_erasure"أو احذف المستخدم نفسه: كلا الإجراءين يحذفان كل قالب محفوظ أيضاً. أما إدخالات قائمة حظر الوجوه التي تديرها فتبقى حتى تزيلها.
الخطوات التالية
البحث بالوجه
كيف يعمل البحث بالوجه 1:N.
الحيوية
كشف الحيوية الذي يلتقط الوجه.
واجهة برمجة تطبيقات قائمة الحظر
رفع وجه إلى قائمة حظر.
القوالب البيومترية
القوالب المحفوظة بعد حذف الجلسة.
قائمة حظر المستخدمين
كيف يعمل حظر المستخدم.