البنية
تشارك أربعة أجزاء في هذه العملية:
لا يجب أن يحتوي تطبيقك أبداً على مفتاح API الخاص بـ Didit ولا على أي سر؛ فالمفتاح القابل للنشر عام، وتتم حماية تبادل الرمز عبر PKCE بدلاً من سر العميل.
الصفحات المستضافة أو شاشاتك الخاصة
اختر المكان الذي يُدخل فيه الأشخاص بريدهم الإلكتروني أو كلمة المرور أو الرمز. الإعداد هوsign_in_ui (القيمة الافتراضية hosted، أو own)، ويمكنك تغييره لاحقاً.
ترتبط مفاتيح المرور بأصل تسجيل الدخول في تطبيقك.
تعمل طرق مفاتيح المرور في SDKs فقط على الصفحات المقدَّمة من هذا الأصل، لذا على شاشاتك الخاصة في نطاق آخر، وجّه الأشخاص إلى الصفحة المستضافة لاستخدام مفاتيح المرور.
اختر حزمة SDK الخاصة بك
إذا لم تستخدم SDK، فنفّذ مسار رمز التفويض مع PKCE بنفسك. يوضح دليل البدء السريع لـ JavaScript العقد الكامل.
حماية الخادم الخلفي
يتحكم فحص الجلسة في الواجهة الأمامية فيما يُعرض فقط. يتخذ خادمك الخلفي كل قرار استناداً إلى token الوصول الذي تم التحقق منه.- تحقّق من token الوصول في كل طلب. تحقّق من توقيع ES256 مقابل JWKS الخاص بمُصدِرك، ثم من
issوaudوexpوtyp: at+jwt، وارفض token إذا كانت قيمةactغيرnull، إلا إذا كان المسار يقبل وكلاء الذكاء الاصطناعي. راجع التحقق من الرمز على خادمك. - تحقّق من الجلسة الفعلية قبل أي إجراء حساس. يبقى token الوصول صالحاً حتى تنتهي مدة صلاحيته، ولا تتجاوز هذه المدة 5 دقائق. يفشل
GET /session/فوراً إذا أُلغيت الجلسة أو أصبحت خاملة أو انتهت، أو إذا حُظر المستخدم النهائي، أو إذا لم تعد الجلسة تستوفي سياسة MFA لديك. راجع التحقق من الجلسة. - اطلب تحققاً إضافياً عندما يكون الإجراء محفوفاً بالمخاطر. قبل أي دفعة صادرة أو إضافة حساب بنكي جديد أو تغيير البريد الإلكتروني أو رقم الهاتف، اسأل Didit عما إذا كان على المستخدم النهائي التحقق مجدداً. لا تتصرف إلا بناءً على تحقق إضافي بحالة
approvedقرأه خادمك الخلفي بنفسه. راجع التحقق الإضافي قبل الإجراءات الحساسة. - خذ
vendor_dataمن token الوصول الذي تم التحقق منه، أبداً من أي حقل أرسله المتصفح، واستخدمه في عمليات التحقق والمعاملات الخاصة بالمستخدم النهائي.
الجلسات
غيّر مدد الجلسات من Authentication > Security and sessions، أو عبر واجهة برمجة التطبيقات من خلال إعدادات التطبيق.

Authentication > Sign-ins > Active sessions، مع زر الإلغاء في كل جلسة.
التطبيقات الأصلية
يعيد Didit المستخدمين إلى تطبيق أصلي عبر إعادة توجيه HTTPS فقط، ولا يقبل أي مخططات URL مخصصة.- iOS: اجعل إعادة التوجيه نطاقًا مرتبطًا مع
webcredentialsفي ملفapple-app-site-associationالخاص بك. - Android: اجعل إعادة التوجيه رابط تطبيق باستخدام ملف
assetlinks.jsonالخاص بك. - سجّل كل عنوان URL لإعادة التوجيه ضمن Authentication > Security and sessions، تمامًا كما تسجّل رابط الاستدعاء للويب.
PUT native-apps/ عبر واجهة برمجة تطبيقات الإدارة الخاصة بالمصادقة.
يدرج Didit بعد ذلك هذه التطبيقات في ملف apple-app-site-association وملف assetlinks.json اللذين يقدّمهما على أصل تسجيل الدخول الخاص بك.
يمثل MANAGEMENT_BASE عنوان واجهة برمجة تطبيقات الإدارة الخاصة بتطبيقك، ويمكن لمفتاح API يملك النطاق authentication بصلاحية الكتابة إجراء هذا الاستدعاء.
يستبدل الاستدعاء القائمتين كلتيهما، لذا أرسلهما معًا:
توضّح أدلة البدء السريع لـiOS وAndroid الجانب الخاص بالتطبيق.
ربط التحقق من الهوية ومراقبة المعاملات
لكل شخص قيمةvendor_data واحدة، تظهر في token الخاص به وفي جلسته.
استخدمها بوصفها vendor_data عند إنشاء جلسة تحقق أو إرسال معاملة، وتعرض وحدة التحكم عمليات تسجيل الدخول وعمليات التحقق والمعاملات الخاصة بالشخص نفسه.
- للتحقق من الأشخاص عند التسجيل أو قبل الصرف مجددًا دون بناء مسار تحقق خاص بك، استخدم الهوية المتحقق منها.
- تصل أحداث تسجيل الدخول إلى قواعد الأحداث وواجهات الاحتيال تلقائيًا. لا ترسل أحداث
auth.loginخاصة بك لعمليات تسجيل الدخول نفسها. - لا يعني نجاح تسجيل الدخول أبدًا الموافقة على عملية تحقق أو معاملة: تعامل مع قرار كل منتج على حدة.
استقبال أحداث تسجيل الدخول
اشترك في أنواعauth.* التي تحتاجها، مثل auth.new_device أو auth.account_locked، باستخدام وجهة webhook.
أزِل التكرار اعتمادًا على auth_event.event_id، وتحقّق من التوقيع كما تفعل مع كل webhook من Didit.
راجع الأحداث وwebhook للاطلاع على كل نوع وpayload الخاص به.
نقل المستخدمين الحاليين
إذا كان لدى مستخدميك حسابات بالفعل على منصة هوية أخرى أو في قاعدة بياناتك الخاصة، فـاستوردهم قبل أن تبدّل تسجيل الدخول. استورِد تجزئات كلمات المرور الخاصة بهم متى وفّرها المصدر، واحتفظ بروابط حساباتهم الاجتماعية، واحتفظ بمعرّفات المستخدمين لديك كقيم في الحقلexternal_id، الذي يصبح vendor_data الخاص بهم.
لا يتغيّر شيء بالنسبة إليهم حتى تبدّل تطبيقك إلى Didit.
قائمة التحقق قبل الإطلاق
- المصادقة مفعّلة لتطبيق Live الخاص بك في صفحة Products.
- عناوين إعادة التوجيه
https://الخاصة بالإنتاج والأصول المسموح بها مسجّلة على تطبيق Live. لا يقبل تطبيق Live أي عناوينhttp://. - تستخدم كل طريقة لتسجيل الدخول عبر الشبكات الاجتماعية معرّف العميل والسر الخاصين بتطبيقك: بيانات اعتماد الاختبار من Didit تعمل في البيئة التجريبية فقط.
- تحتوي إعدادات الإنتاج لديك على مفتاح النشر الخاص ببيئة Live (
pk_live_) والمُصدِر الخاص ببيئة Live. - سياسة المصادقة متعددة العوامل (MFA) ومدة الجلسة ومهلة الخمول وطول كلمة المرور وسياسة التسجيل مضبوطة وفق ما تريد. راجع إعدادات التطبيق.
- الحماية من الروبوتات مفعّلة، مع فحص كلمات المرور المسرّبة.
- يتحقق الخادم الخلفي لديك من كل token للوصول، ويستدعي
GET /session/قبل الإجراءات الحساسة. - الهوية البصرية ونصوص الصفحات وروابط الشروط والخصوصية مضبوطة. إذا كنت تخطط لاستخدام نطاق مخصص، ففعّله قبل أن يبدأ المستخدمون بإضافة مفاتيح المرور.
- وجهة webhook الخاصة بك مشتركة في الأنواع
auth.*التي تتعامل معها. - اختبرت على تطبيق Live: التسجيل، وتسجيل الدخول للمستخدمين العائدين، والإلغاء، واستعادة كلمة المرور عند نسيانها، والمصادقة متعددة العوامل (MFA)، وانتهاء صلاحية الجلسة، وتسجيل الخروج، والجلسة المسحوبة.