Gerenciar usuários no Firebase

Crie um usuário

Você cria um novo usuário no seu projeto do Firebase chamando o método createUserWithEmailAndPassword ou fazendo login em um usuário pela primeira vez usando um provedor de identidade federado, como Google Sign-In ou Facebook Login .

Você também pode criar novos usuários autenticados por senha na seção Autenticação do console do Firebase , na página Usuários.

Obtenha o usuário atualmente conectado

A maneira recomendada de obter o usuário atual é chamando o método getCurrentUser . Se nenhum usuário estiver conectado, getCurrentUser retornará nulo:

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

Existem alguns casos em que getCurrentUser retornará um FirebaseUser não nulo, mas o token subjacente não é válido. Isso pode acontecer, por exemplo, se o usuário tiver sido excluído em outro dispositivo e o token local não tiver sido atualizado. Nesse caso, você poderá obter um usuário válido getCurrentUser , mas as chamadas subsequentes para recursos autenticados falharão.

getCurrentUser também pode retornar null porque o objeto de autenticação não concluiu a inicialização.

Se você anexar um AuthStateListener , receberá um retorno de chamada sempre que o estado do token subjacente for alterado. Isso pode ser útil para reagir a casos extremos como os mencionados acima.

Obtenha o perfil de um usuário

Para obter informações de perfil de um usuário, use os métodos acessadores de uma instância de FirebaseUser . Por exemplo:

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

Obtenha informações de perfil específicas do provedor de um usuário

Para obter as informações de perfil recuperadas dos provedores de login vinculados a um usuário, use o método getProviderData . Por exemplo:

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

Atualizar o perfil de um usuário

Você pode atualizar as informações básicas do perfil de um usuário (o nome de exibição do usuário e o URL da foto do perfil) com o método updateProfile . Por exemplo:

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

Definir o endereço de e-mail de um usuário

Você pode definir o endereço de e-mail de um usuário com o método updateEmail . Por exemplo:

val user = Firebase.auth.currentUser

user
!!.updateEmail("user@example.com")
   
.addOnCompleteListener { task ->
       
if (task.isSuccessful) {
           
Log.d(TAG, "User email address updated.")
       
}
   
}
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.");
               
}
           
}
       
});

Enviar um e-mail de verificação a um usuário

Você pode enviar um email de verificação de endereço para um usuário com o método sendEmailVerification . Por exemplo:

val user = Firebase.auth.currentUser

user
!!.sendEmailVerification()
   
.addOnCompleteListener { task ->
       
if (task.isSuccessful) {
           
Log.d(TAG, "Email sent.")
       
}
   
}
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.");
               
}
           
}
       
});

Você pode personalizar o modelo de e-mail usado na seção Autenticação do console do Firebase , na página Modelos de e-mail. Consulte Modelos de e-mail na Central de Ajuda do Firebase.

Também é possível passar o estado por meio de uma URL de continuação para redirecionar de volta ao aplicativo ao enviar um e-mail de verificação.

Além disso, você pode localizar o e-mail de verificação atualizando o código do idioma na instância Auth antes de enviar o e-mail. Por exemplo:

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

Definir uma senha de usuário

Você pode definir uma senha de usuário com o método updatePassword . Por exemplo:

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

user
!!.updatePassword(newPassword)
   
.addOnCompleteListener { task ->
       
if (task.isSuccessful) {
           
Log.d(TAG, "User password updated.")
       
}
   
}
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.");
               
}
           
}
       
});

Envie um e-mail de redefinição de senha

Você pode enviar um email de redefinição de senha para um usuário com o método sendPasswordResetEmail . Por exemplo:

val emailAddress = "user@example.com"

Firebase.auth.sendPasswordResetEmail(emailAddress)
   
.addOnCompleteListener { task ->
       
if (task.isSuccessful) {
           
Log.d(TAG, "Email sent.")
       
}
   
}
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.");
               
}
           
}
       
});

Você pode personalizar o modelo de e-mail usado na seção Autenticação do console do Firebase , na página Modelos de e-mail. Consulte Modelos de e-mail na Central de Ajuda do Firebase.

Também é possível passar o estado por meio de uma URL de continuação para redirecionar de volta ao aplicativo ao enviar um e-mail de redefinição de senha.

Além disso, você pode localizar o e-mail de redefinição de senha atualizando o código do idioma na instância Auth antes de enviar o e-mail. Por exemplo:

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

Você também pode enviar e-mails de redefinição de senha do console do Firebase.

Excluir um usuário

Você pode excluir uma conta de usuário com o método delete . Por exemplo:

val user = Firebase.auth.currentUser!!

user
.delete()
   
.addOnCompleteListener { task ->
       
if (task.isSuccessful) {
           
Log.d(TAG, "User account deleted.")
       
}
   
}
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.");
               
}
           
}
       
});

Você também pode excluir usuários da seção Autenticação do console do Firebase , na página Usuários.

Reautenticar um usuário

Algumas ações sensíveis à segurança, como excluir uma conta , definir um endereço de e-mail principal e alterar uma senha , exigem que o usuário tenha feito login recentemente. Se você realizar uma dessas ações e o usuário tiver feito login há muito tempo, o action falha e lança FirebaseAuthRecentLoginRequiredException . Quando isso acontecer, autentique novamente o usuário obtendo novas credenciais de login do usuário e passando-as para reauthenticate . Por exemplo:

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

Importar contas de usuário

Você pode importar contas de usuário de um arquivo para seu projeto do Firebase usando o comando auth:import da CLI do Firebase. Por exemplo:

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