واجهة برمجة التطبيقات لإدارة بيانات الاعتماد

Credential Management API: هي واجهة برمجة تطبيقات للمتصفّح تستند إلى المعايير، وتقدّم واجهة آلية بين الموقع الإلكتروني والمتصفّح لتسهيل تسجيل الدخول على جميع الأجهزة.

واجهة برمجة تطبيقات إدارة بيانات الاعتماد:

  • إزالة الصعوبات من عمليات تسجيل الدخول: يمكن إعادة تسجيل دخول المستخدمين تلقائيًا إلى موقع إلكتروني حتى إذا انتهت صلاحية جلستهم أو حفظوا بيانات الاعتماد على جهاز آخر.
  • السماح بتسجيل الدخول بنقرة واحدة باستخدام أداة اختيار الحسابات: يمكن للمستخدمين اختيار حساب في أداة اختيار حسابات أصلية.
  • بيانات اعتماد المتاجر - يمكن لتطبيقك تخزين اسم المستخدم وكلمة المرور أو حتى تفاصيل الحساب الموحَّد. يمكن مزامنة بيانات الاعتماد هذه على جميع الأجهزة من خلال المتصفّح.

هل تريد مشاهدته على أرض الواقع؟ جرِّب الإصدار التجريبي من Credential Management API واطّلِع على الرمز البرمجي.

التحقّق من توافق متصفّحات Credential Management API

توافق المتصفّح

  • Chrome: 51
  • الحافة: 18.
  • Firefox: 60
  • ‫Safari: 13

المصدر

قبل استخدام واجهة برمجة التطبيقات Credential Management API، تحقَّق أولاً ممّا إذا كان PasswordCredential أو FederatedCredential متوافقًا.

if (window.PasswordCredential || window.FederatedCredential) {
  // Call navigator.credentials.get() to retrieve stored
  // PasswordCredentials or FederatedCredentials.
}

تسجيل دخول المستخدم

لتسجيل دخول المستخدم، استرجع بيانات الاعتماد من مدير كلمة المرور في المتصفّح واستخدِمها لتسجيل دخول المستخدم.

على سبيل المثال:

  1. عندما يصل مستخدم إلى موقعك الإلكتروني ولم يسجِّل الدخول، اتصل على navigator.credentials.get().
  2. استخدِم بيانات الاعتماد التي تم استرجاعها لتسجيل دخول المستخدم.
  3. يُرجى تعديل واجهة المستخدم للإشارة إلى أنّ المستخدم قد سجَّل الدخول.

اطّلِع على مزيد من المعلومات في مقالة تسجيل دخول المستخدمين.

حفظ بيانات اعتماد المستخدم أو تعديلها

إذا سجّل المستخدم الدخول باستخدام موفِّر هوية مُوحَّد، مثل Google Sign-In أو Facebook أو GitHub:

  1. بعد أن يسجِّل المستخدم الدخول بنجاح أو ينشئ حسابًا، أنشِئ FederatedCredential باستخدام عنوان البريد الإلكتروني الخاص بالمستخدم كرقم تعريف، وحدِّد موفِّر الهوية من خلال FederatedCredentials.provider.
  2. احفظ كائن بيانات الاعتماد باستخدام navigator.credentials.store().

اطّلِع على مزيد من المعلومات في مقالة تسجيل دخول المستخدمين.

إذا سجّل المستخدم الدخول باستخدام اسم مستخدم وكلمة مرور:

  1. بعد أن يسجِّل المستخدم الدخول بنجاح أو ينشئ حسابًا، يمكنك إنشاء PasswordCredential مع رقم تعريف المستخدم وكلمة المرور.
  2. احفظ عنصر بيانات الاعتماد باستخدام navigator.credentials.store().

اطّلِع على مزيد من المعلومات في مقالة حفظ بيانات الاعتماد من "نماذج Google".

تسجيل الخروج

عندما يسجِّل المستخدم الخروج، اتصل بالرقم navigator.credentials.preventSilentAccess() لمنع تسجيل دخول المستخدم تلقائيًا مرة أخرى.

يؤدي إيقاف ميزة "تسجيل الدخول تلقائيًا" أيضًا إلى تمكين المستخدمين من التبديل بين الحسابات بسهولة، مثلاً بين حساب العمل والحساب الشخصي، أو بين الحسابات على الأجهزة المشتركة، بدون الحاجة إلى إعادة إدخال معلومات تسجيل الدخول.

تعرَّف على المزيد من المعلومات من خلال تسجيل الخروج.

ملاحظات