Как связать несколько поставщиков услуг аутентификации с аккаунтом с помощью C++

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

Подготовка

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

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

  1. Войдите в аккаунт пользователя, используя любого поставщика услуг аутентификации или любой метод.
  2. Завершите процесс входа для нового поставщика услуг аутентификации, но не вызывайте методы firebase::auth::Auth::SignInWithCredential. Например, получить токен идентификатора Google, токен доступа Facebook, адрес электронной почты и пароль.
  3. Получите firebase::auth::Credential для нового поставщика услуг аутентификации:

    Вход с аккаунтом Google
    firebase::auth::Credential credential =
        firebase::auth::GoogleAuthProvider::GetCredential(google_id_token,
                                                          nullptr);
    Вход через Facebook
    firebase::auth::Credential credential =
        firebase::auth::FacebookAuthProvider::GetCredential(access_token);
    Вход с помощью адреса электронной почты и пароля
    firebase::auth::Credential credential =
        firebase::auth::EmailAuthProvider::GetCredential(email, password);
  4. Передайте объект firebase::auth::Credential методу LinkWithCredential пользователя, вошедшего в аккаунт:

    // Link the new credential to the currently active user.
    firebase::auth::User current_user = auth->current_user();
    firebase::Future<firebase::auth::AuthResult> result =
        current_user.LinkWithCredential(credential);

    Вызов LinkWithCredential завершится неудачей, если учетные данные уже связаны с другим аккаунтом. В этом случае вам нужно объединить аккаунты и связанные с ними данные в соответствии с требованиями вашего приложения.

    // Gather data for the currently signed in User.
    firebase::auth::User current_user = auth->current_user();
    std::string current_email = current_user.email();
    std::string current_provider_id = current_user.provider_id();
    std::string current_display_name = current_user.display_name();
    std::string current_photo_url = current_user.photo_url();
    
    // Sign in with the new credentials.
    firebase::Future<firebase::auth::AuthResult> result =
        auth->SignInAndRetrieveDataWithCredential(credential);
    
    // To keep example simple, wait on the current thread until call completes.
    while (result.status() == firebase::kFutureStatusPending) {
      Wait(100);
    }
    
    // The new User is now active.
    if (result.error() == firebase::auth::kAuthErrorNone) {
      firebase::auth::User* new_user = *result.result();
    
      // Merge new_user with the user in details.
      // ...
      (void)new_user;
    }

Если вызов LinkWithCredential выполнен успешно, пользователь может войти в систему, используя любого связанного поставщика аутентификации, и получить доступ к тем же данным Firebase.

С одним аккаунтом Firebase может быть связано несколько поставщиков учетных данных (например, Google, Facebook, адрес электронной почты и пароль). Это позволяет пользователю входить в один и тот же аккаунт Firebase разными способами.

Если отменить связь поставщика услуг аутентификации с аккаунтом пользователя, он больше не сможет входить в аккаунт с помощью этого поставщика.

Чтобы отменить связь поставщика аутентификации с аккаунтом пользователя, передайте идентификатор поставщика в метод Unlink. Идентификаторы поставщиков услуг аутентификации, связанных с пользователем, можно получить, вызвав метод ProviderData.

// Unlink the sign-in provider from the currently active user.
firebase::auth::User current_user = auth->current_user();
firebase::Future<firebase::auth::AuthResult> result =
    current_user.Unlink(providerId);

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

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