Jeśli używasz Logowania przez Google w aplikacji lub witrynie, która komunikuje się z serwerem backendu, może być konieczne zidentyfikowanie na serwerze aktualnie zalogowanego użytkownika. Aby zrobić to bezpiecznie, po pomyślnym zalogowaniu się użytkownika wyślij token identyfikacji użytkownika na serwer, używając protokołu HTTPS. Następnie na serwerze sprawdź integralność tokena identyfikacji i użyj zawartych w nim informacji o użytkowniku, aby utworzyć sesję lub nowe konto.
Wysyłanie tokena identyfikacji na serwer
Gdy użytkownik się zaloguje, pobierz jego token identyfikacji:
Swift
GIDSignIn.sharedInstance.signIn(withPresenting: self) { signInResult, error in guard error == nil else { return } guard let signInResult = signInResult else { return } signInResult.user.refreshTokensIfNeeded { user, error in guard error == nil else { return } guard let user = user else { return } let idToken = user.idToken // Send ID token to backend (example below). } }
Objective-C
[GIDSignIn.sharedInstance signInWithPresentingViewController:self completion:^(GIDSignInResult * _Nullable signInResult, NSError * _Nullable error) { if (error) { return; } if (signInResult == nil) { return; } [signInResult.user refreshTokensIfNeededWithCompletion:^(GIDGoogleUser * _Nullable user, NSError * _Nullable error) { if (error) { return; } if (user == nil) { return; } NSString *idToken = user.idToken; // Send ID token to backend (example below). }]; }];
Następnie wyślij token identyfikacji na serwer za pomocą żądania HTTPS POST:
Swift
func tokenSignInExample(idToken: String) { guard let authData = try? JSONEncoder().encode(["idToken": idToken]) else { return } let url = URL(string: "https://yourbackend.example.com/tokensignin")! var request = URLRequest(url: url) request.httpMethod = "POST" request.setValue("application/json", forHTTPHeaderField: "Content-Type") let task = URLSession.shared.uploadTask(with: request, from: authData) { data, response, error in // Handle response from your backend. } task.resume() }
Objective-C
NSString *signinEndpoint = @"https://yourbackend.example.com/tokensignin"; NSDictionary *params = @{@"idtoken": idToken}; NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:signinEndpoint]; [request setValue:@"application/x-www-form-urlencoded" forHTTPHeaderField:@"Content-Type"]; [request setHTTPMethod:@"POST"]; [request setHTTPBody:[self httpBodyForParamsDictionary:params]]; NSOperationQueue *queue = [[NSOperationQueue alloc] init]; [NSURLConnection sendAsynchronousRequest:request queue:queue completionHandler:^(NSURLResponse *response, NSData *data, NSError *error) { if (error) { NSLog(@"Error: %@", error.localizedDescription); } else { NSLog(@"Signed in as %@", data.bytes); } }];
Weryfikowanie integralności tokena identyfikacji
Po otrzymaniu tokena identyfikacji przez HTTPS POST musisz sprawdzić jego integralność.
Aby sprawdzić, czy token jest prawidłowy, upewnij się, że spełnia te kryteria:
- Token identyfikacji jest prawidłowo podpisany przez Google. Użyj kluczy publicznych Google (dostępnych w formacie JWK lub PEM), aby zweryfikować podpis tokena. Te klucze są regularnie zmieniane. Sprawdź nagłówek
Cache-Controlw odpowiedzi, aby określić, kiedy należy je ponownie pobrać. - Wartość
audw tokenie identyfikatora jest równa jednemu z identyfikatorów klienta Twojej aplikacji. Jest to konieczne, aby zapobiec używaniu tokenów identyfikatora wydanych złośliwej aplikacji do uzyskiwania dostępu do danych o tym samym użytkowniku na serwerze backendu aplikacji. - Wartość
issw tokenie identyfikatora jest równaaccounts.google.comlubhttps://accounts.google.com. - Czas wygaśnięcia tokena identyfikacyjnego (
exp) jeszcze nie upłynął. - Jeśli musisz sprawdzić, czy token identyfikatora reprezentuje konto organizacji Google Workspace lub Cloud, możesz sprawdzić roszczenie
hd, które wskazuje hostowaną domenę użytkownika. Należy go używać, gdy chcesz ograniczyć dostęp do zasobu tylko do członków określonych domen. Brak tego roszczenia oznacza, że konto nie należy do domeny hostowanej przez Google.
Korzystając z pól email, email_verified i hd, możesz sprawdzić, czy Google hostuje adres e-mail i czy jest dla niego autorytatywny. W przypadkach, w których Google ma wiarygodne informacje, użytkownik jest uznawany za prawowitego właściciela konta i możesz pominąć hasło lub inne metody weryfikacji.
Sytuacje, w których Google jest miarodajne:
emailma sufiks@gmail.com, jest to konto Gmail.email_verifiedjest prawdziwe ihdjest ustawione, jest to konto Google Workspace.
Użytkownicy mogą rejestrować konta Google bez używania Gmaila ani Google Workspace. Gdy email nie zawiera sufiksu @gmail.com i nie ma parametru hd, Google nie jest autorytatywny i zaleca się użycie hasła lub innych metod weryfikacji użytkownika. email_verified może być też prawdziwe, ponieważ Google początkowo zweryfikowało użytkownika podczas tworzenia konta Google, ale od tego czasu własność konta e-mail w usłudze innej firmy mogła ulec zmianie.
Zamiast pisać własny kod do wykonywania tych kroków weryfikacji, zdecydowanie zalecamy używanie biblioteki klienta interfejsu Google API dla Twojej platformy lub ogólnej biblioteki JWT. Na potrzeby programowania i debugowania możesz wywołać nasz tokeninfopunkt końcowy weryfikacji.
Korzystanie z biblioteki klienta interfejsów API Google
Używanie jednej z bibliotek klienta interfejsów API Google (np. Java Node.js, PHP, Pythona) to zalecany sposób weryfikacji tokenów tożsamości Google w środowisku produkcyjnym.
Aby zweryfikować token identyfikatora w Javie, skorzystaj z GoogleIdTokenVerifier. Na przykład:
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."); }
Metoda GoogleIdTokenVerifier.verify() weryfikuje token JWT
podpis, twierdzenie aud, roszczenie iss oraz
Roszczenie exp.
Jeśli chcesz sprawdzić, czy token identyfikatora reprezentuje Google Workspace lub Cloud
konta organizacji, możesz zweryfikować własność domeny hd, sprawdzając nazwę domeny
zwracanymi przez metodę Payload.getHostedDomain(). Domena
Roszczenie dotyczące email nie wystarcza do zapewnienia, że konto jest zarządzane przez domenę
lub organizacji.
Aby sprawdzić token identyfikatora w Node.js, użyj biblioteki uwierzytelniania Google dla Node.js. Zainstaluj bibliotekę:
npm install google-auth-library --save
verifyIdToken(). Na przykład:
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);
Funkcja verifyIdToken weryfikuje
podpis JWT, deklaracja aud, deklaracja exp,
i roszczenie iss.
Jeśli chcesz sprawdzić, czy token identyfikatora reprezentuje Google Workspace lub Cloud
konta organizacji, możesz sprawdzić twierdzenie hd, które wskazuje,
w domenie użytkownika. Tej opcji należy używać, gdy dostęp do zasobu mają tylko użytkownicy
i konkretnych domen. Brak tego roszczenia oznacza, że konto nie należy do:
jest domeną hostowaną przez Google.
Aby sprawdzić token identyfikatora w języku PHP, użyj biblioteki klienta interfejsów API Google dla języka PHP. Zainstaluj bibliotekę (np. za pomocą narzędzia Composer):
composer require google/apiclient
verifyIdToken(). Na przykład:
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 }
Funkcja verifyIdToken weryfikuje
podpis JWT, deklaracja aud, deklaracja exp,
i roszczenie iss.
Jeśli chcesz sprawdzić, czy token identyfikatora reprezentuje Google Workspace lub Cloud
konta organizacji, możesz sprawdzić twierdzenie hd, które wskazuje,
w domenie użytkownika. Tej opcji należy używać, gdy dostęp do zasobu mają tylko użytkownicy
i konkretnych domen. Brak tego roszczenia oznacza, że konto nie należy do:
jest domeną hostowaną przez Google.
Aby sprawdzić token tożsamości w Pythonie, użyj instrukcji verify_oauth2_token . Na przykład:
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
Funkcja verify_oauth2_token weryfikuje token JWT
podpis, roszczenie aud i roszczenie exp.
Musisz też zweryfikować hd
roszczenia (jeśli dotyczy) przez sprawdzenie obiektu, który
verify_oauth2_token zwraca. Jeśli wielu klientów ma dostęp do
serwera backendu, ręcznie zweryfikuj również deklarację aud.
Wywoływanie punktu końcowego tokeninfo
Prostym sposobem na sprawdzenie poprawności podpisu tokena identyfikacji na potrzeby debugowania jest użycie punktu końcowego tokeninfo. Wywołanie tego punktu końcowego wiąże się z dodatkowym żądaniem sieciowym, które wykonuje większość weryfikacji za Ciebie, podczas gdy Ty testujesz prawidłową weryfikację i wyodrębnianie ładunku we własnym kodzie. Nie nadaje się do użycia w kodzie produkcyjnym, ponieważ żądania mogą być ograniczane lub mogą występować błędy.
Aby zweryfikować token identyfikacji za pomocą punktu końcowego tokeninfo, wyślij do niego żądanie HTTPS POST lub żądanie GET i przekaż token identyfikacji w parametrze id_token.
Aby na przykład zweryfikować token „XYZ123”, wyślij to żądanie GET:
https://oauth2.googleapis.com/tokeninfo?id_token=XYZ123
Jeśli token jest prawidłowo podpisany, a oświadczenia iss i exp mają oczekiwane wartości, otrzymasz odpowiedź HTTP 200, której treść zawiera oświadczenia tokena identyfikacji w formacie JSON.
Oto przykładowa odpowiedź:
{
// 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"
}Jeśli chcesz sprawdzić, czy token identyfikacji reprezentuje konto Google Workspace, możesz sprawdzić deklarację hd, która wskazuje hostowaną domenę użytkownika. Należy go używać, gdy dostęp do zasobu jest ograniczony tylko do użytkowników z określonych domen. Brak tego oświadczenia wskazuje, że konto nie należy do domeny hostowanej w Google Workspace.
Tworzenie konta lub sesji
Po zweryfikowaniu tokena sprawdź, czy użytkownik jest już w Twojej bazie danych użytkowników. Jeśli tak, utwórz uwierzytelnioną sesję dla użytkownika. Jeśli użytkownika nie ma jeszcze w Twojej bazie danych, utwórz nowy rekord użytkownika na podstawie informacji z ładunku tokena identyfikacji i rozpocznij sesję dla użytkownika. Gdy wykryjesz nowo utworzonego użytkownika w aplikacji, możesz poprosić go o podanie dodatkowych informacji o profilu.
Zabezpieczanie kont użytkowników za pomocą ochrony wszystkich kont
Gdy korzystasz z Google do logowania użytkownika, automatycznie korzystasz ze wszystkich funkcji zabezpieczeń i infrastruktury, które Google stworzyło, aby chronić dane użytkownika. Jednak w mało prawdopodobnym przypadku, gdy konto Google użytkownika zostanie przejęte lub wystąpi inne poważne zdarzenie związane z bezpieczeństwem, Twoja aplikacja może być narażona na atak. Aby lepiej chronić swoje konta przed poważnymi zdarzeniami związanymi z bezpieczeństwem, użyj Ochrony wszystkich kont, aby otrzymywać alerty bezpieczeństwa od Google. Gdy otrzymasz te zdarzenia, uzyskasz wgląd w ważne zmiany w zabezpieczeniach konta Google użytkownika i będziesz mieć możliwość podjęcia działań w swojej usłudze, aby zabezpieczyć konta.