الانتقال إلى المحتوى الرئيسي
يشرح هذا الدليل السريع كيفية تشغيل Didit Authentication من البداية إلى النهاية في حوالي 10 دقائق. تقوم بتسجيل رابط استدعاء في تطبيق في البيئة التجريبية، وتفعيل طريقة تسجيل دخول، وتسجيل دخول المستخدم عبر صفحة تسجيل الدخول المستضافة، ثم التحقق من access token على الخادم الخاص بك، وتشاهد عملية تسجيل الدخول في Business Console.

المتطلبات الأساسية

  • حساب Didit مع تطبيق في البيئة التجريبية (Sandbox). إنشاء الحساب مجاني، وميزة المصادقة مفعّلة في كل تطبيق في البيئة التجريبية.
  • Node.js 20 أو أحدث، وتطبيق ويب يمكنك تشغيله على http://localhost:3000.

الخطوات

1

افتح تطبيق Sandbox الخاص بك

في Business Console، استخدم مبدّل التطبيقات لتحديد تطبيق Sandbox الخاص بك، ثم افتح Authentication.يقبل تطبيق Sandbox عمليات الاستدعاء على http://localhost وبيانات اعتماد الاختبار الخاصة بـ Didit لتسجيل الدخول عبر وسائل التواصل الاجتماعي، ولا تُفرض عليه أي رسوم أبداً. أما تطبيق Live فتُفعّل فيه المصادقة من صفحة Products بدلاً من ذلك: راجع تهيئة تطبيقك.
2

سجّل رابط الاستدعاء والأصل

افتح Authentication > Security and sessions > Redirect URLs and allowed origins وأضِف:لا تُعيد Didit توجيه الشخص إلا إلى رابط إعادة توجيه سجّلته لديك، حرفاً بحرف. يتيح الأصل المسموح للمتصفح تبادل الرمز مع أصل Didit الخاص بتطبيقك.
بطاقة Redirect URLs and allowed origins في لوحة Didit Business Console، بجوار قائمة السماح وقائمة الحظر وعنوان URL لتسجيل الدخول

روابط إعادة التوجيه والأصول المسموحة، ضمن Authentication > Security and sessions.

3

فعّل طريقة تسجيل دخول

افتح Authentication > Sign-in methods وفعّل Email code. يبدأ أي تطبيق جديد وجميع الطرق فيه معطّلة، وتعرض الصفحة المستضافة الطرق التي تفعّلها فقط.يمكنك أيضاً إضافة Passkeys إن أردت، أو طريقة تسجيل دخول عبر وسائل التواصل الاجتماعي مع بيانات اعتماد الاختبار من Didit، وهي تعمل في Sandbox دون الحاجة إلى تطبيق خاص بك. تُشرح كل طريقة في طرق تسجيل الدخول.
صفحة Sign-in methods في لوحة Didit Business Console، وتضم بطاقة صفحة تسجيل الدخول المستضافة، وطرق تسجيل الدخول بدون كلمة مرور وبكلمة المرور، ومعاينة مباشرة للصفحة المستضافة

Authentication > Sign-in methods، مع معاينة مباشرة للصفحة المستضافة.

4

انسخ المفتاح القابل للنشر

افتح Authentication > Developers وانسخ Publishable key. في تطبيق Sandbox يبدأ بـ pk_test_.المفتاح القابل للنشر عام، ويعرّف أصل تسجيل الدخول في Didit الخاص بتطبيقك. لا تضع Secret key أبداً في شيفرة المتصفح أو شيفرة تطبيق الجوال.
5

ثبّت SDK وسجّل الدخول

auth.ts
انقر على الزر: تطلب الصفحة المستضافة عنوان بريد إلكتروني وترسل رمزاً مكوّناً من ستة أرقام. أدخل الرمز، فتعيدك Didit إلى رابط الاستدعاء الخاص بك، الذي يستبدل الرمز لمرة واحدة بـ tokens الخاصة بالجلسة. أول تسجيل دخول باستخدام عنوان بريد إلكتروني لا يرتبط بحساب ينشئ حساباً، لأن سياسة التسجيل الافتراضية تتيح لأي شخص التسجيل.
الصفحة المستضافة لتسجيل الدخول على الهاتف، وفيها زر مفتاح المرور وحقلا البريد الإلكتروني وكلمة المرور

الصفحة المستضافة لتسجيل الدخول على الهاتف. تعرض الطرق التي فعّلتها فقط.

6

تحقق من token على خادمك

أرسل token الوصول من auth.getToken() إلى الواجهة الخلفية في ترويسة Authorization، وتحقق منه هناك في كل طلب محمي:
server.ts
يتحقق verifyToken من توقيع ES256 باستخدام المفاتيح المنشورة لجهة الإصدار، ومن جهة الإصدار ومن تاريخ الانتهاء. تبلغ مدة صلاحية tokens الوصول 5 دقائق كحد أقصى، وauth.getToken() يجدّدها لك تلقائياً. ولغات البرمجة الأخرى تتحقق من token نفسه باستخدام حزم SDK للخادم أو أي مكتبة JWT، كما يوضح الرموز وJWKS.
7

اعرض تسجيل الدخول في لوحة التحكم

افتح Authentication > Sign-ins. يظهر تسجيل دخولك مع نتيجته وطريقته وجهازه وموقعه ومخاطره، إلى جانب أمثلة تسجيلات الدخول التي يبدأ بها كل تطبيق Sandbox. ويظهر الشخص ضمن Users.
صفحة Sign-ins في لوحة Didit Business Console، تعرض محاولات تسجيل الدخول مع حالتها وصاحبها وطريقتها وجهازها وموقعها ومخاطرها ووقتها

Authentication > Sign-ins: كل محاولة، مع تصفية حسب الحالة والطريقة والمخاطر.

لتلقي نشاط تسجيل الدخول على خادمك، اربط وجهة webhook بالأحداث auth.signup وauth.login. راجع الأحداث وwebhooks.

قبل الإطلاق

  1. فعّل المصادقة لتطبيقك في بيئة الإنتاج (Live) من صفحة Products.
  2. سجّل هنا عناوين https:// الخاصة بإعادة التوجيه والمصادر في بيئة الإنتاج، علمًا بأن تطبيق Live يقبل عناوين https:// فقط.
  3. استبدل بيانات الاعتماد التجريبية لدى Didit لتسجيل الدخول عبر مواقع التواصل الاجتماعي ببيانات تطبيقك: معرّف العميل (client ID) والسر (secret).
  4. انسخ مفتاح النشر الخاص ببيئة الإنتاج (pk_live_) إلى إعدادات الإنتاج لديك.
  5. راجع قائمة التحقق قبل الإطلاق.

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

دليل التكامل

شاشات مستضافة أو شاشاتك الخاصة، وتخزين token، والجلسات، والتحقق الإضافي، واستكشاف الأخطاء وإصلاحها.

React وNext.js

المكونات والخطافات وملفات تعريف الارتباط HttpOnly والدالة auth() على الخادم.

iOS وAndroid وReact Native وFlutter

تسجيل الدخول عبر التطبيق الأصلي باستخدام متصفح النظام، ومفاتيح المرور، والتخزين المحمي.

الحماية من الروبوتات

فعّل السياسات التي تمنع الروبوتات والاستيلاء على الحساب.
آخر تعديل في ٢٢ نوفمبر ٢٠٢٦