Crear un usuario
Puedes crear un nuevo usuario en tu proyecto de Firebase llamando al método createUserWithEmailAndPassword
o iniciando sesión como usuario por primera vez usando un proveedor de identidad federado, como Google Sign-In o Facebook Login .
También puedes crear nuevos usuarios autenticados con contraseña desde la sección Autenticación de Firebase console , en la página Usuarios.
Obtener el usuario actualmente registrado
La forma recomendada de obtener el usuario actual es llamando al método getCurrentUser
. Si ningún usuario ha iniciado sesión, getCurrentUser
devuelve 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
}
Hay algunos casos en los que getCurrentUser
devolverá un FirebaseUser
no nulo pero el token subyacente no es válido. Esto puede suceder, por ejemplo, si el usuario fue eliminado en otro dispositivo y el token local no se actualizó. En este caso, es posible que obtenga un usuario válido getCurrentUser
, pero las llamadas posteriores a recursos autenticados fallarán.
getCurrentUser
también podría devolver null
porque el objeto de autenticación no ha terminado de inicializarse.
Si adjunta un AuthStateListener , recibirá una devolución de llamada cada vez que cambie el estado del token subyacente. Esto puede resultar útil para reaccionar ante casos extremos como los mencionados anteriormente.
Obtener el perfil de un usuario
Para obtener la información del perfil de un usuario, use los métodos de acceso de una instancia de FirebaseUser
. Por ejemplo:
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();
}
Obtener la información de perfil específica del proveedor de un usuario
Para obtener la información del perfil recuperada de los proveedores de inicio de sesión vinculados a un usuario, utilice el método getProviderData
. Por ejemplo:
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();
}
}
Actualizar el perfil de un usuario
Puede actualizar la información básica del perfil de un usuario (el nombre para mostrar del usuario y la URL de la foto del perfil) con el método updateProfile
. Por ejemplo:
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.");
}
}
});
Establecer la dirección de correo electrónico de un usuario
Puede configurar la dirección de correo electrónico de un usuario con el método updateEmail
. Por ejemplo:
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 a un usuario un correo electrónico de verificación
Puede enviar un correo electrónico de verificación de dirección a un usuario con el método sendEmailVerification
. Por ejemplo:
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.");
}
}
});
Puede personalizar la plantilla de correo electrónico que se utiliza en la sección Autenticación de Firebase console , en la página Plantillas de correo electrónico. Consulte Plantillas de correo electrónico en el Centro de ayuda de Firebase.
También es posible pasar el estado a través de una URL continua para redirigir nuevamente a la aplicación al enviar un correo electrónico de verificación.
Además, puede localizar el correo electrónico de verificación actualizando el código de idioma en la instancia de autenticación antes de enviar el correo electrónico. Por ejemplo:
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();
Establecer la contraseña de un usuario
Puede establecer la contraseña de un usuario con el método updatePassword
. Por ejemplo:
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.");
}
}
});
Enviar un correo electrónico para restablecer la contraseña
Puede enviar un correo electrónico de restablecimiento de contraseña a un usuario con el método sendPasswordResetEmail
. Por ejemplo:
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.");
}
}
});
Puede personalizar la plantilla de correo electrónico que se utiliza en la sección Autenticación de Firebase console , en la página Plantillas de correo electrónico. Consulte Plantillas de correo electrónico en el Centro de ayuda de Firebase.
También es posible pasar el estado a través de una URL continua para redirigir nuevamente a la aplicación al enviar un correo electrónico de restablecimiento de contraseña.
Además, puede localizar el correo electrónico de restablecimiento de contraseña actualizando el código de idioma en la instancia de autenticación antes de enviar el correo electrónico. Por ejemplo:
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();
También puede enviar correos electrónicos para restablecer la contraseña desde Firebase console.
Eliminar un usuario
Puede eliminar una cuenta de usuario con el método delete
. Por ejemplo:
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.");
}
}
});
También puedes eliminar usuarios desde la sección Autenticación de Firebase console , en la página Usuarios.
Volver a autenticar a un usuario
Algunas acciones sensibles a la seguridad, como eliminar una cuenta , configurar una dirección de correo electrónico principal y cambiar una contraseña , requieren que el usuario haya iniciado sesión recientemente. Si realiza una de estas acciones y el usuario inició sesión hace demasiado tiempo, el La acción falla y arroja FirebaseAuthRecentLoginRequiredException
. Cuando esto suceda, vuelva a autenticar al usuario obteniendo nuevas credenciales de inicio de sesión del usuario y pasándolas para reauthenticate
. Por ejemplo:
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 cuentas de usuario
Puedes importar cuentas de usuario desde un archivo a tu proyecto de Firebase usando el comando auth:import
Firebase CLI. Por ejemplo:
firebase auth:import users.json --hash-algo=scrypt --rounds=8 --mem-cost=14