Von Google Log-in migrieren

Dieser Leitfaden hilft Ihnen, die notwendigen Änderungen und Schritte zu verstehen, die JavaScript-Bibliotheken aus dem vorherigen Google Log-in Plattformbibliothek auf die neuere Google Identity Services-Bibliothek für Authentifizierung.

Wenn Ihr Client die Google API-Clientbibliothek für JavaScript oder andere Frühere Bibliotheken für die Autorisierung finden Sie unter Zu Google Identity migrieren Services.

Authentifizierung und Autorisierung

Bei der Authentifizierung wird festgestellt, wer eine Person ist. Diese Authentifizierung wird gemeinhin als zur Registrierung oder Anmeldung eines Nutzers. Autorisierung ist der Vorgang, bei dem ein dem Ablehnen des Zugriffs auf Daten oder Ressourcen. Beispiel: Ihre App fordert Zustimmung des Nutzers für den Zugriff auf Google Drive.

Wie bei der Bibliothek der Google Log-in-Plattform wird auch das neue Google Identity-Konto Dienstebibliothek wurde für die Authentifizierung und Autorisierung entwickelt. Prozesse.

In der neueren Bibliothek werden die beiden Prozesse jedoch voneinander getrennt, um die Komplexität zu verringern. damit Entwickler Google-Konten in Ihre App integrieren können.

Wenn Ihr Anwendungsfall nur die Authentifizierung betrifft, lesen Sie diese Seite.

Wenn Ihr Anwendungsfall eine Autorisierung umfasst, lesen Sie den Artikel Funktionsweise der Nutzerautorisierung. und Migration zu Google Identity Services, um sicherzustellen, dass Ihre Anwendung mit den neuen und verbesserten APIs.

Änderungen

Für Nutzer bietet die neue Google Identity Services-Bibliothek zahlreiche Usability-Tests. Zu den Highlights gehören:

• Neue, unkomplizierte One Tap- und automatische Anmeldungen mit weniger individuellen Nutzern Schritte,
• eine aktualisierte Anmeldeschaltfläche mit Nutzerpersonalisierung,
• Ein einheitliches Branding und ein einheitliches Anmeldeverhalten im Web verbessern Verständnis und Vertrauen
• schnell zu den Inhalten gelangen, können Nutzer sich von überall aus auf Ihrer Website, ohne dass Sie zuerst eine Anmelde- oder Kontoseite aufrufen müssen.

Für Entwickler war es unser Ziel, die Komplexität zu reduzieren, die Sicherheit zu verbessern um Ihre Integration so schnell wie möglich zu gestalten. Zu diesen Verbesserungen gehören:

• Die Option, dem statischen Content Ihrer Website Nutzeranmeldungen hinzuzufügen, HTML,
• Trennung der Anmeldeauthentifizierung von der Autorisierung und der gemeinsamen Nutzung Nutzerdaten ist die Komplexität einer OAuth 2.0-Integration nicht mehr notwendig. um Nutzer auf Ihrer Website anzumelden,
• Pop-up- und Weiterleitungsmodi werden weiterhin unterstützt, 2.0-Infrastruktur leitet jetzt zum Anmeldeendpunkt Ihres Back-End-Servers weiter,
• die Konsolidierung der Funktionen der beiden früheren Google Identity- Google API-JavaScript-Bibliotheken in einer einzigen neuen Bibliothek,
• können Sie jetzt selbst entscheiden, ob Sie ein Für Promise und Indirection durch Getter-Stilfunktionen der Einfachheit halber entfernt wurde.

Beispiel für die Migration der Anmeldung

Wenn Sie von der vorhandenen Google Log-in-Schaltfläche migrieren und nur Nutzer auf Ihrer Website anmelden möchten, ist die einfachste Änderung um auf die neue personalisierte Schaltfläche zu aktualisieren. Dies erreichen Sie, indem Sie JavaScript-Bibliotheken und -Codebasis zur Verwendung eines neuen Anmeldeobjekts aktualisieren.

Bibliotheken und Konfiguration

Die frühere Google Log-in-Plattformbibliothek: apis.google.com/js/platform.js, und Google API-Clientbibliothek für JavaScript gapi.client, sind keine für die Nutzerauthentifizierung und -autorisierung erforderlich. Sie wurden durch eine einzige neue JavaScript-Bibliothek von Google Identity Services ersetzt: accounts.google.com/gsi/client

Die früheren drei JavaScript-Module api, client und platform, die für Anmeldeinformationen wurden alle von apis.google.com geladen. Um Ihnen die Standortermittlung zu erleichtern wo die ältere Bibliothek in Ihre Website aufgenommen werden könnte. Dies ist normalerweise Folgendes der Fall:

• lädt die Standard-Anmeldeschaltfläche apis.google.com/js/platform.js,
• eine benutzerdefinierte Schaltflächengrafik lädt apis.google.com/js/api:client.js und
• direkte Nutzung von gapi.client lädt apis.google.com/js/api.js.

In den meisten Fällen können Sie die vorhandene Client-ID Ihrer Webanwendung verwenden. Anmeldedaten. Wir empfehlen Ihnen, im Rahmen der Migration unsere OAuth 2.0-Richtlinien und die Google API Console verwenden um die folgenden Clienteinstellungen zu bestätigen und gegebenenfalls zu aktualisieren:

• Ihre Test- und Produktions-Apps verwenden separate Projekte und haben eigene Client-IDs
• ist der OAuth 2.0-Client-ID-Typ „Webanwendung“ und
• HTTPS wird für autorisierte JavaScript-Quellen und Weiterleitungs-URIs verwendet.

Betroffenen Code identifizieren und testen

Ein Debug-Cookie kann dabei helfen, betroffenen Code zu finden und nach der Einstellung zu testen. verhalten.

Bei großen oder komplexen Anwendungen kann es schwierig sein, den gesamten Code zu finden, der vom Einstellung des Moduls gapi.auth2. Bestehende Nutzung von wird demnächst als protokolliert nicht mehr unterstützte Funktionen, legen Sie den Wert von G_AUTH2_MIGRATION fest. Cookie auf informational. Fügen Sie optional einen Doppelpunkt gefolgt von einem Schlüsselwert hinzu, auch im Sitzungsspeicher eintragen. Nach der Anmeldung und Erhalt von Anmeldedaten überprüfen oder erfasste Logs zur späteren Analyse an ein Back-End senden. Für Beispiel: informational:showauth2use speichert Ursprung und URL in einem Sitzungsspeicher Schlüssel mit dem Namen showauth2use.

Um das Verhalten der App zu prüfen, wenn das Modul gapi.auth2 nicht mehr geladen ist, lege den Parameter des G_AUTH2_MIGRATION-Cookies auf enforced gesetzt. Dies ermöglicht das Testen von nach der Einstellung vor dem Datum der Erzwingung.

Mögliche G_AUTH2_MIGRATION-Cookie-Werte:

• enforced Modul gapi.auth2 wird nicht geladen.
• informational Protokolliert die Nutzung eingestellter Funktionen in der JS-Konsole. Auch protokollieren an den Sitzungsspeicher, wenn ein optionaler Schlüsselname festgelegt wird: informational:key-name

Um die Auswirkungen auf die Nutzer zu minimieren, wird empfohlen, dieses Cookie zuerst lokal zu speichern in der Entwicklung und beim Testen vor dem Einsatz in Produktionsumgebungen.

HTML und JavaScript

In diesem Szenario, in der sich nur mit Authentifizierung anmelden, werden Beispielcode und Renderings die vorhandene Google Log-in-Schaltfläche angezeigt. „Pop-up“ oder „Weiterleitung“ auswählen Modus, um die Unterschiede bei der Verarbeitung der Authentifizierungsantwort zu sehen, entweder vom JavaScript-Callback oder sichere Weiterleitung zu deinem Backend-Server-Login Endpunkt.

Je früher

<html>
  <body>
    <script src="https://apis.google.com/js/platform.js" async defer></script>
    <meta name="google-signin-client_id" content="YOUR_CLIENT_ID">
    <div class="g-signin2" data-onsuccess="handleCredentialResponse"></div>
  </body>
</html>

<html>
  <body>
    <script src="https://apis.google.com/js/platform.js" async defer></script>
    <meta name="google-signin-client_id" content="YOUR_CLIENT_ID">
    <div class="g-signin2" data-onsuccess="handleCredentialResponse"></div>
    <script>
      function handleCredentialResponse(googleUser) {
        ...
        var xhr = new XMLHttpRequest();
        xhr.open('POST', 'https://yourbackend.example.com/tokensignin');
        xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
        xhr.onload = function() {
          console.log('Signed in as: ' + xhr.responseText);
        };
        xhr.send('idtoken=' + id_token);
      }
    </script>
  </body>
</html>

Die neue Art

Wählen Sie zur Verwendung der neuen Bibliothek in einer Anmeldung nur mit Authentifizierung die Option Pop-up- oder Weiterleitungsmodus aus und ersetzen Sie mithilfe des Codebeispiels bestehenden Implementierung auf Ihrer Anmeldeseite.

<html>
  <body>
    <script src="https://accounts.google.com/gsi/client" async defer></script>
    <div id="g_id_onload"
         data-client_id="YOUR_CLIENT_ID"
         data-callback="handleCredentialResponse">
    </div>
    <div class="g_id_signin" data-type="standard"></div>
  </body>
</html>

<html>
  <body>
    <script src="https://accounts.google.com/gsi/client" async defer></script>
    <div id="g_id_onload"
         data-client_id="YOUR_CLIENT_ID"
         data-ux_mode="redirect"
         data-login_uri="https://www.example.com/your_login_endpoint">
    </div>
    <div class="g_id_signin" data-type="standard"></div>
  </body>
</html>

In diesem Beispiel, das nur zur Authentifizierung dient, hat die neue accounts.google.com/gsi/client Bibliothek, g_id_signin-Klasse und g_id_onload-Objekt die vorherige apis.google.com/js/platform.js-Bibliothek und g-signin2-Objekt.

Der Beispielcode wurde nicht nur für die neue personalisierte Schaltfläche zeigt das neue One Tap-Pop-up an. Überall dort, wo Sie die personalisierte Schaltfläche sollten Sie unbedingt auch das One Tap-Pop-up einblenden, bei der Registrierung und Anmeldung.

Aufgrund von Problemen bei der Anmeldung wird die neue Version zwar nicht empfohlen, kann allein angezeigt werden, ohne gleichzeitig den Dialogfeld „One Tap“. Setzen Sie dazu das Attribut data-auto_prompt auf false.

HTML- und JavaScript-APIs

Das vorherige Beispiel zeigt, wie Sie mit der neuen HTML API Ihrer Website. Alternativ können Sie die funktional äquivalente JavaScript API verwenden oder HTML- und JavaScript-APIs in Ihren Website.

Um Optionen zum Anpassen von Schaltflächen wie den Callback-Typ und Attribute wie Farbe, Größe, Form, Text und Design, lesen Sie unseren Code Generator. Damit lassen sich schnell verschiedene Optionen vergleichen HTML-Snippets zur Verwendung auf Ihrer Website.

Mit One Tap von jeder Seite aus anmelden

One Tap ist eine neue, unkomplizierte Möglichkeit für Nutzer, sich auf Ihrer Website zu registrieren oder anzumelden. Nutzer können sich direkt von jeder Seite Ihrer Website aus anmelden und Nutzer müssen keine spezielle Anmeldeseite aufrufen. Anders ausgedrückt: Dadurch wird der Anmelde- und Anmeldevorgang vereinfacht, da Nutzer die Möglichkeit haben, die Registrierung und Anmeldung über andere Seiten als die Anmeldeseite aus.

Um die Anmeldung von jeder Seite aus zu ermöglichen, empfehlen wir, g_id_onload in eine gemeinsame Kopf-, Fußzeile oder ein anderes Objekt, das auf der gesamten Website verwendet wird.

Wir empfehlen außerdem, g_id_signin hinzuzufügen, wodurch die personalisierte Anmeldung angezeigt wird nur auf Ihren Anmelde- oder Benutzerkontenverwaltungsseiten. Nutzern Auswahlmöglichkeiten bieten um sich anzumelden, indem Sie die Schaltfläche neben anderen föderierten Schaltflächen für Identitätsanbieter sowie Felder für die Eingabe von Nutzername und Passwort.

Tokenantwort

Die Nutzeranmeldung erfordert keine Kenntnisse über OAuth 2.0 mehr. Autorisierungscodes, Zugriffstokens oder Aktualisierungstokens. Stattdessen ein JSON-Webtoken (JWT) ID-Token wird verwendet, um den Anmeldestatus und das Nutzerprofil freizugeben. Als vereinfacht werden, müssen Sie "Getter" nicht mehr verwenden, Stil Zugriffsmethoden für die Arbeit mit Nutzerprofildaten.

Sichere, von Google signierte JWT-ID-Token-Anmeldedaten werden entweder

• an den browserbasierten JavaScript-Callback-Handler des Nutzers im Pop-up-Modus gesendet werden oder
• über eine Google-Weiterleitung zu Ihrem Anmeldeendpunkt zu Ihrem Backend-Server, wenn Die Schaltfläche „Über Google anmelden“ ux_mode ist auf redirect festgelegt.

Aktualisieren Sie in beiden Fällen Ihre vorhandenen Callback-Handler, indem Sie Folgendes entfernen:

• googleUser.getBasicProfile()-Aufrufe
• Verweise auf BasicProfile und zugehörige Aufrufe von getId() getName(), getGivenName(), getFamilyName(), getImageUrl(), getEmail()-Methoden und
• Verwendung des AuthResponse-Objekts.

Verwende stattdessen direkte Verweise auf credential-Unterfelder im neuen JWT Objekt CredentialResponse für Nutzerprofildaten.

Verhindern Sie außerdem websiteübergreifende Anfragen, auch wenn Sie nur den Weiterleitungsmodus verwenden. Fälschung (CSRF) und überprüfen Sie das Google-ID-Token auf Ihrem Backend-Server.

Um besser zu verstehen, wie Nutzer mit Ihrer Website interagieren, Im Feld select_by in CredentialResponse kann der Nutzer bestimmt werden. das Einwilligungsergebnis und den verwendeten spezifischen Anmeldevorgang.

Nutzereinwilligung und Widerruf der Berechtigung

Wenn sich ein Nutzer zum ersten Mal auf Ihrer Website anmeldet, wird er von Google um seine Einwilligung gebeten. um ihr Kontoprofil mit Ihrer App zu teilen. Erst nach der Einwilligung wird Das für Ihre App freigegebene Nutzerprofil in der Anmeldedaten-Nutzlast mit einem ID-Token. Der Widerruf des Zugriffs auf dieses Profil entspricht dem Widerruf eines Zugriffstokens in der früheren Anmeldebibliothek.

Nutzer können Berechtigungen widerrufen und die Verknüpfung deiner App mit ihrem Google-Konto aufheben unter https://myaccount.google.com/permissions. Alternativ können sie die Verbindung zu Ihrer App direkt trennen, indem sie eine API auslösen den Sie implementieren. Die vorherige Methode disconnect wurde durch die neuere Methode revoke ersetzt.

Wenn Nutzer ihr Konto auf Ihrer Plattform löschen, revoke, um die Verknüpfung deiner App mit dem Google-Konto deines Kindes aufzuheben.

Bisher konnte auth2.signOut() verwendet werden, um die Abmeldung von Nutzern zu verwalten aus Ihrer App. Wenn du auth2.signOut() verwendest, solltest du sie entfernen und deine App Sitzungs- und Anmeldestatus auf Nutzerbasis direkt verwalten.

Sitzungsstatus und Listener

Die neue Bibliothek behält den Anmelde- oder Sitzungsstatus für Ihr Web nicht bei

Der Anmeldestatus eines Google-Kontos, der Sitzungsstatus und Anmeldestatus sind unterschiedliche, unterschiedliche Konzepte.

Der Anmeldestatus der Nutzer in ihrem Google-Konto und Ihrer App ist unabhängig außer bei der Anmeldung selbst, wenn Sie wissen, dass der Nutzer authentifiziert sein und im Google-Konto angemeldet sind.

Wenn „Über Google anmelden“, One Tap oder die automatische Anmeldung auf Ihrem Nutzer der Website müssen sich zuerst in ihrem Google-Konto anmelden, um

• der Weitergabe ihres Nutzerprofils bei der ersten Anmeldung oder sich auf Ihrer Website anmelden,
• und später für die Anmeldung bei wiederkehrenden Besuchen Ihrer Website.

Nutzer können angemeldet bleiben, sich abmelden oder zu einem anderen Google-Konto wechseln und gleichzeitig eine aktive Sitzung auf Ihrer Website stattfinden, in der Sie angemeldet sind.

Sie sind jetzt für die direkte Verwaltung des Anmeldestatus der Nutzer von Ihrer Webanwendung. Bisher hat Google Log-in beim Monitoring der Sitzungsstatus.

Entfernen Sie alle Verweise auf auth2.attachClickHandler() und die registrierten Callback-Handlern verwendet werden.

Bisher wurden Listener verwendet, um Änderungen des Anmeldestatus für eine das Google-Konto des Nutzers. Listener werden nicht mehr unterstützt.

Entfernen Sie alle Verweise auf listen(), auth2.currentUser und auth2.isSignedIn

Kekse

„Über Google anmelden“ verwendet Cookies in begrenztem Umfang, eine Beschreibung dieser Cookies folgt. Siehe Wie Google Cookies verwendet .

Das G_ENABLED_IDPS-Cookie, das von der früheren Google Log-in-Plattformbibliothek gesetzt wurde wird nicht mehr verwendet.

In der neuen Google Identity Services-Bibliothek können diese domainübergreifenden Cookies basierend auf Ihren Konfigurationsoptionen:

• g_state speichert den Abmeldestatus des Nutzers und wird bei Verwendung von One Tap festgelegt „Pop-up“ oder „Automatische Anmeldung“,

• g_csrf_token ist ein Double-Submit-Cookie, mit dem CSRF-Angriffe verhindert werden und wird beim Aufrufen Ihres Anmeldeendpunkts festgelegt. Wert für Ihren Anmelde-URI kann explizit festgelegt werden oder standardmäßig auf den URI der aktuellen Seite eingestellt werden. Ihr Anmeldeendpunkt kann unter folgenden Bedingungen aufgerufen werden, wenn Folgendes verwendet wird:

  • HTML API mit data-ux_mode=redirect oder wenn data-login_uri gleich festgelegt oder

  • JavaScript API mit ux_mode=redirect und wobei google.accounts.id.prompt() wird nicht verwendet, um One Tap oder Automatische Anmeldung

Wenn Sie einen Dienst haben, der Cookies verwaltet, müssen Sie die beiden neuen Cookies hinzufügen, und entfernen Sie das frühere Cookie, sobald die Migration abgeschlossen ist.

Falls Sie mehrere Domains oder Subdomains verwalten, lesen Sie One Tap auf Subdomains. Dort finden Sie weitere Anleitungen zum Arbeiten mit dem g_state Cookie.

Referenz zur Objektmigration für die Nutzeranmeldung