يمكنك السماح للمستخدمين بتسجيل الدخول إلى تطبيقك باستخدام عدة موفّري مصادقة من خلال ربط بيانات اعتماد موفّر المصادقة بحساب مستخدم حالي. يمكن التعرّف على المستخدمين من خلال رقم تعريف مستخدم Firebase نفسه بغض النظر عن مقدّم خدمة المصادقة الذي استخدموه لتسجيل الدخول. على سبيل المثال، يمكن للمستخدم الذي سجّل الدخول باستخدام كلمة مرور ربط حساب Google وتسجيل الدخول باستخدام أي من الطريقتين في المستقبل. أو يمكن لمستخدم مجهول الهوية ربط حساب Facebook ثم تسجيل الدخول لاحقًا باستخدام Facebook لمواصلة استخدام تطبيقك.
قبل البدء
أضِف إلى تطبيقك إمكانية استخدام اثنين أو أكثر من مقدّمي خدمات المصادقة (قد يشمل ذلك المصادقة المجهولة).
ربط بيانات اعتماد موفّر المصادقة بحساب مستخدم
لربط بيانات اعتماد موفّر المصادقة بحساب مستخدم حالي:
- سجِّل دخول المستخدم باستخدام أيّ مقدّم خدمة أو طريقة مصادقة.
- أكمِل عملية تسجيل الدخول لموفّر المصادقة الجديد حتى استدعاء إحدى طرق
FIRAuth.signInWith، ولكن بدون تضمينها. على سبيل المثال، يمكنك الحصول على رمز تعريف المستخدم على Google أو رمز الوصول إلى Facebook أو البريد الإلكتروني وكلمة المرور. احصل على
FIRAuthCredentialلمقدّم المصادقة الجديد:تسجيل الدخول بحساب Google
Swift
guard let authentication = user?.authentication, let idToken = authentication.idToken else { return } let credential = GoogleAuthProvider.credential(withIDToken: idToken, accessToken: authentication.accessToken)
Objective-C
FIRAuthCredential *credential = [FIRGoogleAuthProvider credentialWithIDToken:result.user.idToken.tokenString accessToken:result.user.accessToken.tokenString];
تسجيل الدخول عبر Facebook
Swift
let credential = FacebookAuthProvider .credential(withAccessToken: AccessToken.current!.tokenString)
Objective-C
FIRAuthCredential *credential = [FIRFacebookAuthProvider credentialWithAccessToken:[FBSDKAccessToken currentAccessToken].tokenString];
تسجيل الدخول باستخدام البريد الإلكتروني وكلمة المرور
Swift
let credential = EmailAuthProvider.credential(withEmail: email, password: password)
Objective-C
FIRAuthCredential *credential = [FIREmailAuthProvider credentialWithEmail:email password:password];
مرِّر عنصر
FIRAuthCredentialإلى طريقةlinkWithCredential:completion:الخاصة بالمستخدم الذي سجّل الدخول:Swift
user.link(with: credential) { authResult, error in // ... } }
Objective-C
[[FIRAuth auth].currentUser linkWithCredential:credential completion:^(FIRAuthDataResult *result, NSError *_Nullable error) { // ... }];
سيتعذّر طلب
linkWithCredential:completion:إذا كانت بيانات الاعتماد مرتبطة بحساب مستخدم آخر. في هذه الحالة، عليك معالجة دمج الحسابات والبيانات المرتبطة بها بما يتناسب مع تطبيقك:Swift
let prevUser = Auth.auth().currentUser Auth.auth().signIn(with: credential) { authResult, error in if let error = error { let authError = error as NSError if isMFAEnabled, authError.code == AuthErrorCode.secondFactorRequired.rawValue { // The user is a multi-factor user. Second factor challenge is required. let resolver = authError .userInfo[AuthErrorUserInfoMultiFactorResolverKey] as! MultiFactorResolver var displayNameString = "" for tmpFactorInfo in resolver.hints { displayNameString += tmpFactorInfo.displayName ?? "" displayNameString += " " } self.showTextInputPrompt( withMessage: "Select factor to sign in\n\(displayNameString)", completionBlock: { userPressedOK, displayName in var selectedHint: PhoneMultiFactorInfo? for tmpFactorInfo in resolver.hints { if displayName == tmpFactorInfo.displayName { selectedHint = tmpFactorInfo as? PhoneMultiFactorInfo } } PhoneAuthProvider.provider() .verifyPhoneNumber(with: selectedHint!, uiDelegate: nil, multiFactorSession: resolver .session) { verificationID, error in if error != nil { print( "Multi factor start sign in failed. Error: \(error.debugDescription)" ) } else { self.showTextInputPrompt( withMessage: "Verification code for \(selectedHint?.displayName ?? "")", completionBlock: { userPressedOK, verificationCode in let credential: PhoneAuthCredential? = PhoneAuthProvider.provider() .credential(withVerificationID: verificationID!, verificationCode: verificationCode!) let assertion: MultiFactorAssertion? = PhoneMultiFactorGenerator .assertion(with: credential!) resolver.resolveSignIn(with: assertion!) { authResult, error in if error != nil { print( "Multi factor finanlize sign in failed. Error: \(error.debugDescription)" ) } else { self.navigationController?.popViewController(animated: true) } } } ) } } } ) } else { self.showMessagePrompt(error.localizedDescription) return } // ... return } // User is signed in // ... } // Merge prevUser and currentUser accounts and data // ... }
Objective-C
FIRUser *prevUser = [FIRAuth auth].currentUser; [[FIRAuth auth] signInWithCredential:credential completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) { if (isMFAEnabled && error && error.code == FIRAuthErrorCodeSecondFactorRequired) { FIRMultiFactorResolver *resolver = error.userInfo[FIRAuthErrorUserInfoMultiFactorResolverKey]; NSMutableString *displayNameString = [NSMutableString string]; for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) { [displayNameString appendString:tmpFactorInfo.displayName]; [displayNameString appendString:@" "]; } [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Select factor to sign in\n%@", displayNameString] completionBlock:^(BOOL userPressedOK, NSString *_Nullable displayName) { FIRPhoneMultiFactorInfo* selectedHint; for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) { if ([displayName isEqualToString:tmpFactorInfo.displayName]) { selectedHint = (FIRPhoneMultiFactorInfo *)tmpFactorInfo; } } [FIRPhoneAuthProvider.provider verifyPhoneNumberWithMultiFactorInfo:selectedHint UIDelegate:nil multiFactorSession:resolver.session completion:^(NSString * _Nullable verificationID, NSError * _Nullable error) { if (error) { [self showMessagePrompt:error.localizedDescription]; } else { [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Verification code for %@", selectedHint.displayName] completionBlock:^(BOOL userPressedOK, NSString *_Nullable verificationCode) { FIRPhoneAuthCredential *credential = [[FIRPhoneAuthProvider provider] credentialWithVerificationID:verificationID verificationCode:verificationCode]; FIRMultiFactorAssertion *assertion = [FIRPhoneMultiFactorGenerator assertionWithCredential:credential]; [resolver resolveSignInWithAssertion:assertion completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) { if (error) { [self showMessagePrompt:error.localizedDescription]; } else { NSLog(@"Multi factor finanlize sign in succeeded."); } }]; }]; } }]; }]; } else if (error) { // ... return; } // User successfully signed in. Get user data from the FIRUser object if (authResult == nil) { return; } FIRUser *user = authResult.user; // ... }]; // Merge prevUser and currentUser accounts and data // ... }];
في حال نجاح الطلب إلى linkWithCredential:completion:، يمكن للمستخدم الآن تسجيل الدخول باستخدام
أيّ موفّر مصادقة مرتبط والوصول إلى بيانات Firebase نفسها.
إلغاء ربط مقدّم خدمة مصادقة بحساب مستخدم
يمكن ربط حساب مستخدم واحد على Firebase بمقدّمي مصادقة متعددين (مثل البريد الإلكتروني/كلمة المرور وGoogle وFacebook)، ما يتيح للمستخدم تسجيل الدخول إلى حساب Firebase نفسه من خلال طرق مختلفة.
إذا ألغيت ربط مقدّم خدمة مصادقة بحساب مستخدم، لن يعود بإمكانه تسجيل الدخول باستخدام مقدّم الخدمة هذا.
لإلغاء ربط موفّر مصادقة بحساب مستخدم، عليك تمرير رقم تعريف الموفّر إلى طريقة unlink. يمكنك الحصول على معرّفات مقدّمي الخدمة
لمقدّمي خدمات المصادقة المرتبطين بمستخدم من السمة providerData.
Swift
Auth.auth().currentUser?.unlink(fromProvider: providerID!) { user, error in // ... }
Objective-C
[[FIRAuth auth].currentUser unlinkFromProvider:providerID completion:^(FIRUser *_Nullable user, NSError *_Nullable error) { // ... }];
تحديد المشاكل وحلّها
إذا واجهت أخطاء عند محاولة ربط حسابات متعددة، يُرجى الاطّلاع على المستندات حول عناوين البريد الإلكتروني التي تم تأكيدها.