Как связать несколько поставщиков учетных данных с аккаунтом на платформах Apple

Вы можете разрешить пользователям входить в приложение, используя несколько поставщиков аутентификации, связав учетные данные поставщика с существующим аккаунтом пользователя. Пользователи идентифицируются по одному и тому же идентификатору Firebase независимо от поставщика услуг аутентификации, которого они использовали для входа в систему. Например, пользователь, вошедший в аккаунт с помощью пароля, может связать его с аккаунтом Google и в дальнейшем использовать любой из этих способов. Или анонимный пользователь может связать аккаунт Facebook, а затем войти в него, чтобы продолжить пользоваться вашим приложением.

Подготовка

Добавьте в приложение поддержку двух или более поставщиков услуг аутентификации (возможно, включая анонимную аутентификацию).

Чтобы связать учетные данные поставщика услуг аутентификации с существующим аккаунтом пользователя:

  1. Войдите в аккаунт пользователя, используя любого поставщика услуг аутентификации или любой метод.
  2. Завершите процесс входа для нового поставщика услуг аутентификации, но не вызывайте методы FIRAuth.signInWith. Например, получить токен идентификатора Google, токен доступа Facebook, адрес электронной почты и пароль.

  3. Получите 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];

  4. Передайте объект 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) {
  // ...
}];

Устранение неполадок

Если при попытке связать несколько аккаунтов возникают ошибки, ознакомьтесь с документацией о подтвержденных адресах электронной почты.