الانتقال إلى المحتوى الرئيسي
يتيح Smart-ID وMobile-ID للمستخدمين التحقق من هويتهم من خلال الموافقة على طلب عبر هواتفهم. استخدم Smart-ID API أو Mobile-ID API لبدء التحقق من تطبيقك الخاص دون استخدام سير عمل. تعمل كلتا الطريقتين أيضاً داخل خطوة سير عمل التحقق من الهوية في Didit، مما يعيد نتيجة تحقق من المحفظة مع مستوى ضمان cryptographic. بالنسبة لتكامل سير العمل المستضاف الموضح أدناه، استخدم آلية إنشاء الجلسة نفسها وتكامل webhook نفسه المستخدَمَين في سير عمل Didit الأخرى لديك.
Smart-ID وMobile-ID متاحان. يدعم Smart-ID كلاً من إستونيا ولاتفيا وليتوانيا وبلجيكا. يدعم Mobile-ID كلاً من إستونيا وليتوانيا. حدد المحافظ التي يقبلها سير العمل لديك لكل دولة في لوحة التحكم. راجع تغطية المحافظ والأسعار للاطلاع على القائمة الكاملة.

​
الدول والمتطلبات الأساسية

يغطي هذا التكامل Smart-ID في إستونيا (EST) ولاتفيا (LVA) وليتوانيا (LTU) وبلجيكا (BEL). يغطي Mobile-ID إستونيا (EST) وليتوانيا (LTU)؛ ولا يتوفر Mobile-ID في لاتفيا. تصف رموز الدول هذه المسارات المتكاملة، وليست تعهداً بتفعيل كل مسار في بيئتك. بالنسبة لـ Smart-ID، يحتاج المستخدم إلى هوية Smart-ID نشطة ومؤهلة، ورمز التعريف الشخصي الخاص بها، والوصول إلى التطبيق. بالنسبة لـ Mobile-ID، يحتاج المستخدم إلى هوية Mobile-ID نشطة، ورمز التعريف الشخصي الخاص بها، ورقم الهاتف المرتبط بها. أدخل رقم هاتف Mobile-ID بالتنسيق الدولي: +372 لإستونيا أو +370 لليتوانيا. يجب أن تتطابق الدولة المحددة مع الهوية المستخدمة. لا تُعيد أي من الطريقتين صورة شخصية. إذا كان سير العمل لديك يتطلب صورة سيلفي، فاحتفظ بخطوتي كشف الحيوية ومطابقة الوجه المناسبتين مُعدتين بشكل منفصل.

​
ما يراه المستخدم

  1. يختار المستخدم دولته ويحدد Smart-ID أو Mobile-ID من بين المحافظ التي يقبلها سير العمل لديك.
  2. تطلب جلسة التحقق رمز التعريف الشخصي؛ كما يطلب Mobile-ID رقم الهاتف المرتبط أيضاً.
  3. تعرض الصفحة رمز مقارنة أثناء وصول طلب المصادقة إلى الهاتف.
  4. يتحقق المستخدم من تطابق الرمز الموجود على الهاتف مع الرمز المعروض على صفحة التحقق، ثم يوافق باستخدام رمز PIN الخاص به على الهاتف.
  5. تتحقق Didit من صحة نتيجة الهوية الموقعة وتتابع سير عمل التحقق.
يستخدم نموذج الهوية وشاشة رمز المقارنة نفس التصميم المستخدم في طرق التحقق الأخرى. عند تفعيل تخصيص العلامة البيضاء، فإنهما يرثان ألوان الجلسة والخطوط وتنسيق الأزرار وشعار العميل، ويظلان على نطاق الجلسة. يؤدي تحديث الصفحة إلى استعادة رمز المقارنة النشط دون بدء طلب موافقة آخر. لا يُدخل المستخدم أبداً رمز PIN الخاص بمحفظته على صفحة التحقق. إذا كانت الرموز مختلفة أو لم يبدأ المستخدم الطلب، فعليه إلغاؤه. يعمل تدفق رمز المقارنة مع متصفح سطح المكتب أو الهاتف ولا يتطلب رمز QR. تنتظر الصفحة النتيجة تلقائياً وتوفر خياراً للإلغاء. يجب أن تجتاز الموافقة على الهاتف عمليات التحقق من الهوية والتوقيع قبل أن تعتبر Didit التحقق من المحفظة ناجحاً.

​
إعداد سير العمل

في لوحة التحكم، افتح عقدة التحقق من الهوية في سير العمل لديك، واختر الدول، وافتح الدولة التي تريد إعدادها. ضمن المحافظ المقبولة، حدد المحافظ المتاحة واختر سلوك الفشل. احفظ سير العمل وانشره قبل إنشاء جلسة جديدة. راجع طرق التحقق من الهوية في لوحة التحكم لمعرفة المسار الكامل في لوحة التحكم.
ما يلي هو جزء من إعداد methods، وليس طلباً كاملاً لسير العمل. استخدمه فقط عندما يكون كلا smart_id وmobile_id مُعيَّنين على available لإستونيا في بيئتك. تؤدي المحفظة غير المتاحة إلى رفض حفظ سير العمل بأكمله.
مصفوفة providers هي قائمة قبول: يختار المستخدمون بين محافظها، ولا يحدد ترتيب المصفوفة محفظة مفضلة. بالنسبة لليتوانيا، استخدم LTU مع نفس معرّفات المحافظ عندما يكون كلاهما متاحاً. بالنسبة للاتفيا أو بلجيكا، استخدم LVA أو BEL مع smart_id فقط، مع مراعاة فحص التوفر نفسه. تحتفظ الدول غير المدرجة بسلوك التقاط المستندات الافتراضي الحالي. يتوفر عقد الإعداد الكامل في إعدادات ميزات سير العمل.

​
قراءة النتيجة التي تم التحقق منها

اقرأ بيانات الجلسة المكتملة من خلال API قرار الجلسة أو تكامل webhook لديك. يسجل فحص المحفظة الناجح verification_method: "wallet" وassurance: "cryptographic" وwallet_provider: "smart_id" أو "mobile_id". يحدد كائن wallet_verification المحفظة، ودولة الإصدار، ووقت التحقق، ومستوى الضمان، وحكم التوقيع. تكشف نتيجة التحقق من الهوية عن حقلي full_name وdate_of_birth المعياريين. بالنسبة لهاتين المحفظتين، يحمل wallet_verification.attributes كلاً من given_name وfamily_name وbirthdate وpersonal_code من الهوية التي تم التحقق من صحتها. تحدد دولة الإصدار مسار الهوية؛ ولا تُثبت جنسية الشخص. تُعيد Didit حكم التوقيع، وليس الإقرار الموقع الأساسي. لا يتم إرجاع أي صورة شخصية أو رمز PIN للمحفظة. في لوحة التحكم، تعرض بطاقة بيانات الاعتماد الخاصة بالجلسة المحفظة والأدلة التي تم التحقق منها. يُكمل فحص المحفظة الناجح خطوة التحقق من الهوية؛ ومع ذلك تظل الفحوصات اللاحقة في سير العمل تحدد القرار النهائي للجلسة. راجع نموذج بيانات التحقق من الهوية لمعرفة أنواع الحقول والتمييز بين نتيجة الفحص وقرار الجلسة الإجمالي.

​
التعامل مع الإلغاء والفشل

إذا ألغى المستخدم أو انتهت مهلة الجلسة أو تعذر عليه إكمال المصادقة، تطبق Didit إعداد wallet.on_failure الخاص بتلك الدولة. يبدأ fallback_to_document التقاط المستند عندما يكون مفعلاً لتلك الدولة. يرفض خيار decline خطوة التحقق من الهوية. إذا كان التقاط المستندات معطلاً، فلن يتوفر أي بديل احتياطي للمستندات. فقط فحص المحفظة المكتمل والمتحقق منه يترتب عليه رسوم التحقق من المحفظة. أما محاولات المحفظة الملغاة والمنتهية الصلاحية والفاشلة فلا يترتب عليها ذلك. البديل الاحتياطي المكتمل للمستند فحصٌ منفصل بموجب أسعار التحقق من المستندات. راجع جدول أسعار المحافظ لمعرفة الأسعار المنشورة؛ ويجب عدم التعامل مع أي طريقة لا يتوفر لها سعر منشور على أنها مجانية.

​
الاختبار قبل الإنتاج

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

​
محافظ الهوية الرقمية الأخرى

يتضمن دليل محافظ الهوية الرقمية من Didit مدى التوفر في بيئة الإنتاج والمحافظ القادمة، بما في ذلك Finnish Trust Network المتاحة وتكاملات BankID و EUDI Wallet القادمة. إن إدراج المحفظة أو السعر المنشور أو نموذج التسجيل المكتمل لا يعني بحد ذاته تفعيل المصادقة في بيئة الإنتاج. استخدم الدليل ولوحة تحكم بيئتك لتحديد ما يمكنك تفعيله اليوم. راجع أيضاً Finnish Trust Network لفنلندا.
آخر تعديل في ٧ نوفمبر ٢٠٢٦