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 configurando un oyente en el objeto de autenticación:
class MyAuthStateListener : public firebase::auth::AuthStateListener {
public:
void OnAuthStateChanged(firebase::auth::Auth* auth) override {
firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
// User is signed in
printf("OnAuthStateChanged: signed_in %s\n", user.uid().c_str());
} else {
// User is signed out
printf("OnAuthStateChanged: signed_out\n");
}
// ...
}
};
// ... initialization code
// Test notification on registration.
MyAuthStateListener state_change_listener;
auth->AddAuthStateListener(&state_change_listener);
Al utilizar un detector, se asegura de que el objeto de autenticación no esté en un estado intermedio (como la inicialización) cuando obtiene el usuario actual.
También puede obtener el usuario que ha iniciado sesión actualmente llamando current_user . Si un usuario no ha iniciado sesión, el método is_valid del usuario devolverá falso.
Conservar la credencial de un usuario
Las credenciales del usuario se almacenarán en el almacén de claves local después de que el usuario inicie sesión. La caché local de las credenciales del usuario se puede eliminar al cerrar la sesión del usuario. El almacén de claves es específico de la plataforma:
- Plataformas Apple: Servicios de llavero .
- Android: almacén de claves de Android .
- Windows: API de administración de credenciales .
- OS X: Servicios de llavero .
- Linux: libsecret , que el usuario debe tener instalado.
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 firebase::auth::User . Por ejemplo:
firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
std::string name = user.display_name();
std::string email = user.email();
std::string photo_url = user.photo_url();
// 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 firebase::auth::User::Token() instead.
std::string uid = user.uid();
}
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 ProviderData . Por ejemplo:
firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
for (auto it = user.provider_data().begin();
it != user.provider_data().end(); ++it) {
firebase::auth::UserInfoInterface profile = *it;
// Id of the provider (ex: google.com)
std::string providerId = profile.provider_id();
// UID specific to the provider
std::string uid = profile.uid();
// Name, email address, and profile photo Url
std::string name = profile.display_name();
std::string email = profile.email();
std::string photoUrl = profile.photo_url();
}
}
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 UpdateUserProfile . Por ejemplo:
firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
firebase::auth::User::UserProfile profile;
profile.display_name = "Jane Q. User";
profile.photo_url = "https://example.com/jane-q-user/profile.jpg";
user.UpdateUserProfile(profile).OnCompletion(
[](const firebase::Future<void>& completed_future, void* user_data) {
// We are probably in a different thread right now.
if (completed_future.error() == 0) {
printf("User profile updated.");
}
},
nullptr); // pass user_data here.
}
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:
firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
user.UpdateEmail("user@example.com")
.OnCompletion(
[](const firebase::Future<void>& completed_future,
void* user_data) {
// We are probably in a different thread right now.
if (completed_future.error() == 0) {
printf("User email address updated.");
}
},
nullptr);
}
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:
firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
user.SendEmailVerification().OnCompletion(
[](const firebase::Future<void>& completed_future, void* user_data) {
// We are probably in a different thread right now.
if (completed_future.error() == 0) {
printf("Email sent.");
}
},
nullptr);
}
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.
Establecer la contraseña de un usuario
Puede establecer la contraseña de un usuario con el método UpdatePassword . Por ejemplo:
firebase::auth::User user = auth->current_user();
std::string newPassword = "SOME-SECURE-PASSWORD";
if (user.is_valid()) {
user.UpdatePassword(newPassword.c_str())
.OnCompletion(
[](const firebase::Future<void>& completed_future,
void* user_data) {
// We are probably in a different thread right now.
if (completed_future.error() == 0) {
printf("password updated.");
}
},
nullptr);
}
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:
std::string emailAddress = "user@example.com";
auth->SendPasswordResetEmail(emailAddress.c_str())
.OnCompletion(
[](const firebase::Future<void>& completed_future,
void* user_data) {
// We are probably in a different thread right now.
if (completed_future.error() == 0) {
// Email sent.
} else {
// An error happened.
printf("Error %d: %s", completed_future.error(),
completed_future.error_message());
}
},
nullptr);
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 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:
firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
user.Delete().OnCompletion(
[](const firebase::Future<void>& completed_future, void* user_data) {
if (completed_future.error() == 0) {
// User deleted.
} else {
// An error happened.
printf("Error %d: %s", completed_future.error(),
completed_future.error_message());
}
},
nullptr);
}
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.
Cuando esto suceda, vuelva a autenticar al usuario obteniendo nuevas credenciales de inicio de sesión del usuario y pasándolas a Reauthenticate . Por ejemplo:
firebase::auth::User user = auth->current_user();
// 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.
firebase::auth::Credential credential =
firebase::auth::EmailAuthProvider::GetCredential("user@example.com",
"password1234");
if (user.is_valid()) {
user.Reauthenticate(credential)
.OnCompletion(
[](const firebase::Future<void>& completed_future,
void* user_data) {
if (completed_future.error() == 0) {
printf("User re-authenticated.");
}
},
nullptr);
}
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