Utwórz użytkownika
Nowego użytkownika tworzysz w swoim projekcie Firebase, wywołując metodę CreateUserWithEmailAndPassword lub logując użytkownika po raz pierwszy przy użyciu federacyjnego dostawcy tożsamości, takiego jak Google Sign-In lub Facebook Login .
Możesz też utworzyć nowych użytkowników uwierzytelnionych hasłem w sekcji Uwierzytelnianie konsoli Firebase na stronie Użytkownicy.
Pobierz aktualnie zalogowanego użytkownika
Zalecanym sposobem uzyskania bieżącego użytkownika jest ustawienie detektora na obiekcie 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);
Używając odbiornika, upewniasz się, że obiekt Auth nie jest w stanie pośrednim — takim jak inicjalizacja — w momencie uzyskania bieżącego użytkownika.
Możesz również uzyskać aktualnie zalogowanego użytkownika, dzwoniąc do current_user . Jeśli użytkownik nie jest zalogowany, metoda is_valid użytkownika zwróci wartość false.
Zachowaj poświadczenia użytkownika
Po zalogowaniu użytkownika poświadczenia użytkownika będą przechowywane w lokalnym magazynie kluczy. Lokalną pamięć podręczną poświadczeń użytkownika można usunąć, wylogowując użytkownika. Magazyn kluczy jest specyficzny dla platformy:
- Platformy Apple: Usługi pęku kluczy .
- Android: Magazyn kluczy Androida .
- Windows: interfejs API zarządzania poświadczeniami .
- OS X: Usługi pęku kluczy .
- Linux: libsecret , który użytkownik musiał zainstalować.
Uzyskaj profil użytkownika
Aby uzyskać informacje o profilu użytkownika, użyj metod dostępu instancji firebase::auth::User . Na przykład:
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();
}
Uzyskaj informacje o profilu dostawcy specyficzne dla użytkownika
Aby uzyskać informacje o profilu pobrane od dostawców logowania połączonych z użytkownikiem, użyj metody ProviderData . Na przykład:
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();
}
}
Zaktualizuj profil użytkownika
Możesz zaktualizować podstawowe informacje profilowe użytkownika — wyświetlaną nazwę użytkownika i adres URL zdjęcia profilowego — za pomocą metody UpdateUserProfile . Na przykład:
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.
}
Ustaw adres e-mail użytkownika
Możesz ustawić adres e-mail użytkownika za pomocą metody UpdateEmail . Na przykład:
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);
}
Wyślij użytkownikowi e-mail weryfikacyjny
Możesz wysłać wiadomość e-mail weryfikującą adres do użytkownika za pomocą metody SendEmailVerification . Na przykład:
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);
}
Możesz dostosować szablon e-maila używany w sekcji Uwierzytelnianie konsoli Firebase na stronie Szablony e-maili. Zobacz Szablony wiadomości e-mail w Centrum pomocy Firebase.
Ustaw hasło użytkownika
Możesz ustawić hasło użytkownika za pomocą metody UpdatePassword . Na przykład:
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);
}
Wyślij wiadomość e-mail dotyczącą resetowania hasła
Możesz wysłać wiadomość e-mail dotyczącą resetowania hasła do użytkownika za pomocą metody SendPasswordResetEmail . Na przykład:
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);
Możesz dostosować szablon e-maila używany w sekcji Uwierzytelnianie konsoli Firebase na stronie Szablony e-maili. Zobacz Szablony wiadomości e-mail w Centrum pomocy Firebase.
Możesz także wysyłać e-maile dotyczące resetowania hasła z konsoli Firebase.
Usuń użytkownika
Konto użytkownika można usunąć za pomocą metody Delete . Na przykład:
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);
}
Możesz też usuwać użytkowników z sekcji Uwierzytelnianie konsoli Firebase na stronie Użytkownicy.
Ponownie uwierzytelnij użytkownika
Niektóre działania związane z bezpieczeństwem — takie jak usunięcie konta , ustawienie podstawowego adresu e-mail i zmiana hasła — wymagają, aby użytkownik był niedawno zalogowany. Jeśli wykonasz jedną z tych czynności, a użytkownik zaloguje się zbyt dawno temu, akcja kończy się niepowodzeniem.
W takim przypadku ponownie uwierzytelnij użytkownika, uzyskując nowe poświadczenia logowania od użytkownika i przekazując poświadczenia do Reauthenticate . Na przykład:
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);
}
Importuj konta użytkowników
Możesz zaimportować konta użytkowników z pliku do projektu Firebase za pomocą polecenia auth:import interfejsu Firebase CLI. Na przykład:
firebase auth:import users.json --hash-algo=scrypt --rounds=8 --mem-cost=14