Управление пользователями в Firebase

Создать пользователя

Для создания нового пользователя у вас есть следующие варианты:

  • В вашем приложении : создайте нового пользователя в вашем проекте Firebase, вызвав метод createUserWithEmailAndPassword или впервые войдя в систему с помощью федеративного поставщика идентификации, такого как Google Sign-In или Facebook Login .

  • В консоли Firebase : создайте нового пользователя, аутентифицированного по паролю, на вкладке «Безопасность» > «Аутентификация» > «Пользователи» .

Получите текущего авторизованного пользователя.

Рекомендуемый способ получения текущего пользователя — вызов метода getCurrentUser . Если ни один пользователь не авторизован, getCurrentUser возвращает null.

Kotlin 

val user = Firebase.auth.currentUser
if (user != null) {
    // User is signed in
} else {
    // No user is signed in
}

Java 

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();
if (user != null) {
    // User is signed in
} else {
    // No user is signed in
}

В некоторых случаях метод getCurrentUser может вернуть ненулевой объект FirebaseUser но базовый токен окажется недействительным. Это может произойти, например, если пользователь был удален на другом устройстве, и локальный токен не был обновлен. В этом случае вы можете получить действительный объект getCurrentUser , но последующие вызовы к аутентифицированным ресурсам завершатся неудачей.

getCurrentUser также может вернуть null поскольку объект аутентификации еще не завершил инициализацию.

Если вы добавите AuthStateListener, вы будете получать обратный вызов каждый раз, когда изменяется базовое состояние токена. Это может быть полезно для реагирования на крайние случаи, подобные упомянутым выше.

Получить профиль пользователя

Чтобы получить информацию о профиле пользователя, используйте методы доступа экземпляра класса FirebaseUser . Например:

Kotlin 

val user = Firebase.auth.currentUser
user?.let {
    // Name, email address, and profile photo Url
    val name = it.displayName
    val email = it.email
    val photoUrl = it.photoUrl

    // Check if user's email is verified
    val emailVerified = it.isEmailVerified

    // The user's ID, unique to the Firebase project. Do NOT use this value to
    // authenticate with your backend server, if you have one. Use
    // FirebaseUser.getIdToken() instead.
    val uid = it.uid
}

Java 

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();
if (user != null) {
    // Name, email address, and profile photo Url
    String name = user.getDisplayName();
    String email = user.getEmail();
    Uri photoUrl = user.getPhotoUrl();

    // Check if user's email is verified
    boolean emailVerified = user.isEmailVerified();

    // The user's ID, unique to the Firebase project. Do NOT use this value to
    // authenticate with your backend server, if you have one. Use
    // FirebaseUser.getIdToken() instead.
    String uid = user.getUid();
}

Получите информацию о профиле пользователя, относящуюся к конкретному поставщику услуг.

Для получения информации профиля, полученной от поставщиков авторизации, связанных с пользователем, используйте метод getProviderData . Например:

Kotlin 

val user = Firebase.auth.currentUser
user?.let {
    for (profile in it.providerData) {
        // Id of the provider (ex: google.com)
        val providerId = profile.providerId

        // UID specific to the provider
        val uid = profile.uid

        // Name, email address, and profile photo Url
        val name = profile.displayName
        val email = profile.email
        val photoUrl = profile.photoUrl
    }
}

Java 

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();
if (user != null) {
    for (UserInfo profile : user.getProviderData()) {
        // Id of the provider (ex: google.com)
        String providerId = profile.getProviderId();

        // UID specific to the provider
        String uid = profile.getUid();

        // Name, email address, and profile photo Url
        String name = profile.getDisplayName();
        String email = profile.getEmail();
        Uri photoUrl = profile.getPhotoUrl();
    }
}

Обновить профиль пользователя

С помощью метода updateProfile можно обновить основную информацию профиля пользователя — отображаемое имя и URL-адрес фотографии профиля. Например:

Kotlin 

val user = Firebase.auth.currentUser

val profileUpdates = userProfileChangeRequest {
    displayName = "Jane Q. User"
    photoUri = Uri.parse("https://example.com/jane-q-user/profile.jpg")
}

user!!.updateProfile(profileUpdates)
    .addOnCompleteListener { task ->
        if (task.isSuccessful) {
            Log.d(TAG, "User profile updated.")
        }
    }

Java 

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();

UserProfileChangeRequest profileUpdates = new UserProfileChangeRequest.Builder()
        .setDisplayName("Jane Q. User")
        .setPhotoUri(Uri.parse("https://example.com/jane-q-user/profile.jpg"))
        .build();

user.updateProfile(profileUpdates)
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                if (task.isSuccessful()) {
                    Log.d(TAG, "User profile updated.");
                }
            }
        });

Укажите адрес электронной почты пользователя

Адрес электронной почты пользователя можно задать с помощью метода updateEmail . Например:

Kotlin 

val user = Firebase.auth.currentUser

user!!.updateEmail("user@example.com")
    .addOnCompleteListener { task ->
        if (task.isSuccessful) {
            Log.d(TAG, "User email address updated.")
        }
    }

Java 

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();

user.updateEmail("user@example.com")
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                if (task.isSuccessful()) {
                    Log.d(TAG, "User email address updated.");
                }
            }
        });

Отправить пользователю письмо с подтверждением

Вы можете отправить пользователю письмо с подтверждением адреса электронной почты, используя метод sendEmailVerification . Например:

Kotlin 

val user = Firebase.auth.currentUser

user!!.sendEmailVerification()
    .addOnCompleteListener { task ->
        if (task.isSuccessful) {
            Log.d(TAG, "Email sent.")
        }
    }

Java 

FirebaseAuth auth = FirebaseAuth.getInstance();
FirebaseUser user = auth.getCurrentUser();

user.sendEmailVerification()
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                if (task.isSuccessful()) {
                    Log.d(TAG, "Email sent.");
                }
            }
        });

Вы можете настроить используемый шаблон электронного письма на вкладке «Безопасность > Аутентификация > Шаблоны» в консоли Firebase . См. раздел «Шаблоны электронных писем» в Справочном центре Firebase.

Также можно передать состояние через URL-адрес продолжения , чтобы перенаправить пользователя обратно в приложение при отправке письма с подтверждением.

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

Kotlin 

auth.setLanguageCode("fr")
// To apply the default app language instead of explicitly setting it.
// auth.useAppLanguage()

Java 

auth.setLanguageCode("fr");
// To apply the default app language instead of explicitly setting it.
// auth.useAppLanguage();

Установить пароль пользователя

Вы можете установить пароль пользователя с помощью метода updatePassword . Например:

Kotlin 

val user = Firebase.auth.currentUser
val newPassword = "SOME-SECURE-PASSWORD"

user!!.updatePassword(newPassword)
    .addOnCompleteListener { task ->
        if (task.isSuccessful) {
            Log.d(TAG, "User password updated.")
        }
    }

Java 

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();
String newPassword = "SOME-SECURE-PASSWORD";

user.updatePassword(newPassword)
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                if (task.isSuccessful()) {
                    Log.d(TAG, "User password updated.");
                }
            }
        });

Отправить письмо для сброса пароля

Вы можете отправить пользователю письмо для сброса пароля с помощью метода sendPasswordResetEmail . Например:

Kotlin 

val emailAddress = "user@example.com"

Firebase.auth.sendPasswordResetEmail(emailAddress)
    .addOnCompleteListener { task ->
        if (task.isSuccessful) {
            Log.d(TAG, "Email sent.")
        }
    }

Java 

FirebaseAuth auth = FirebaseAuth.getInstance();
String emailAddress = "user@example.com";

auth.sendPasswordResetEmail(emailAddress)
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                if (task.isSuccessful()) {
                    Log.d(TAG, "Email sent.");
                }
            }
        });

Вы можете настроить используемый шаблон электронного письма на вкладке «Безопасность > Аутентификация > Шаблоны» в консоли Firebase . См. раздел «Шаблоны электронных писем» в Справочном центре Firebase.

Также можно передать состояние через URL-адрес продолжения , чтобы перенаправить пользователя обратно в приложение при отправке электронного письма для сброса пароля.

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

Kotlin 

auth.setLanguageCode("fr")
// To apply the default app language instead of explicitly setting it.
// auth.useAppLanguage()

Java 

auth.setLanguageCode("fr");
// To apply the default app language instead of explicitly setting it.
// auth.useAppLanguage();

Вы также можете отправлять электронные письма для сброса пароля из консоли Firebase .

Удалить пользователя

Удалить учетную запись пользователя можно с помощью метода delete . Например:

Kotlin 

val user = Firebase.auth.currentUser!!

user.delete()
    .addOnCompleteListener { task ->
        if (task.isSuccessful) {
            Log.d(TAG, "User account deleted.")
        }
    }

Java 

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();

user.delete()
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                if (task.isSuccessful()) {
                    Log.d(TAG, "User account deleted.");
                }
            }
        });

Также вы можете удалить пользователей в консоли Firebase на вкладке «Безопасность > Аутентификация > Пользователи» .

Повторная аутентификация пользователя

Некоторые действия, требующие повышенного внимания к безопасности, такие как удаление учетной записи , установка основного адреса электронной почты и изменение пароля , предполагают недавний вход пользователя в систему. Если вы выполните одно из этих действий, а пользователь вошел в систему слишком давно, действие завершится с ошибкой и будет выброшено исключение FirebaseAuthRecentLoginRequiredException . В этом случае выполните повторную аутентификацию пользователя, получив от него новые учетные данные для входа и передав их в функцию reauthenticate . Например:

Kotlin 

val user = Firebase.auth.currentUser!!

// Get auth credentials from the user for re-authentication. The example below shows
// email and password credentials but there are multiple possible providers,
// such as GoogleAuthProvider or FacebookAuthProvider.
val credential = EmailAuthProvider
    .getCredential("user@example.com", "password1234")

// Prompt the user to re-provide their sign-in credentials
user.reauthenticate(credential)
    .addOnCompleteListener { Log.d(TAG, "User re-authenticated.") }

Java 

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();

// Get auth credentials from the user for re-authentication. The example below shows
// email and password credentials but there are multiple possible providers,
// such as GoogleAuthProvider or FacebookAuthProvider.
AuthCredential credential = EmailAuthProvider
        .getCredential("user@example.com", "password1234");

// Prompt the user to re-provide their sign-in credentials
user.reauthenticate(credential)
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                Log.d(TAG, "User re-authenticated.");
            }
        });

Импорт учетных записей пользователей

Вы можете импортировать учетные записи пользователей из файла в свой проект Firebase, используя команду auth:import в Firebase CLI. Например: 

firebase auth:import users.json --hash-algo=scrypt --rounds=8 --mem-cost=14