الانتقال إلى المحتوى الرئيسي
المصادقة ميزة جديدة: DiditAuth for Android يعتمد على الإصدار. لم يتم تأكيد إحداثيات التوزيع والإصدارات وتوقيعات الدوال هنا. لا تُثبّت حزمة مُخمَّنة، ولا تستخدم SDK التحقق من الهوية كأنه SDK للمصادقة.

​
تجهيز التطبيق

  1. تأكد من تفعيل المصادقة لتطبيق Didit الخاص بك، وانسخ من الكونسول أصل تسجيل الدخول (https://<slug>.auth.didit.me، أو <slug>.sandbox.auth.didit.me للبيئة التجريبية).
  2. سجّل رابط الاستدعاء دقيقاً يدعمه تطبيقك وبيئة التشغيل. تحقق من ملكية روابط التطبيق، ولا تفترض أن مخططات URL المخصصة العشوائية مقبولة.
  3. افصل بين إعدادات البيئة التجريبية وإعدادات الإنتاج، بما في ذلك معالجة رابط الاستدعاء وبيانات الاعتماد المخزنة.
  4. اختر آلية ربط ثابتة للشخص قبل ربط التحقق أو المراقبة.
استخدم علامة تبويب في متصفح النظام لتسجيل الدخول المستضاف، وتحقق من رابط التطبيق الذي يعود إليه. تتطلب مفاتيح المرور الأصلية (passkeys) نطاق الطرف المعتمد (relying party) المُعدّ وتدفق بيانات الاعتماد الخاص بالمنصة.

​
تنفيذ التدفق المستضاف

افتح علامة تبويب في متصفح النظام على عنوان {origin}/sign-in. وفّر state عشوائياً جديداً، وتحدي PKCE بطريقة S256، وredirect_uri المسجَّل لديك. احتفظ بالـ verifier داخل تطبيقك لتلك المحاولة فقط. يوضح دليل البدء السريع لـ JavaScript البروتوكول الأساسي؛ استخدم تشفير المنصة ومعالجة الروابط الخاصة بها في التطبيقات الأصلية، بدلاً من المتغيرات العامة للمتصفح. عند العودة إلى التطبيق عبر رابط الاستدعاء، تحقق من state وعمر المعاملة ووجهة رابط الاستدعاء قبل استبدال الرمز المستخدم مرة واحدة عند token/. استخدم الـ verifier الأصلي وredirect URI المطابق تماماً. إلغاء المتصفح أو إغلاقه لا يُعد تسجيل دخول ناجحاً. خزّن رمز التحديث في تخزين مشفّر محمي من المنصة، ولا تخزنه أبداً في ملف تفضيلات عادي أو في التحليلات أو في سجلات الأعطال. تحقق من الجلسة الحالية باستخدام GET session/ مع رمز Bearer للمستخدم النهائي. نفّذ عمليات التجديد بالتسلسل، واستبدل الرمزين معاً، ونظّف الحالة الخاصة بالمستخدم بعد تسجيل الخروج. راجع الرموز وJWKS للاطلاع على عقد الطلب وسلوك إعادة استخدام رمز التجديد.

​
معاينة إصدار SDK الأصلي

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

​
ربط التحقق والمراقبة

يشتق الخادم الخلفي لديك vendor_data من الشخص الموثَّق. وهو ينشئ جلسات التحقق أو يُصدر رموز مراقبة مقيّدة لذلك الشخص. أعِد إلى تطبيقك بيانات اعتماد الجلسة أو الرمز المقيّد فقط، ويبقى مفتاح API على الخادم. استخدم SDK التحقق من الهوية لأندرويد عندما تحتاج إلى التحقق من الهوية. اتبع إرسال المعاملات عبر SDK لدعم المراقبة على منصتك. عامل تسجيل الدخول والتحقق وقرارات المعاملات بشكل منفصل.

​
التحقق من التكامل

اختبر العودة إلى التطبيق بعد إغلاقه بالكامل، والانتقال إلى الخلفية وإلى المقدمة، وإلغاء المتصفح، وعدم تطابق رابط الاستدعاء، وإعادة استخدام الرمز، وانتهاء صلاحية الرمز، والتجديد المتزامن، والمصادقة الإضافية، وتسجيل الخروج، وتسجيل الدخول بحساب مستخدم آخر. اختبر تسجيل مفاتيح المرور الأصلية وتسجيل الدخول بها على الأجهزة المدعومة عند توفر ذلك الإصدار. يبقى الفحص الذي يقتصر على الجهاز غير مُتحقَّق منه حتى يُنفَّذ على المنصة المستهدفة.
آخر تعديل في ٧ نوفمبر ٢٠٢٦