Google is committed to advancing racial equity for Black communities. See how.
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Authentifizieren Sie sich mit Google Sign-In mit JavaScript

Sie können Ihre Benutzer mithilfe ihrer Google-Konten bei Firebase authentifizieren lassen, indem Sie Google Sign-In in Ihre App integrieren. Sie können Google Sign-In entweder mithilfe des Firebase SDK zum Ausführen des Anmeldeflusses oder durch manuelles Ausführen des Google Sign-In-Flusses und Übergeben des resultierenden ID-Tokens an Firebase integrieren.

Bevor Sie beginnen

  1. Fügen Sie Ihrem JavaScript-Projekt Firebase hinzu .
  2. Aktivieren Sie die Google-Anmeldung in der Firebase-Konsole:
    1. Öffnen Sie in der Firebase-Konsole den Abschnitt Auth .
    2. Auf dem Anmelden Methode Registerkarte, aktivieren Sie die Google-Anmeldemethode und klicken Sie auf Speichern.

Behandeln Sie den Anmeldefluss mit dem Firebase SDK

Wenn Sie eine Web-App erstellen, können Sie Ihre Benutzer am einfachsten mit ihren Google-Konten bei Firebase authentifizieren, indem Sie den Anmeldefluss mit dem Firebase-JavaScript-SDK verwalten. (Wenn Sie einen Benutzer in Node.js oder einer anderen Nicht-Browser-Umgebung authentifizieren möchten, müssen Sie den Anmeldefluss manuell verarbeiten.)

Gehen Sie folgendermaßen vor, um den Anmeldefluss mit dem Firebase JavaScript SDK zu verarbeiten:

  1. Erstellen Sie eine Instanz des Google-Provider-Objekts:
    var provider = new firebase.auth.GoogleAuthProvider();
    
  2. Optional : Geben Sie zusätzliche OAuth 2.0-Bereiche an, die Sie vom Authentifizierungsanbieter anfordern möchten. Rufen Sie addScope auf, um einen Bereich addScope . Beispielsweise:
    provider.addScope('https://www.googleapis.com/auth/contacts.readonly');
    
    Weitere Informationen finden Sie in der Dokumentation zum Authentifizierungsanbieter .
  3. Optional : Um den OAuth-Flow des Anbieters in der vom Benutzer bevorzugten Sprache zu lokalisieren, ohne die relevanten benutzerdefinierten OAuth-Parameter explizit zu übergeben, aktualisieren Sie den Sprachcode auf der Auth-Instanz, bevor Sie den OAuth-Flow starten. Beispielsweise:
    firebase.auth().languageCode = 'pt';
    // To apply the default browser preference instead of explicitly setting it.
    // firebase.auth().useDeviceLanguage();
    
  4. Optional : Geben Sie zusätzliche benutzerdefinierte OAuth-Anbieterparameter an, die Sie mit der OAuth-Anforderung senden möchten. Um einen benutzerdefinierten Parameter hinzuzufügen, rufen Sie setCustomParameters auf dem initialisierten Provider mit einem Objekt auf, das den in der OAuth-Providerdokumentation angegebenen Schlüssel und den entsprechenden Wert enthält. Beispielsweise:
    provider.setCustomParameters({
      'login_hint': 'user@example.com'
    });
    
    Reservierte erforderliche OAuth-Parameter sind nicht zulässig und werden ignoriert. Weitere Informationen finden Sie in der Referenz des Authentifizierungsanbieters .
  5. Authentifizieren Sie sich mit dem Google-Provider-Objekt bei Firebase. Sie können Ihre Nutzer auffordern, sich mit ihren Google-Konten anzumelden, indem Sie entweder ein Popup-Fenster öffnen oder zur Anmeldeseite umleiten. Die Umleitungsmethode wird auf Mobilgeräten bevorzugt.
    • Um sich mit einem Popup-Fenster signInWithPopup , rufen Sie signInWithPopup :
      firebase.auth().signInWithPopup(provider).then(function(result) {
        // This gives you a Google Access Token. You can use it to access the Google API.
        var token = result.credential.accessToken;
        // The signed-in user info.
        var user = result.user;
        // ...
      }).catch(function(error) {
        // Handle Errors here.
        var errorCode = error.code;
        var errorMessage = error.message;
        // The email of the user's account used.
        var email = error.email;
        // The firebase.auth.AuthCredential type that was used.
        var credential = error.credential;
        // ...
      });
      
      Beachten Sie auch, dass Sie das OAuth-Token des Google-Anbieters abrufen können, mit dem Sie mithilfe der Google-APIs zusätzliche Daten abrufen können.

      Hier können Sie auch Fehler abfangen und behandeln. Eine Liste der Fehlercodes finden Sie in den Auth-Referenzdokumenten .

    • Rufen Sie signInWithRedirect , um sich signInWithRedirect indem Sie zur signInWithRedirect :
      firebase.auth().signInWithRedirect(provider);
      
      Anschließend können Sie auch das OAuth-Token des Google-Anbieters getRedirectResult indem Sie getRedirectResult aufrufen, wenn Ihre Seite getRedirectResult :
      firebase.auth().getRedirectResult().then(function(result) {
        if (result.credential) {
          // This gives you a Google Access Token. You can use it to access the Google API.
          var token = result.credential.accessToken;
          // ...
        }
        // The signed-in user info.
        var user = result.user;
      }).catch(function(error) {
        // Handle Errors here.
        var errorCode = error.code;
        var errorMessage = error.message;
        // The email of the user's account used.
        var email = error.email;
        // The firebase.auth.AuthCredential type that was used.
        var credential = error.credential;
        // ...
      });
      
      Hier können Sie auch Fehler abfangen und behandeln. Eine Liste der Fehlercodes finden Sie in den Auth-Referenzdokumenten .

Authentifizieren Sie sich mit Firebase in einer Chrome-Erweiterung

Wenn Sie eine Chrome-Erweiterungs-App erstellen, müssen Sie Ihre Chrome-Erweiterungs-ID auf die Whitelist setzen:

  1. Öffnen Sie Ihr Projekt in der Firebase-Konsole .
  2. Im Abschnitt Authentifizierung, öffnen Sie das Anmelde-Verfahren Seite.
  3. Fügen Sie der Liste der autorisierten Domänen einen URI wie den folgenden hinzu:
    chrome-extension:// CHROME_EXTENSION_ID 

Für Chrome-Erweiterungen stehen nur Popup-Vorgänge ( signInWithPopup und linkWithPopup ) zur Verfügung, da Chrome-Erweiterungen keine HTTP-Weiterleitungen verwenden können. Sie sollten diese Methoden über ein Hintergrundskript und nicht über ein Browser-Aktions-Popup aufrufen, da das Authentifizierungs-Popup das Browser-Aktions-Popup abbricht.

Stellen Sie in der Manifestdatei Ihrer Chrome-Erweiterung sicher, dass Sie die URL https://apis.google.com zur Whitelist content_security_policy hinzufügen.

Nächste Schritte

Nachdem sich ein Benutzer zum ersten Mal angemeldet hat, wird ein neues Benutzerkonto erstellt und mit den Anmeldeinformationen verknüpft, dh dem Benutzernamen und dem Kennwort, der Telefonnummer oder den Informationen zum Authentifizierungsanbieter, mit denen sich der Benutzer angemeldet hat. Dieses neue Konto wird als Teil Ihres Firebase-Projekts gespeichert und kann verwendet werden, um einen Benutzer in jeder App in Ihrem Projekt zu identifizieren, unabhängig davon, wie sich der Benutzer anmeldet.

  • In Ihren Apps wird empfohlen, den Authentifizierungsstatus Ihres Benutzers zu ermitteln, indem Sie einen Beobachter für das Auth Objekt festlegen. Sie können dann die grundlegenden Profilinformationen des User aus dem User abrufen. Siehe Benutzer verwalten .

  • In Ihren Sicherheitsregeln für Firebase-Echtzeitdatenbanken und Cloud-Speicher können Sie die eindeutige Benutzer-ID des angemeldeten Benutzers aus der auth und damit steuern, auf welche Daten ein Benutzer zugreifen kann.

Sie können Benutzern erlauben, sich mit mehreren Authentifizierungsanbietern bei Ihrer App anzumelden, indem Sie die Anmeldeinformationen des Authentifizierungsanbieters mit einem vorhandenen Benutzerkonto verknüpfen.

Um einen Benutzer signOut , rufen Sie signOut :

firebase.auth().signOut().then(function() {
  // Sign-out successful.
}).catch(function(error) {
  // An error happened.
});