استعادة بيانات الاعتماد

تتيح ميزة استعادة بيانات الاعتماد في "مدير بيانات الاعتماد" للمستخدمين استعادة حسابات التطبيقات عند إعداد جهاز جديد. تتوفّر واجهة برمجة التطبيقات هذه في معاينة المطوّر وهي متاحة على جميع الأجهزة التي تعمل بالإصدار 9 من نظام التشغيل Android أو الإصدارات الأحدث والإصدار الأساسي من "خدمات Google Play" (GMS) بالإصدار 242200000 أو الإصدارات الأحدث. تشمل مزايا ميزة "استعادة بيانات الاعتماد" ما يلي:

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

آلية العمل

يمكنك استخدام ميزة "استعادة بيانات الاعتماد" لإنشاء بيانات الاعتماد ذات الصلة والحصول عليها ومحوها.

1. إنشاء بيانات اعتماد الاستعادة: عند تسجيل المستخدم الدخول إلى تطبيقك، أنشئ بيانات اعتماد استعادة مرتبطة بحسابه. يتم تخزين بيانات الاعتماد هذه على الجهاز وتتم مزامنتها مع السحابة الإلكترونية إذا فعّل المستخدم ميزة "الاحتفاظ بنسخة احتياطية" من Google وكان التشفير التام بين الأطراف متاحًا (يمكن للتطبيقات إيقاف المزامنة مع السحابة الإلكترونية).
2. الحصول على بيانات اعتماد الاستعادة: عندما يُعدّ المستخدم جهازًا جديدًا، يمكن لتطبيقك طلب بيانات اعتماد الاستعادة من "مدير بيانات الاعتماد". يتيح لك ذلك تسجيل دخول المستخدم تلقائيًا بدون الحاجة إلى إدخال أي معلومات إضافية.
3. محو بيانات اعتماد الاستعادة: عندما يسجّل المستخدم الخروج من تطبيقك، يجب حذف بيانات اعتماد الاستعادة المرتبطة.

يمكن دمج ميزة "استعادة بيانات الاعتماد" بسلاسة مع أنظمة الخلفية التي سبق أن نفّذت مفاتيح المرور. يرجع هذا التوافق إلى حقيقة أنّه تلتزم كلّ من مفاتيح المرور ومفاتيح الاستعادة (نوع بيانات الاعتماد المستخدَمة في ميزة استعادة بيانات الاعتماد) بالمواصفات الفنية الأساسية نفسها. يضمن هذا التوافق أن تتمكّن عملية "استعادة بيانات الاعتماد" من استرجاع بيانات اعتماد المستخدم المخزّنة في الأنظمة المزوّدة بمفاتيح المرور واستعادتها بفعالية، ما يقدّم تجربة متّسقة وسهلة الاستخدام على مختلف منصّات المصادقة.

التنفيذ

تتوفّر واجهة برمجة التطبيقات Restore Credentials API من خلال مكتبة Credential Manager في Jetpack. للبدء، اتّبِع الخطوات التالية:

1. أضِف تبعية "مدير بيانات الاعتماد" إلى مشروعك.

   // build.gradle.kts
   implementation("androidx.credentials:credentials:1.5.0-alpha03")
   

2. أنشئ كائن CreateRestoreCredentialRequest.

3. استدعِ الطريقة createCredential() في الكائن CredentialManager.

   val credentialManager = CredentialManager.create(context)
   
   // On a successful authentication create a Restore Key
   // Pass in the context and CreateRestoreCredentialRequest object
   val response = credentialManager.createCredential(context, createRestoreRequest)
   

   إنّ بيانات الاعتماد لاستعادة التي تم إنشاؤها هي نوع من مفاتيح المرور، وتُعرف أيضًا باسم مفتاح استعادة أو مفتاح استرداد.

4. عندما يُعدّ المستخدم جهازًا جديدًا، استخدِم طريقة getCredential() في العنصر CredentialManager.

   // Fetch the Authentication JSON from server
   val authenticationJson = ...
   
   // Create the GetRestoreCredentialRequest object
   val options = GetRestoreCredentialOption(authenticationJson)
   val getRequest = GetCredentialRequest(Immutablelist.of(options))
   
   // The restore key can be fetched in two scenarios to
   // 1. On the first launch of app on the device, fetch the Restore Key
   // 2. In the onRestore callback (if the app implements the Backup Agent)
   val response = credentialManager.getCredential(context, getRequest)
   

5. عندما يسجّل المستخدم الخروج من تطبيقك، استخدِم طريقة clearCredentialState() على عنصر CredentialManager.

   // Create a ClearCredentialStateRequest object
   val clearRequest = ClearCredentialStateRequest(TYPE_CLEAR_RESTORE_CREDENTIAL)
   
   // On user log-out, clear the restore key
   val response = credentialManager.clearCredentialState(clearRequest)
   

إذا كنت تستخدم موظّف دعم احتياطيًا، نفِّذ الجزء getCredential ضمن ردّ الاتصال onRestore. يضمن ذلك استعادة بيانات اعتماد التطبيق فور استعادة بيانات التطبيق.