Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

Вы также можете создать новый пароль , прошедших проверку подлинности пользователей в разделе Проверка подлинности Firebase консоли , на странице Users.

Получить текущего пользователя, вошедшего в систему

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

Джава

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

Котлин + KTX

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

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

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

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

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

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

Джава

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();
}

Котлин + KTX

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

    // Check if user's email is verified
    val 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.getToken() instead.
    val uid = user.uid
}

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

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

Джава

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();
    }
}

Котлин + KTX

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
    }
}

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

Вы можете обновить пользователя информации в основной профиль пользователя Отображаемое имя и фото в профиле URL-с updateProfile методом. Например:

Джава

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.");
                }
            }
        });

Котлин + KTX

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.")
            }
        }

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

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

Джава

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.");
                }
            }
        });

Котлин + KTX

val user = Firebase.auth.currentUser

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

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

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

Джава

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.");
                }
            }
        });

Котлин + KTX

val user = Firebase.auth.currentUser

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

Вы можете настроить шаблон электронной почты , который используется в разделе Проверка подлинности Firebase консоли , на странице Шаблоны электронной почты. См Email шаблоны в Firebase справочном центре.

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

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

Джава

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

Котлин + KTX

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

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

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

Джава

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.");
                }
            }
        });

Котлин + KTX

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

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

Отправить электронное письмо для сброса пароля

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

Джава

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.");
                }
            }
        });

Котлин + KTX

val emailAddress = "user@example.com"

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

Вы можете настроить шаблон электронной почты , который используется в разделе Проверка подлинности Firebase консоли , на странице Шаблоны электронной почты. См Email шаблоны в Firebase справочном центре.

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

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

Джава

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

Котлин + KTX

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

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

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

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

Джава

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.");
                }
            }
        });

Котлин + KTX

val user = Firebase.auth.currentUser!!

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

Вы можете также удалять пользователей из раздела Проверка подлинности Firebase консоли , на странице Users.

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

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

Джава

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.");
            }
        });

Котлин + KTX

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.") }

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

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

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