Sie können Ihren Nutzern die Authentifizierung mit Firebase über ihre Google-Konten ermöglichen, indem Sie Google Log-in in Ihre App einbinden.
Hinweis
- Fügen Sie Ihrem C++-Projekt Firebase hinzu.
- Aktivieren Sie Google als Anmeldeanbieter für Ihr Firebase-Projekt:
- Rufen Sie in der Firebase Console Security > Authentication auf.
- Aktivieren Sie auf dem Tab Anmeldemethode den Anmeldeanbieter Google sign-in provider.
- Klicken Sie auf Speichern.
Aktualisieren Sie Ihre Firebase-Konfigurationsdatei.
Laden Sie die aktualisierte Firebase-Konfigurationsdatei (
google-services.json) herunter, wenn Sie in der Firebase Console dazu aufgefordert werden. Sie enthält jetzt die OAuth-Clientinformationen, die für Google Log-in erforderlich sind.Verschieben Sie diese aktualisierte Konfigurationsdatei in Ihr Android Studio-Projekt und ersetzen Sie die entsprechende veraltete Konfigurationsdatei. Weitere Informationen finden Sie unter Firebase zu Ihrem Android-Projekt hinzufügen.
Auf die Klasse firebase::auth::Auth zugreifen
Die Klasse Auth ist das Gateway für alle API-Aufrufe.
- Fügen Sie die Headerdateien „Auth“ und „App“ hinzu:
#include "firebase/app.h" #include "firebase/auth.h"
- Erstellen Sie in Ihrem Initialisierungscode eine
firebase::App-Klasse.#if defined(__ANDROID__) firebase::App* app = firebase::App::Create(firebase::AppOptions(), my_jni_env, my_activity); #else firebase::App* app = firebase::App::Create(firebase::AppOptions()); #endif // defined(__ANDROID__)
- Rufen Sie die Klasse
firebase::auth::Authfür Ihrefirebase::Appab. Es gibt eine 1:1-Zuordnung zwischenAppundAuth.firebase::auth::Auth* auth = firebase::auth::Auth::GetAuth(app);
Mit Firebase authentifizieren
- Folgen Sie der Anleitung für Android und iOS+ , um ein ID-Token für Google Log-in zu erhalten.
- Nachdem sich ein Nutzer erfolgreich angemeldet hat, tauschen Sie das ID-Token gegen Firebase-Anmeldedaten ein und authentifizieren Sie sich mit den Firebase-Anmeldedaten bei Firebase:
firebase::auth::Credential credential = firebase::auth::GoogleAuthProvider::GetCredential(google_id_token, nullptr); firebase::Future<firebase::auth::AuthResult> result = auth->SignInAndRetrieveDataWithCredential(credential);
- Wenn Ihr Programm eine Aktualisierungsschleife hat, die regelmäßig ausgeführt wird (z. B. 30- oder 60
Mal pro Sekunde), können Sie die Ergebnisse einmal pro Aktualisierung mit
Auth::SignInAndRetrieveDataWithCredentialLastResultprüfen: Wenn Ihr Programm ereignisgesteuert ist, können Sie auch einen Callback für die Future-Klasse registrieren.firebase::Future<firebase::auth::AuthResult> result = auth->SignInAndRetrieveDataWithCredentialLastResult(); if (result.status() == firebase::kFutureStatusComplete) { if (result.error() == firebase::auth::kAuthErrorNone) { firebase::auth::AuthResult auth_result = *result.result(); printf("Sign in succeeded for `%s`\n", auth_result.user.display_name().c_str()); } else { printf("Sign in failed with error '%s'\n", result.error_message()); } }
Callback für eine Future-Klasse registrieren
Einige Programme habenUpdate-Funktionen, die 30- oder 60-mal pro Sekunde aufgerufen werden.
Viele Spiele folgen diesem Modell. Diese Programme können die LastResult-Funktionen aufrufen, um asynchrone Aufrufe abzufragen.
Wenn Ihr Programm ereignisgesteuert ist, können Sie jedoch auch Callback-Funktionen registrieren.
Eine Callback-Funktion wird nach Abschluss der Future-Klasse aufgerufen.
void OnCreateCallback(const firebase::Future<firebase::auth::User*>& result, void* user_data) { // The callback is called when the Future enters the `complete` state. assert(result.status() == firebase::kFutureStatusComplete); // Use `user_data` to pass-in program context, if you like. MyProgramContext* program_context = static_cast<MyProgramContext*>(user_data); // Important to handle both success and failure situations. if (result.error() == firebase::auth::kAuthErrorNone) { firebase::auth::User* user = *result.result(); printf("Create user succeeded for email %s\n", user->email().c_str()); // Perform other actions on User, if you like. firebase::auth::User::UserProfile profile; profile.display_name = program_context->display_name; user->UpdateUserProfile(profile); } else { printf("Created user failed with error '%s'\n", result.error_message()); } } void CreateUser(firebase::auth::Auth* auth) { // Callbacks work the same for any firebase::Future. firebase::Future<firebase::auth::AuthResult> result = auth->CreateUserWithEmailAndPasswordLastResult(); // `&my_program_context` is passed verbatim to OnCreateCallback(). result.OnCompletion(OnCreateCallback, &my_program_context); }
void CreateUserUsingLambda(firebase::auth::Auth* auth) { // Callbacks work the same for any firebase::Future. firebase::Future<firebase::auth::AuthResult> result = auth->CreateUserWithEmailAndPasswordLastResult(); // The lambda has the same signature as the callback function. result.OnCompletion( [](const firebase::Future<firebase::auth::User*>& result, void* user_data) { // `user_data` is the same as &my_program_context, below. // Note that we can't capture this value in the [] because std::function // is not supported by our minimum compiler spec (which is pre C++11). MyProgramContext* program_context = static_cast<MyProgramContext*>(user_data); // Process create user result... (void)program_context; }, &my_program_context); }
Nächste Schritte
Wenn sich ein Nutzer zum ersten Mal anmeldet, wird ein neues Nutzerkonto erstellt und mit den Anmeldedaten verknüpft, mit denen sich der Nutzer angemeldet hat, z. B. Nutzername und Passwort, Telefonnummer oder Informationen zum Authentifizierungsanbieter. Dieses neue Konto wird als Teil Ihres Firebase-Projekts gespeichert und kann verwendet werden, um einen Nutzer in allen Apps Ihres Projekts zu identifizieren, unabhängig davon, wie sich der Nutzer anmeldet.
-
In Ihren Apps können Sie die grundlegenden Profilinformationen des Nutzers aus dem
firebase::auth::User-Objekt abrufen: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(); }
In den Firebase Realtime Database und Cloud Storage Sicherheitsregeln können Sie die eindeutige Nutzer-ID des angemeldeten Nutzers aus der Variablen
authabrufen und damit steuern, auf welche Daten ein Nutzer zugreifen kann.
Sie können Nutzern erlauben, sich mit mehreren Authentifizierungsanbietern in Ihrer App anzumelden, indem Sie Anmeldedaten von Authentifizierungsanbietern mit einem vorhandenen Nutzerkonto verknüpfen.
Rufen Sie
SignOut() auf, um einen Nutzer abzumelden:
auth->SignOut();