methods في عقدة التحقق من الهوية، فالواجهة وواجهة Management API عرضان لكائن واحد.
الدول وطرق الهوية المسموح بها
افتح سير عملٍ، ثم اختر عقدة التحقق من الهوية، ثم الدول. يعرض كل صف دولة الطرق التي تقبلها. اختر دولة لفتح محررها.
تكون مفاتيح الرجوع إلى التقاط المستند عند… مغلقة دائماً عندما لا يكون لدى الدولة التقاط للمستندات، لأنه لا يوجد مكان للرجوع إليه. فعّل التقاط المستند للدولة لاستخدامها.
إذا أوقفت كل الطرق في دولة ما، يُرفض الحفظ مع الرسالة No method enabled — nobody can verify here، لأن هذا الإعداد لا يستطيع التحقق من أي شخص.
عرض التقاط المستند كبديل احتياطي فقط
افتح دولة واختر كيف يتحقق المستخدمون هنا:
يكتب خيار المحفظة أولاً القيمة
document.fallback_only ومفاتيح الاحتياط المطابقة (wallet.on_failure، ومفاتيح الاستعلام عندما يكون الاستعلام مفعّلاً) في خطوة واحدة. ويضبط خيار المحفظة فقط القيمة document.enabled على false والقيمة wallet.on_failure على retry: يمكن إعادة محاولة تسجيل دخول لم يكتمل، وتبقى الجلسة مفتوحة حتى ينهيها المستخدم أو تنتهي صلاحيتها.
يعمل ذلك بالطريقة نفسها مع أي محفظة في أي دولة.
الخياران غير متاحين حتى تختار محفظة نشطة (أو تفعّل استعلاماً).
لا يمكن للمحفظة التي تحمل علامة قريباً أن تكون الخيار الأول: طالما أن كل المحافظ في دولة ما تحمل علامة قريبًا، يبقى التقاط المستند أولاً.
تعرض قائمة الدول الخيار المحفظة ثم المستند تحت كل دولة تستخدمه، بينما تعرض المعاينة المحفظة وحدها.
الإعداد نفسه موجود ضمن إعدادات إضافية في شاشتي المحافظ والاستعلام بدون مستند، كمفتاح بعنوان عرض التقاط المستند كبديل احتياطي فقط.
كلا عنصري التحكم يعدّلان الإعداد نفسه.
التوفر يحدده الخادم
يقرأ التبويب كتالوج القدرات نفسه الذي تتحقق منه الواجهة البرمجية، لذا لا يعرض عليك إلا ما تدعمه المنصة فعلاً:- الطريقة التي لا يعرضها الكتالوج في تلك الدولة لا تظهر كخيار.
- المصدر أو المحفظة التي يحمل الكتالوج علامة قريباً تُدرج حتى تطّلع على خارطة الطريق، لكن لا يمكن تفعيلها.
- يُفعَّل تسجيل الدخول عبر المحافظ لكل بيئة على حدة. وطالما هو موقوف، تعرض كل محفظة علامة قريباً بغض النظر عما يقوله الكتالوج.
تفعيل Smart-ID أو Mobile-ID
تتوفر Smart-ID وMobile-ID في الدول المدعومة لكل منهما. راجع كتالوج المحافظ لمعرفة تغطية الدول. تحقق من التوفر الظاهر في بيئتك الحالية قبل تعديل سير العمل.- افتح سير العمل، واختر سير العمل وعقدة التحقق من الهوية الخاصة به، ثم افتح الدول.
- افتح محرر الدولة وابحث عن المحافظ المقبولة.
- اختر Smart-ID أو Mobile-ID فقط إذا كانت متاحة، واترك التقاط المستند مفعّلاً إذا أردت بديلاً احتياطياً.
- اختر ما ينبغي أن يحدث عند فشل تسجيل الدخول عبر المحفظة، ثم احفظ سير العمل وانشره.
- ابدأ جلسة تحقق جديدة باستخدام سير العمل هذا، وافحص بطاقة بيانات الاعتماد في الجلسة المكتملة.
الطلب والاستجابة المتوقعان
يفتح عرض التفاصيل لأي مصدر استعلام أو محفظة الطلب والاستجابة المتوقعين: ما الذي يُطلب من المستخدم النهائي بلغة بسيطة، وما الذي يعيده المصدر. يُذكر كل مصدر استعلام باسمه الدقيق، فهو سجل حكومي في معظم الدول، وملف لدى مكتب ائتماني أو سجل سكني في بعضها، لأن ذلك هو ما يحدد مصدر البيانات ونظام الموافقة. لا يرى المستخدم النهائي حقول الاستجابة ولا اسم المصدر ولا السعر.مفاتيح التبديل الجماعية
تفعّل الإعدادات العامة طريقة ما في كل دولة تدعمها، فلا تحتاج إلى المرور على الـ 36 دولة يدوياً. تظل إعدادات محرر الدولة هي الغالبة، أي لها الأولوية: فعّل الطريقة عالمياً، ثم أوقفها للدولة التي لا تريدها فيها.الأسعار في علامة التبويب
يعرض التقاط المستند سعره: $0.15 لكل فحص. يعرض الاستعلام بدون مستند سعره لكل دولة، وأي سعر لم يُنشر بعد في كتالوج الأسعار يُوسم في علامة التبويب بأنه عنصر نائب ولا يُقدَّم كعرض سعر. يعرض صف المحفظة المحفظةَ وتغطيتها وتوفرها. تشرح علامة التبويب أيضاً الأثر المالي لكل مفتاح تبديل للبديل الاحتياطي في الاستعلام، حتى تظهر تكلفة الإعداد قبل حفظه:- السجل الذي أجاب يُحتسب على الاستعلام، وتُحتسب المطابقة وعدم المطابقة معاً، ثم يُحتسب التقاط المستند فوق ذلك عندما يرجع المستخدم إلى البديل.
- الاستعلام الذي لم يُرجع أي استجابة لا يُحتسب، لذا لا يكلفك الانقطاع إلا سعر المستند.
- عند إيقاف البديل الاحتياطي يُرفض أولئك المستخدمون، ولا يُحتسب أي مبلغ إضافي.
قراءة الجلسة
تتضمن كتلة التحقق من الهوية في تفاصيل الجلسة شريحة للطريقة التي أنتجت نتيجة التحقق منها، وشريحة ثانية لـمستوى الضمان الخاص بها: المستند / مستندي أو استعلام بدون مستند / مطابقة البيانات أو اسم المحفظة مع تشفيري.تُقرأ الجلسة التي انتقلت بشكل احتياطي من طريقة بدون مستند إلى التقاط المستند بوصفها جلسة المستند / مستندي. يسمّي
fallback_from في التحقق من الهوية تلك الطريقة التي جُرّبت أولاً وسبب انتهائها (مثل wallet وcancelled)، مع action: "fallback_to_document".- المستند: دون تغيير، أي صورتي المستند الأمامية والخلفية وصورة السيلفي، ودرجات الجودة، والحقول المستخرجة، والتحذيرات.
- استعلام بدون مستند: المقارنة مع السجل تسرد كل حقل تمت مقارنته مع ما قدّمه المستخدم، وما يحتفظ به المصدر، ونتيجة تطابق أو جزئي أو لا تطابق، إضافة إلى اسم المصدر ووقت الفحص وعدد المحاولات. المصدر الذي لم يُجب يظهر كصف مستقل يحمل خطأً بدلاً من حكم على الحقل. وحين يعيد المصدر صورة شخصية، تُعرض هذه الصورة وصورة السيلفي الخاصة بالمستخدم جنباً إلى جنب مع درجة مطابقة الوجه.
- المحفظة: بطاقة بيانات الاعتماد، وتشمل المحفظة، والجهة المُصدرة لها، ونوع بيانات الاعتماد، ومستوى الضمان الذي أكدته، ووقت التحقق، وما إذا كان قد تم التحقق من صحة التوقيع، والسمات التي شاركتها المحفظة.
ذات صلة
- طرق التحقق من الهوية: الطرق الثلاث والبديل الاحتياطي والفوترة
- الاستعلام بدون مستند: الحقول حسب الدولة والموافقة
- محافظ الهوية الرقمية: السمات ومستوى الضمان لكل محفظة
- سير العمل: بناء سير العمل ونشره
- إعدادات ميزات سير العمل: الإعدادات نفسها عبر API