Wenn Sie Google Log-in für eine App oder Website verwenden, die mit einem Backend-Server kommuniziert, müssen Sie möglicherweise den aktuell angemeldeten Nutzer auf dem Server identifizieren. Sende dazu das ID-Token des Nutzers nach der erfolgreichen Anmeldung über HTTPS an deinen Server. Überprüfen Sie dann auf dem Server die Integrität des ID-Tokens und verwenden Sie die im Token enthaltenen Nutzerinformationen, um eine Sitzung einzurichten oder ein neues Konto zu erstellen.
ID-Token an Ihren Server senden
Nachdem sich ein Nutzer erfolgreich angemeldet hat, rufen Sie das ID-Token des Nutzers ab:
function onSignIn(googleUser) { var id_token = googleUser.getAuthResponse().id_token; ... }
Senden Sie das ID-Token dann mit einer HTTPS-POST-Anfrage an Ihren Server:
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);
Integrität des ID-Tokens prüfen
Nachdem Sie das ID-Token per HTTPS-POST erhalten haben, müssen Sie die Integrität des Tokens prüfen.
So prüfen Sie, ob das Token gültig ist:
- Das ID-Token ist von Google ordnungsgemäß signiert. Verwenden Sie die öffentlichen Schlüssel von Google (im JWK- oder PEM-Format), um die Signatur des Tokens zu prüfen. Diese Schlüssel werden regelmäßig rotiert. Sehen Sie sich den
Cache-Control-Header in der Antwort an, um zu ermitteln, wann Sie sie wieder abrufen sollten. - Der Wert von
audim ID-Token entspricht einer der Client-IDs Ihrer App. Diese Prüfung ist erforderlich, um zu verhindern, dass ID-Tokens, die für eine schädliche App ausgestellt wurden, für den Zugriff auf Daten desselben Nutzers auf dem Backend-Server Ihrer App verwendet werden. - Der Wert von
issim ID-Token entsprichtaccounts.google.comoderhttps://accounts.google.com. - Die Ablaufzeit (
exp) des ID-Tokens ist noch nicht erreicht. - Wenn Sie bestätigen müssen, dass das ID-Token ein Google Workspace- oder Cloud Identity-Organisationskonto darstellt, können Sie den Anspruch
hdprüfen, der die gehostete Domain des Nutzers angibt. Dies muss verwendet werden, wenn der Zugriff auf eine Ressource auf Mitglieder bestimmter Domains beschränkt wird. Wenn diese Behauptung fehlt, gehört das Konto nicht zu einer von Google gehosteten Domain.
Mithilfe der Felder email, email_verified und hd können Sie ermitteln, ob Google eine E-Mail-Adresse hostet und autoritativ für sie ist. In den Fällen, in denen Google maßgeblich ist, ist der Nutzer als rechtmäßiger Kontoinhaber bekannt und Sie können das Passwort oder andere Bestätigungsmethoden überspringen.
Fälle, in denen Google maßgebend ist:
- Wenn die E‑Mail-Adresse von
emailmit@gmail.comendet, handelt es sich um ein Gmail-Konto. - Wenn
email_verifiedwahr ist undhdfestgelegt ist, handelt es sich um ein Google Workspace-Konto.
Nutzer können sich für Google-Konten registrieren, ohne Gmail oder Google Workspace zu verwenden. Wenn email kein Suffix @gmail.com enthält und hd fehlt, ist Google nicht autoritativ und es wird empfohlen, das Passwort oder andere Challenge-Methoden zu verwenden, um den Nutzer zu bestätigen. email_verified kann auch zutreffen, da Google den Nutzer bei der Erstellung des Google-Kontos ursprünglich bestätigt hat. Die Inhaberschaft des E-Mail-Kontos des Drittanbieters kann sich jedoch inzwischen geändert haben.
Anstatt eigenen Code für diese Überprüfungsschritte zu schreiben, empfehlen wir dringend, eine Google API-Clientbibliothek für Ihre Plattform oder eine universelle JWT-Bibliothek zu verwenden. Für die Entwicklung und das Debugging können Sie unseren tokeninfo-Validierungsendpunkt aufrufen.
Google API-Clientbibliothek verwenden
Mit einer der Google API-Clientbibliotheken (z.B. Java Node.js PHP Python) wird empfohlen, um Google-ID-Tokens in einer Produktionsumgebung zu validieren.
<ph type="x-smartling-placeholder">Verwenden Sie zum Validieren eines ID-Tokens in Java die Methode GoogleIdTokenVerifier-Objekt. Beispiel:
import com.google.api.client.googleapis.auth.oauth2.GoogleIdToken; import com.google.api.client.googleapis.auth.oauth2.GoogleIdToken.Payload; import com.google.api.client.googleapis.auth.oauth2.GoogleIdTokenVerifier; ... GoogleIdTokenVerifier verifier = new GoogleIdTokenVerifier.Builder(transport, jsonFactory) // Specify the WEB_CLIENT_ID of the app that accesses the backend: .setAudience(Collections.singletonList(WEB_CLIENT_ID)) // Or, if multiple clients access the backend: //.setAudience(Arrays.asList(WEB_CLIENT_ID_1, WEB_CLIENT_ID_2, WEB_CLIENT_ID_3)) .build(); // (Receive idTokenString by HTTPS POST) GoogleIdToken idToken = verifier.verify(idTokenString); if (idToken != null) { Payload payload = idToken.getPayload(); // Print user identifier. This ID is unique to each Google Account, making it suitable for // use as a primary key during account lookup. Email is not a good choice because it can be // changed by the user. String userId = payload.getSubject(); System.out.println("User ID: " + userId); // Get profile information from payload String email = payload.getEmail(); boolean emailVerified = Boolean.valueOf(payload.getEmailVerified()); String name = (String) payload.get("name"); String pictureUrl = (String) payload.get("picture"); String locale = (String) payload.get("locale"); String familyName = (String) payload.get("family_name"); String givenName = (String) payload.get("given_name"); // Use or store profile information // ... } else { System.out.println("Invalid ID token."); }
Die Methode GoogleIdTokenVerifier.verify() prüft das JWT
Signatur, aud- und iss-Anforderung und
exp-Anspruch.
Wenn Sie prüfen müssen, ob das ID-Token für Google Workspace oder Cloud steht
Organisationskonto haben, können Sie die hd-Beanspruchung bestätigen, indem Sie den Domainnamen überprüfen
Payload.getHostedDomain() zurückgegeben. Die Domain der
Der Anspruch von email reicht nicht aus, um sicherzustellen, dass das Konto von einer Domain verwaltet wird
oder einer Organisation.
Verwenden Sie die Google-Authentifizierungsbibliothek für Node.js, um ein ID-Token in Node.js zu validieren. Installieren Sie die Bibliothek:
npm install google-auth-library --save
verifyIdToken() auf. Beispiel:
const {OAuth2Client} = require('google-auth-library'); const client = new OAuth2Client(); async function verify() { const ticket = await client.verifyIdToken({ idToken: token, audience: WEB_CLIENT_ID, // Specify the WEB_CLIENT_ID of the app that accesses the backend // Or, if multiple clients access the backend: //[WEB_CLIENT_ID_1, WEB_CLIENT_ID_2, WEB_CLIENT_ID_3] }); const payload = ticket.getPayload(); // This ID is unique to each Google Account, making it suitable for use as a primary key // during account lookup. Email is not a good choice because it can be changed by the user. const userid = payload['sub']; // If the request specified a Google Workspace domain: // const domain = payload['hd']; } verify().catch(console.error);
Mit der Funktion verifyIdToken wird überprüft,
die JWT-Signatur, die aud-Anforderung, die exp-Anforderung
und die iss-Behauptung.
Wenn Sie prüfen müssen, ob das ID-Token für Google Workspace oder Cloud steht
Unternehmenskonto haben, können Sie die hd-Anforderung prüfen, die angibt,
Domain des Nutzers. Muss verwendet werden, wenn der Zugriff auf eine Ressource auf Mitglieder beschränkt wird
von bestimmten Domains. Das Fehlen dieses Anspruchs bedeutet, dass das Konto nicht zu
eine von Google gehostete Domain.
Um ein ID-Token in PHP zu validieren, verwenden Sie die Google API-Clientbibliothek für PHP. Installieren Sie die Bibliothek (z. B. mit Composer):
composer require google/apiclient
verifyIdToken() auf. Beispiel:
require_once 'vendor/autoload.php'; // Get $id_token via HTTPS POST. $client = new Google_Client(['client_id' => $WEB_CLIENT_ID]); // Specify the WEB_CLIENT_ID of the app that accesses the backend $payload = $client->verifyIdToken($id_token); if ($payload) { // This ID is unique to each Google Account, making it suitable for use as a primary key // during account lookup. Email is not a good choice because it can be changed by the user. $userid = $payload['sub']; // If the request specified a Google Workspace domain //$domain = $payload['hd']; } else { // Invalid ID token }
Mit der Funktion verifyIdToken wird überprüft,
die JWT-Signatur, die aud-Anforderung, die exp-Anforderung
und die iss-Behauptung.
Wenn Sie prüfen müssen, ob das ID-Token für Google Workspace oder Cloud steht
Unternehmenskonto haben, können Sie die hd-Anforderung überprüfen, die angibt,
Domain des Nutzers. Muss verwendet werden, wenn der Zugriff auf eine Ressource auf Mitglieder beschränkt wird
bestimmter Domains. Das Fehlen dieses Anspruchs bedeutet, dass das Konto nicht zu
eine von Google gehostete Domain.
Verwenden Sie zum Validieren eines ID-Tokens in Python die Methode verify_oauth2_token . Beispiel:
from google.oauth2 import id_token from google.auth.transport import requests # (Receive token by HTTPS POST) # ... try: # Specify the WEB_CLIENT_ID of the app that accesses the backend: idinfo = id_token.verify_oauth2_token(token, requests.Request(), WEB_CLIENT_ID) # Or, if multiple clients access the backend server: # idinfo = id_token.verify_oauth2_token(token, requests.Request()) # if idinfo['aud'] not in [WEB_CLIENT_ID_1, WEB_CLIENT_ID_2, WEB_CLIENT_ID_3]: # raise ValueError('Could not verify audience.') # If the request specified a Google Workspace domain # if idinfo['hd'] != DOMAIN_NAME: # raise ValueError('Wrong domain name.') # ID token is valid. Get the user's Google Account ID from the decoded token. # This ID is unique to each Google Account, making it suitable for use as a primary key # during account lookup. Email is not a good choice because it can be changed by the user. userid = idinfo['sub'] except ValueError: # Invalid token pass
Die Funktion verify_oauth2_token prüft das JWT
Signatur, aud und exp.
Sie müssen auch die hd bestätigen
(falls zutreffend), indem wir das Objekt untersuchen,
verify_oauth2_token kehrt zurück. Wenn mehrere Clients auf die
Backend-Server, auch die aud-Anforderung manuell verifizieren.
Tokeninfo-Endpunkt aufrufen
Eine einfache Möglichkeit, eine ID-Token-Signatur für das Debugging zu validieren, ist die Verwendung des Endpunkts tokeninfo. Der Aufruf dieses Endpunkts beinhaltet eine zusätzliche Netzwerkanfrage, die den Großteil der Validierung für Sie übernimmt, während Sie die korrekte Validierung und Nutzlast-Extraktion in Ihrem eigenen Code testen. Sie ist nicht für die Verwendung in Produktionscode geeignet, da Anfragen gedrosselt werden können oder anderen vorübergehenden Fehlern unterliegen können.
Wenn Sie ein ID-Token mit dem Endpunkt tokeninfo validieren möchten, senden Sie eine HTTPS-POST- oder GET-Anfrage an den Endpunkt und übergeben Sie Ihr ID-Token im Parameter id_token.
Wenn Sie beispielsweise das Token „XYZ123“ validieren möchten, stellen Sie die folgende GET-Anfrage:
https://oauth2.googleapis.com/tokeninfo?id_token=XYZ123
Wenn das Token ordnungsgemäß signiert ist und die Anforderungen iss und exp die erwarteten Werte haben, erhalten Sie eine HTTP-200-Antwort, deren Text die JSON-formatierten ID-Token-Anforderungen enthält.
Sie sehen hier ein Beispiel:
{
// These six fields are included in all Google ID Tokens.
"iss": "https://accounts.google.com",
"sub": "110169484474386276334",
"azp": "1008719970978-hb24n2dstb40o45d4feuo2ukqmcc6381.apps.googleusercontent.com",
"aud": "1008719970978-hb24n2dstb40o45d4feuo2ukqmcc6381.apps.googleusercontent.com",
"iat": "1433978353",
"exp": "1433981953",
// These seven fields are only included when the user has granted the "profile" and
// "email" OAuth scopes to the application.
"email": "testuser@gmail.com",
"email_verified": "true",
"name" : "Test User",
"picture": "https://lh4.googleusercontent.com/-kYgzyAWpZzJ/ABCDEFGHI/AAAJKLMNOP/tIXL9Ir44LE/s99-c/photo.jpg",
"given_name": "Test",
"family_name": "User",
"locale": "en"
}Wenn Sie prüfen möchten, ob das ID-Token ein Google Workspace-Konto darstellt, können Sie die hd-Anforderung prüfen, die die gehostete Domain des Nutzers angibt. Dies muss verwendet werden, wenn der Zugriff auf eine Ressource nur auf Mitglieder bestimmter Domains beschränkt werden soll. Das Fehlen dieser Anforderung zeigt an, dass das Konto nicht zu einer von Google Workspace gehosteten Domain gehört.
Konto oder Sitzung erstellen
Nachdem Sie das Token verifiziert haben, prüfen Sie, ob der Nutzer bereits in Ihrer Nutzerdatenbank vorhanden ist. Wenn ja, richten Sie eine authentifizierte Sitzung für den Nutzer ein. Wenn der Nutzer noch nicht in Ihrer Nutzerdatenbank vorhanden ist, erstellen Sie einen neuen Nutzereintrag aus den Informationen in der ID-Token-Nutzlast und richten Sie eine Sitzung für den Nutzer ein. Wenn du einen neu erstellten Nutzer in deiner App erkennst, kannst du ihn auffordern, zusätzliche Profilinformationen anzugeben.
Nutzerkonten mit dem produktübergreifenden Kontoschutz schützen
Wenn Sie Google für die Anmeldung eines Nutzers verwenden, profitieren Sie automatisch von allen Sicherheitsfunktionen und der Infrastruktur, die Google zum Schutz der Nutzerdaten entwickelt hat. In dem unwahrscheinlichen Fall, dass das Google-Konto des Nutzers gehackt wird oder ein anderes schwerwiegendes Sicherheitsereignis eintritt, kann Ihre App jedoch auch anfällig für Angriffe sein. Wenn Sie Ihre Konten besser vor größeren Sicherheitsvorfällen schützen möchten, können Sie den produktübergreifenden Kontoschutz verwenden, um Sicherheitswarnungen von Google zu erhalten. Wenn Sie diese Ereignisse erhalten, erhalten Sie Einblick in wichtige Änderungen an der Sicherheit des Google-Kontos des Nutzers und können dann Maßnahmen in Ihrem Dienst ergreifen, um Ihre Konten zu schützen.