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

Eiji Kitamura

Meggin Kearney

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

واجهة برمجة التطبيقات Credential Management API:

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

ملاحظة مهمة: يتطلب استخدام واجهة برمجة التطبيقات Credential Management API عرض الصفحة من مصدر آمن.

هل تريد الاطّلاع على طريقة استخدام هذه الميزة عمليًا؟ جرِّب الإصدار التجريبي من Credential Management API واطّلِع على الرمز البرمجي.

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

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

• 51
• 18
• 60
• 13

المصدر

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

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

تحذير: قد يؤدي رصد الميزات من خلال التحقّق من navigator.credentials إلى تعطيل موقعك الإلكتروني على المتصفّحات المتوافقة مع WebAuthn(PublicKeyCredential)، ولكن ليس مع جميع أنواع بيانات الاعتماد (PasswordCredential وFederatedCredential) المحدّدة من خلال Credential Management API. مزيد من المعلومات

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

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

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

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

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

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

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

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

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

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

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

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

تسجيل الخروج

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

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

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

ملاحظات