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

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

Прежде чем начать

1. Если вы еще этого не сделали, добавьте Firebase в свой Android-проект .
2. В файле Gradle вашего модуля (уровня приложения) (обычно <project>/<app-module>/build.gradle.kts или <project>/<app-module>/build.gradle ) добавьте зависимость от библиотеки Firebase Authentication для Android. Мы рекомендуем использовать Firebase Android BoM для управления версиями библиотек.

   dependencies {
       // Import the BoM for the Firebase platform
       implementation(platform("com.google.firebase:firebase-bom:34.9.0"))
   
       // Add the dependency for the Firebase Authentication library
       // When using the BoM, you don't specify versions in Firebase library dependencies
       implementation("com.google.firebase:firebase-auth")
   }

   Использование Firebase Android BoM , что ваше приложение всегда будет использовать совместимые версии библиотек Firebase Android.

   (Альтернативный вариант) Добавление зависимостей библиотеки Firebase без использования BoM

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

   Обратите внимание, что если вы используете несколько библиотек Firebase в своем приложении, мы настоятельно рекомендуем использовать BoM для управления версиями библиотек, что гарантирует совместимость всех версий.

   dependencies {
       // Add the dependency for the Firebase Authentication library
       // When NOT using the BoM, you must specify versions in Firebase library dependencies
       implementation("com.google.firebase:firebase-auth:24.0.1")
   }

3. Если вы еще не подключили свое приложение к проекту Firebase, сделайте это через консоль Firebase .
4. Включить анонимную аутентификацию:
   1. В консоли Firebase откройте раздел «Аутентификация» .
   2. На странице «Способы входа» включите анонимный способ входа.
   3. Необязательно : Если вы обновили свой проект до Firebase Authentication with Identity Platform , вы можете включить автоматическую очистку. При включении этой настройки анонимные учетные записи старше 30 дней будут автоматически удаляться. В проектах с включенной автоматической очисткой анонимная аутентификация больше не будет учитываться в лимитах использования или платежных квотах. См. раздел «Автоматическая очистка» .

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

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

1. В методе onCreate вашего Activity получите общий экземпляр объекта FirebaseAuth :

   Kotlin

   private lateinit var auth: FirebaseAuth
   // ...
   // Initialize Firebase Auth
   auth = Firebase.auth
   AnonymousAuthActivity.kt

   Java

   private FirebaseAuth mAuth;
   // ...
   // Initialize Firebase Auth
   mAuth = FirebaseAuth.getInstance();
   AnonymousAuthActivity.java

2. При инициализации Activity проверьте, вошел ли пользователь в систему:

   Kotlin

   public override fun onStart() {
       super.onStart()
       // Check if user is signed in (non-null) and update UI accordingly.
       val currentUser = auth.currentUser
       updateUI(currentUser)
   }
   AnonymousAuthActivity.kt

   Java

   @Override
   public void onStart() {
       super.onStart();
       // Check if user is signed in (non-null) and update UI accordingly.
       FirebaseUser currentUser = mAuth.getCurrentUser();
       updateUI(currentUser);
   }
   AnonymousAuthActivity.java

3. Наконец, вызовите signInAnonymously , чтобы войти в систему как анонимный пользователь:

   Kotlin

   auth.signInAnonymously()
       .addOnCompleteListener(this) { task ->
           if (task.isSuccessful) {
               // Sign in success, update UI with the signed-in user's information
               Log.d(TAG, "signInAnonymously:success")
               val user = auth.currentUser
               updateUI(user)
           } else {
               // If sign in fails, display a message to the user.
               Log.w(TAG, "signInAnonymously:failure", task.exception)
               Toast.makeText(
                   baseContext,
                   "Authentication failed.",
                   Toast.LENGTH_SHORT,
               ).show()
               updateUI(null)
           }
       }
   AnonymousAuthActivity.kt

   Java

   mAuth.signInAnonymously()
           .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() {
               @Override
               public void onComplete(@NonNull Task<AuthResult> task) {
                   if (task.isSuccessful()) {
                       // Sign in success, update UI with the signed-in user's information
                       Log.d(TAG, "signInAnonymously:success");
                       FirebaseUser user = mAuth.getCurrentUser();
                       updateUI(user);
                   } else {
                       // If sign in fails, display a message to the user.
                       Log.w(TAG, "signInAnonymously:failure", task.getException());
                       Toast.makeText(AnonymousAuthActivity.this, "Authentication failed.",
                               Toast.LENGTH_SHORT).show();
                       updateUI(null);
                   }
               }
           });
   AnonymousAuthActivity.java

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

Для защиты вашего проекта от злоупотреблений Firebase ограничивает количество новых регистраций по электронной почте/паролю и анонимных регистраций с одного и того же IP-адреса за короткий период времени. Вы можете запросить и запланировать временное изменение этой квоты в консоли Firebase .

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

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

1. Когда пользователь регистрируется, завершите процесс авторизации для поставщика аутентификации пользователя, включая вызов одного из методов FirebaseAuth.signInWith . Например, получите токен Google ID пользователя, токен доступа Facebook или адрес электронной почты и пароль.

2. Получите учетные данные AuthCredential для нового поставщика аутентификации:

   Вход через Google

   Kotlin

   val credential = GoogleAuthProvider.getCredential(googleIdToken, null)
   MainActivity.kt

   Java

   AuthCredential credential = GoogleAuthProvider.getCredential(googleIdToken, null);
   MainActivity.java

   Вход через Facebook

   Kotlin

   val credential = FacebookAuthProvider.getCredential(token.token)
   MainActivity.kt

   Java

   AuthCredential credential = FacebookAuthProvider.getCredential(token.getToken());
   MainActivity.java

   Вход по электронной почте и паролю

   Kotlin

   val credential = EmailAuthProvider.getCredential(email, password)
   MainActivity.kt

   Java

   AuthCredential credential = EmailAuthProvider.getCredential(email, password);
   MainActivity.java

3. Передайте объект AuthCredential методу linkWithCredential пользователя, выполнившего вход в систему:

   Kotlin

   auth.currentUser!!.linkWithCredential(credential)
       .addOnCompleteListener(this) { task ->
           if (task.isSuccessful) {
               Log.d(TAG, "linkWithCredential:success")
               val user = task.result?.user
               updateUI(user)
           } else {
               Log.w(TAG, "linkWithCredential:failure", task.exception)
               Toast.makeText(
                   baseContext,
                   "Authentication failed.",
                   Toast.LENGTH_SHORT,
               ).show()
               updateUI(null)
           }
       }
   AnonymousAuthActivity.kt

   Java

   mAuth.getCurrentUser().linkWithCredential(credential)
           .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() {
               @Override
               public void onComplete(@NonNull Task<AuthResult> task) {
                   if (task.isSuccessful()) {
                       Log.d(TAG, "linkWithCredential:success");
                       FirebaseUser user = task.getResult().getUser();
                       updateUI(user);
                   } else {
                       Log.w(TAG, "linkWithCredential:failure", task.getException());
                       Toast.makeText(AnonymousAuthActivity.this, "Authentication failed.",
                               Toast.LENGTH_SHORT).show();
                       updateUI(null);
                   }
               }
           });
   AnonymousAuthActivity.java

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

Этот метод также можно использовать для связывания любых двух учетных записей .

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

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

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

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

Следующие шаги

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