Анонимная аутентификация в Firebase с помощью C++

Вы можете использовать Firebase Authentication для создания и использования временных анонимных аккаунтов для аутентификации в Firebase. Эти временные анонимные аккаунты можно использовать, чтобы предоставить пользователям, которые ещё не зарегистрировались в вашем приложении, доступ к данным, защищенным правилами безопасности. Если анонимный пользователь решит зарегистрироваться в вашем приложении, вы можете связать его учетные данные с анонимным аккаунтом, чтобы он мог продолжать работать со своими защищенными данными в будущих сеансах.

Подготовка

1. Добавьте Firebase в свой проект C++.
2. Если вы ещё не подключили приложение к проекту Firebase, сделайте это в консоли Firebase.
3. Включите анонимную аутентификацию:
   1. В Firebaseконсоли администратора выберите Безопасность > Аутентификация.
   2. На вкладке Sign-in method (Способ входа) включите поставщика для анонимного входа.
   3. Необязательно. Если вы обновили проект до версии Firebase Authentication with Identity Platform, можно включить автоматическую очистку. Если вы включите этот параметр, анонимные аккаунты старше 30 дней будут удаляться автоматически. В проектах с включенной автоматической очисткой анонимная аутентификация больше не будет учитываться в лимитах на использование и квотах на оплату. Подробнее об автоматической очистке…

Анонимная аутентификация с помощью Firebase

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

1. Добавьте файлы заголовков Auth и App:

   #include <cassert>
   #include <cstdint>
   
   #include "firebase/app.h"
   #include "firebase/auth.h"

2. В коде инициализации создайте класс firebase::App.

   #if defined(__ANDROID__)
     firebase::App* app =
         firebase::App::Create(firebase::AppOptions(), my_jni_env, my_activity);
   #else
     firebase::App* app = firebase::App::Create(firebase::AppOptions());
   #endif  // defined(__ANDROID__)

3. Получите класс firebase::auth::Auth для вашего firebase::App. Между App и Auth существует однозначное соответствие.

   firebase::auth::Auth* auth = firebase::auth::Auth::GetAuth(app);

firebase::Future<firebase::auth::AuthResult> result =
    auth->SignInAnonymously();

firebase::Future<firebase::auth::AuthResult> result =
    auth->SignInAnonymouslyLastResult();
if (result.status() == firebase::kFutureStatusComplete) {
  if (result.error() == firebase::auth::kAuthErrorNone) {
    firebase::auth::AuthResult auth_result = *result.result();
    printf("Sign in succeeded for `%s`\n",
           auth_result.user.display_name().c_str());
  } else {
    printf("Sign in failed with error '%s'\n", result.error_message());
  }
}

Как преобразовать анонимный аккаунт в постоянный

Когда анонимный пользователь регистрируется в вашем приложении, вы можете разрешить ему продолжить работу с новым аккаунтом. Например, вы можете добавить в корзину нового аккаунта товары, которые пользователь добавил в корзину до регистрации. Для этого выполните следующие действия:

1. Когда пользователь регистрируется, выполните вход через поставщика услуг аутентификации пользователя, но не вызывайте методы Auth::SignInWith. Например, получить токен идентификатора Google, токен доступа Facebook или адрес электронной почты и пароль.

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

3. Передайте объект 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 выполнен успешно, новый аккаунт пользователя сможет получить доступ к данным Firebase анонимного аккаунта.

Автоматическая очистка

Если вы перешли на Firebase Authentication with Identity Platform, то можете включить автоматическую очистку в консоли Firebase. Если вы включите эту функцию, Firebase будет автоматически удалять анонимные аккаунты старше 30 дней. В проектах с включенной автоматической очисткой анонимная аутентификация не учитывается при расчете лимитов на использование и квот на оплату.

• Анонимные аккаунты, созданные после включения автоматической очистки, могут быть автоматически удалены в любое время по истечении 30 дней с момента создания.
• Существующие анонимные аккаунты будут автоматически удалены через 30 дней после включения автоматической очистки.
• Если вы отключите автоматическую очистку, все анонимные аккаунты, которые должны быть удалены, останутся в списке на удаление.
• Если вы "обновите" анонимный аккаунт, связав его с любым способом входа, он не будет удален автоматически.

Если вы хотите узнать, сколько пользователей будет затронуто, прежде чем включить эту функцию, и вы обновили свой проект до версии Firebase Authentication with Identity Platform, вы можете отфильтровать данные по is_anon в Cloud Logging.

Дальнейшие действия

Теперь, когда пользователи могут проходить аутентификацию с помощью Firebase, вы можете контролировать их доступ к данным в базе данных Firebase с помощью правил Firebase.