Mit passwortbasierten Konten mit C++ bei Firebase authentifizieren

Sie können Firebase Authentication verwenden, damit sich Ihre Nutzer authentifizieren können mit Firebase verwendet seine E-Mail-Adressen und Passwörter sowie zur Verwaltung der passwortbasierte Konten.

Hinweis

1. Fügen Sie Ihrem C++-Projekt Firebase hinzu.
2. Wenn Sie Ihre App noch nicht mit Ihrem Firebase-Projekt verknüpft haben, tun Sie dies in der Firebase Console.
3. Anmeldung mit E-Mail-Adresse und Passwort aktivieren:
   1. Öffnen Sie in der Firebase-Konsole Bereich Auth
   2. Aktivieren Sie auf dem Tab Anmeldemethode die Anmeldung mit E-Mail-Adresse/Passwort. und klicken Sie auf Speichern.

Auf die Klasse firebase::auth::Auth zugreifen

Die Klasse Auth ist das Gateway für alle API-Aufrufe.

1. Fügen Sie die Auth- und App-Headerdateien hinzu:

   #include "firebase/app.h"
   #include "firebase/auth.h"
   

2. Erstellen Sie in Ihrem Initialisierungscode einen Klasse firebase::App.

   #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__)
   

3. Erwerben Sie die Klasse „firebase::auth::Auth“ für Ihr Gerät „firebase::App“. Es gibt eine 1:1-Zuordnung zwischen App und Auth.

   firebase::auth::Auth* auth = firebase::auth::Auth::GetAuth(app);
   

Passwortbasiertes Konto erstellen

Führen Sie die folgenden Schritte aus, um ein neues Nutzerkonto mit Passwort zu erstellen: den Anmeldecode Ihrer App an:

1. Wenn sich ein neuer Nutzer über das Anmeldeformular Ihrer App registriert, füllen Sie alle neuen Schritte zur Kontovalidierung, die Ihre App erfordert, z. B. die Überprüfung, Das Passwort des neuen Kontos wurde richtig eingegeben und entspricht Ihrer Komplexität Anforderungen.
2. Erstellen Sie ein neues Konto, indem Sie die E-Mail-Adresse und das Passwort des neuen Nutzers übergeben. an Auth::CreateUserWithEmailAndPassword:

   firebase::Future<firebase::auth::AuthResult> result =
       auth->CreateUserWithEmailAndPassword(email, password);
   

3. Wenn Ihr Programm eine Updateschleife hat, die regelmäßig ausgeführt wird (z. B. 30- oder 60-mal pro Sekunde), können Sie die Ergebnisse einmal pro Update mit Auth::CreateUserWithEmailAndPasswordLastResult prüfen:

   firebase::Future<firebase::auth::AuthResult> result =
       auth->CreateUserWithEmailAndPasswordLastResult();
   if (result.status() == firebase::kFutureStatusComplete) {
     if (result.error() == firebase::auth::kAuthErrorNone) {
       const firebase::auth::AuthResult auth_result = *result.result();
       printf("Create user succeeded for email %s\n",
              auth_result.user.email().c_str());
     } else {
       printf("Created user failed with error '%s'\n", result.error_message());
     }
   }
   

   Wenn Ihr Programm ereignisgesteuert ist, können Sie auch einen Callback für die Future registrieren.

Um Ihr Projekt vor Missbrauch zu schützen, begrenzt Firebase die Anzahl der neuen E-Mail-Adressen/Passwörter und anonymer Registrierungen, die für Ihre Anwendung über dieselbe IP-Adresse in kurzer Zeit möglich sind. Sie können über die Firebase Console vorübergehende Änderungen an diesem Kontingent anfordern und planen.

Nutzer mit E-Mail-Adresse und Passwort anmelden

Die Schritte zum Anmelden eines Nutzers mit einem Passwort ähneln denen für beim Erstellen eines neuen Kontos. Führen Sie in der Anmeldefunktion Ihrer App die folgenden Schritte aus:

1. Wenn sich ein Nutzer in Ihrer App anmeldet, geben Sie seine E-Mail-Adresse und Passwort zu firebase::auth::Auth::SignInWithEmailAndPassword:

   firebase::Future<firebase::auth::AuthResult> result =
       auth->SignInWithEmailAndPassword(email, password);
   

2. Wenn Ihr Programm über eine regelmäßig ausgeführte Aktualisierungsschleife verfügt (z. B. bei 30 oder 60 Mal pro Sekunde) können Sie die Ergebnisse einmal pro Aktualisierung mit Auth::SignInWithEmailAndPasswordLastResult:

   firebase::Future<firebase::auth::AuthResult> result =
       auth->SignInWithEmailAndPasswordLastResult();
   if (result.status() == firebase::kFutureStatusComplete) {
     if (result.error() == firebase::auth::kAuthErrorNone) {
       const firebase::auth::AuthResult auth_result = *result.result();
       printf("Sign in succeeded for email %s\n",
              auth_result.user.email().c_str());
     } else {
       printf("Sign in failed with error '%s'\n", result.error_message());
     }
   }
   

   Wenn Ihr Programm ereignisgesteuert ist, einen Callback auf der Future

Callback für ein Future registrieren

Einige Programme haben Update-Funktionen, die 30- oder 60-mal pro Sekunde aufgerufen werden. So folgen beispielsweise viele Spiele diesem Modell. Diese Programme können die LastResult aufrufen um asynchrone Aufrufe abzufragen. Ist Ihr Programm jedoch ereignisgesteuert, möchten Sie möglicherweise Callback-Funktionen registrieren. Nach Abschluss des Futures wird eine Callback-Funktion 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);
}

Die Rückruffunktion kann auch eine Lambda-Funktion sein.

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);
}

Empfohlen: Schutz vor E-Mail-Enumeration aktivieren

Einige Firebase Authentication-Methoden, die E-Mail-Adressen als Parameter annehmen Fehler, wenn die E-Mail-Adresse nicht registriert ist, wenn sie registriert werden muss (z. B. bei der Anmeldung mit einer E-Mail-Adresse und einem Passwort) oder registrierte Wenn sie nicht verwendet werden muss (z. B. beim Ändern der E-Mail-Adresse eines Nutzers). Dies kann hilfreich sein, um Nutzern spezifische Abhilfemaßnahmen zu empfehlen, von böswilligen Akteuren missbraucht werden, um die von Ihrem Nutzenden.

Wir empfehlen, den Schutz vor E-Mail-Enumeration zu aktivieren, um dieses Risiko zu mindern. für Ihr Projekt mit dem gcloud-Tool von Google Cloud erstellen. Wenn Sie diese Option aktivieren, Durch diese Funktion ändert sich das Verhalten der Fehlerberichte von Firebase Authentication – achte darauf, dass deine App nicht auf die spezifischeren Fehler.

Nächste Schritte

Nachdem sich ein Nutzer zum ersten Mal angemeldet hat, wird ein neues Nutzerkonto erstellt und die mit den Anmeldedaten verknüpft sind, d. h. Nutzername und Passwort, oder Authentifizierungsanbieter-Informationen – also für den Nutzer, mit dem sich der Nutzer angemeldet hat. Diese neue -Konto wird als Teil Ihres Firebase-Projekts gespeichert und kann verwendet werden, um in jeder App in Ihrem Projekt einen Nutzer erreichen, unabhängig davon, wie er sich anmeldet.

• Die grundlegenden Profilinformationen der Nutzer finden Sie in Ihren Apps über die firebase::auth::User-Objekt:

  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 Firebase Realtime Database und Cloud Storage Sicherheitsregeln können Sie die eindeutige Nutzer-ID des angemeldeten Nutzers aus der Variablen auth abrufen, und steuern, auf welche Daten ein Nutzer zugreifen kann.

Sie können Nutzern erlauben, sich über mehrere Authentifizierungsanbieter in Ihrer App anzumelden, indem Sie Anmeldedaten des Authentifizierungsanbieters mit einem vorhandenen Nutzerkonto verknüpfen.

Rufen Sie auf, um einen Nutzer abzumelden. SignOut():

auth->SignOut();