ربط عدة مقدّمي خدمات مصادقة بحساب

يمكنك السماح للمستخدمين بتسجيل الدخول إلى تطبيقك باستخدام موفّري مصادقة متعدّدين من خلال ربط بيانات اعتماد موفّر المصادقة بحساب مستخدم حالي. يمكن التعرّف على المستخدمين من خلال معرّف مستخدم Firebase نفسه بغض النظر عن موفّر المصادقة الذي استخدموه لتسجيل الدخول. على سبيل المثال، يمكن للمستخدم الذي سجّل الدخول باستخدام كلمة مرور ربط حساب Google وتسجيل الدخول باستخدام أي من الطريقتين في المستقبل. أو يمكن لمستخدم مجهول ربط حساب على Facebook، ثم تسجيل الدخول باستخدام Facebook في وقت لاحق لمواصلة استخدام تطبيقك.

قبل البدء

أضِف إمكانية استخدام اثنين أو أكثر من مقدّمي خدمات المصادقة (بما في ذلك المصادقة بدون تحديد الهوية) إلى تطبيقك.

ربط بيانات اعتماد مقدّم خدمة المصادقة بحساب مستخدم

لربط بيانات اعتماد مقدّم خدمة المصادقة بحساب مستخدم حالي، اتّبِع الخطوات التالية:

1. سجِّل دخول المستخدم باستخدام أيّ موفّر أو طريقة مصادقة.

2. أكمِل مسار تسجيل الدخول لموفّر المصادقة الجديد حتى، ولكن بدون، استدعاء إحدى طرق signInWith. على سبيل المثال، يمكنك الحصول على رمز تعريف Google المميز أو رمز الدخول إلى Facebook أو عنوان البريد الإلكتروني وكلمة المرور للمستخدم.

3. احصل على عنصر Credential لموفّر المصادقة الجديد:

   // Google Sign-in
   final credential = GoogleAuthProvider.credential(idToken: idToken);
   
   // Email and password sign-in
   final credential =
       EmailAuthProvider.credential(email: emailAddress, password: password);
   
   // Etc.
   

4. مرِّر العنصر Credential إلى طريقة linkWithCredential() المستخدم الذي سجّل الدخول:

   try {
     final userCredential = await FirebaseAuth.instance.currentUser
         ?.linkWithCredential(credential);
   } on FirebaseAuthException catch (e) {
     switch (e.code) {
       case "provider-already-linked":
         print("The provider has already been linked to the user.");
         break;
       case "invalid-credential":
         print("The provider's credential is not valid.");
         break;
       case "credential-already-in-use":
         print("The account corresponding to the credential already exists, "
             "or is already linked to a Firebase User.");
         break;
       // See the API reference for the full list of error codes.
       default:
         print("Unknown error.");
     }
     ```
   

في حال نجاح طلب linkWithCredential()، يمكن للمستخدم الآن تسجيل الدخول باستخدام أي مقدّم خدمة مصادقة مرتبط والوصول إلى بيانات Firebase نفسها.

إلغاء ربط مقدّم خدمة مصادقة بحساب مستخدم

يمكنك إلغاء ربط موفّر مصادقة بحساب، كي لا يتمكّن المستخدم من تسجيل الدخول باستخدام هذا الموفّر.

لإلغاء ربط مقدّم خدمة مصادقة بحساب مستخدم، مرِّر رقم تعريف مقدّم الخدمة إلى الطريقة unlink(). يمكنك الحصول على أرقام تعريف موفِّري المصادقة المرتبطين بمستخدم من السمة providerData الخاصة بالكائن User.

try {
  await FirebaseAuth.instance.currentUser?.unlink(providerId);
} on FirebaseAuthException catch (e) {
  switch (e.code) {
    case "no-such-provider":
      print("The user isn't linked to the provider or the provider "
          "doesn't exist.");
      break;
    default:
      print("Unknown error.");
  }
}

تحديد المشاكل وحلّها

إذا واجهت أخطاء عند محاولة ربط حسابات متعدّدة، راجِع المستندات حول عناوين البريد الإلكتروني التي تم إثبات ملكيتها.