Crea un utente
Puoi creare un nuovo utente nel tuo progetto Firebase chiamando il metodo
CreateUserWithEmailAndPassword
o accedendo per la prima volta a un utente con un'identità federata
come Accedi con Google oppure
Accesso a Facebook.
Puoi anche creare nuovi utenti autenticati tramite password dalla sezione Authentication della console Firebase, nella pagina Utenti.
Recuperare l'utente che ha eseguito l'accesso
Il modo consigliato per ottenere l'utente corrente è impostare un ascoltatore sull'oggetto Auth:
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);
Utilizzando un ascoltatore, ti assicuri che l'oggetto Auth non sia in uno stato intermedio, ad esempio l'inizializzazione, quando ricevi l'utente corrente.
Puoi anche chiamare l'utente che ha eseguito l'accesso chiamando il numero current_user
. Se un
utente non ha eseguito l'accesso, il metodo is_valid
dell'utente restituirà false.
Rendi permanente la credenziale di un utente
Le credenziali dell'utente verranno memorizzate nel keystore locale dopo che l'utente ha eseguito l'accesso. La cache locale delle credenziali utente può essere eliminata se l'utente esce. L'archivio chiavi è specifico della piattaforma:
- Piattaforme Apple: Servizi Portachiavi.
- Android: archivio chiavi Android.
- Windows: API Credential Management.
- OS X: Keychain Services.
- Linux: libsecret, che l'utente deve aver installato.
Ottenere il profilo di un utente
Per ottenere le informazioni del profilo di un utente, utilizza i metodi di accesso di un'istanza di
firebase::auth::User
. Ad esempio:
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(); }
Ottenere le informazioni del profilo specifiche del fornitore di un utente
Per ottenere le informazioni del profilo recuperate dai provider di accesso collegati a un
usa il metodo ProviderData
. Ad esempio:
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(); } }
Aggiornare il profilo di un utente
Puoi aggiornare le informazioni di base del profilo di un utente, ovvero il nome visualizzato e l'URL della foto del profilo, con il metodo UpdateUserProfile
. Ad esempio:
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. }
Impostare l'indirizzo email di un utente
Puoi impostare l'indirizzo email di un utente con il metodo UpdateEmail
. Ad esempio:
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); }
Inviare a un utente un'email di verifica
Puoi inviare un'email di verifica dell'indirizzo a un utente con
SendEmailVerification
. Ad esempio:
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); }
Puoi personalizzare il modello email utilizzato nella sezione Autenticazione di Nella pagina Modelli email della console Firebase. Vedi Modelli email in Centro assistenza Firebase.
Imposta la password di un utente
Puoi impostare la password di un utente con il metodo UpdatePassword
. Ad esempio:
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); }
Inviare un'email di reimpostazione della password
Puoi inviare un'email di reimpostazione della password a un utente con SendPasswordResetEmail
. Ad esempio:
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);
Puoi personalizzare il modello email utilizzato nella sezione Autenticazione di Nella pagina Modelli email della console Firebase. Vedi Modelli email in Centro assistenza Firebase.
Puoi anche inviare email di reimpostazione della password dalla console Firebase.
Eliminare un utente
Puoi eliminare un account utente con il metodo Delete
. Ad esempio:
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); }
Puoi anche eliminare gli utenti dalla sezione Autenticazione della console Firebase, nella pagina Utenti.
Ri-autenticare un utente
Alcune azioni sensibili per la sicurezza, come l'eliminazione di un account, l'impostazione di un indirizzo email principale e la modifica di una password, richiedono che l'utente abbia effettuato l'accesso di recente. Se esegui una di queste azioni e l'utente ha eseguito l'accesso troppo tempo fa, l'azione non va a buon fine.
In questo caso, autentica di nuovo l'utente recuperando nuove credenziali di accesso dall'utente e passandole a Reauthenticate
. Ad esempio:
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); }
Importa account utente
Puoi importare gli account utente da un file nel tuo progetto Firebase utilizzando il comando auth:import
dell'interfaccia a riga di comando di Firebase. Ad esempio:
firebase auth:import users.json --hash-algo=scrypt --rounds=8 --mem-cost=14