Google ile Oturum Açma özelliğini, arka uç sunucusuyla iletişim kuran bir uygulama veya siteyle kullanıyorsanız sunucuda o anda oturum açmış olan kullanıcıyı belirlemeniz gerekebilir. Bunu güvenli bir şekilde yapmak için, kullanıcı başarıyla oturum açtıktan sonra kullanıcının kimlik jetonunu HTTPS kullanarak sunucunuza gönderin. Ardından, sunucuda kimlik jetonunun bütünlüğünü doğrulayın ve oturum oluşturmak veya yeni bir hesap oluşturmak için jetonda yer alan kullanıcı bilgilerini kullanın.
Kimlik jetonunu sunucunuza gönderin
Bir kullanıcı başarıyla oturum açtıktan sonra kullanıcının kimlik jetonunu alın:
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). }]; }];
Ardından, kimlik jetonunu sunucunuza bir HTTPS POST isteğiyle gönderin:
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); } }];
Kimlik jetonunun bütünlüğünü doğrulama
Kimlik jetonunu HTTPS POST ile aldıktan sonra jetonun bütünlüğünü doğrulamanız gerekir.
如需验证令牌是否有效,请确保满足以下条件:
- ID 令牌由 Google 正确签名。使用 Google 的公钥(以 JWK 或 PEM 格式提供)来验证令牌的签名。这些密钥会定期轮替;请检查响应中的
Cache-Control
标头,以确定何时应再次检索它们。 - ID 令牌中
aud
的值等于应用的某个客户端 ID。通过进行这项检查,可以防止向恶意应用颁发的 ID 令牌用于访问应用后端服务器上同一用户的数据。 - ID 令牌中
iss
的值等于accounts.google.com
或https://accounts.google.com
。 - ID 令牌的过期时间 (
exp
) 尚未过去。 - 如果您需要验证该 ID 令牌代表的是 Google Workspace 或 Cloud 组织帐号,则可以检查
hd
声明,该声明指示用户的托管网域。仅允许特定网域的成员访问资源时,必须使用此方法。缺少此声明表示帐号不属于 Google 托管的网域。
我们强烈建议您使用适合您的平台的 Google API 客户端库或通用 JWT 库,而不是自行编写代码来执行这些验证步骤。对于开发和调试,您可以调用我们的 tokeninfo
验证端点。
Google API İstemci Kitaplığını Kullanma
Üretim ortamındaki Google kimliği jetonlarını doğrulamak için Google API İstemci Kitaplıklarından birini (ör. Java, Node.js, PHP, Python) kullanmak önerilen yöntemdir.
Java'da kimlik jetonunu doğrulamak için GoogleIdTokenVerifier nesnesini kullanın. Örneğin:
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 CLIENT_ID of the app that accesses the backend: .setAudience(Collections.singletonList(CLIENT_ID)) // Or, if multiple clients access the backend: //.setAudience(Arrays.asList(CLIENT_ID_1, CLIENT_ID_2, CLIENT_ID_3)) .build(); // (Receive idTokenString by HTTPS POST) GoogleIdToken idToken = verifier.verify(idTokenString); if (idToken != null) { Payload payload = idToken.getPayload(); // Print user identifier 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."); }
GoogleIdTokenVerifier.verify()
yöntemi JWT imzasını, aud
hak talebini, iss
hak talebini ve exp
hak talebini doğrular.
Kimlik jetonunun bir Google Workspace veya Cloud kuruluş hesabını temsil ettiğini doğrulamanız gerekiyorsa Payload.getHostedDomain()
yöntemiyle döndürülen alan adını kontrol ederek hd
hak talebini doğrulayabilirsiniz. email
talebinin alanı, hesabın bir alan veya kuruluş tarafından yönetildiğinden emin olmak için yeterli değil.
Node.js'de kimlik jetonunu doğrulamak üzere Node.js için Google Kimlik Doğrulama Kitaplığı'nı kullanın. Kitaplığı yükleyin:
npm install google-auth-library --saveArdından,
verifyIdToken()
işlevini çağırın. Örneğin:
const {OAuth2Client} = require('google-auth-library'); const client = new OAuth2Client(); async function verify() { const ticket = await client.verifyIdToken({ idToken: token, audience: CLIENT_ID, // Specify the CLIENT_ID of the app that accesses the backend // Or, if multiple clients access the backend: //[CLIENT_ID_1, CLIENT_ID_2, CLIENT_ID_3] }); const payload = ticket.getPayload(); const userid = payload['sub']; // If the request specified a Google Workspace domain: // const domain = payload['hd']; } verify().catch(console.error);
verifyIdToken
işlevi, JWT imzasını, aud
hak talebini, exp
hak talebini ve iss
hak talebini doğrular.
Kimlik jetonunun bir Google Workspace veya Cloud kuruluş hesabını temsil ettiğini doğrulamanız gerekiyorsa kullanıcının barındırılan alanını belirten hd
hak talebini kontrol edebilirsiniz. Bu, bir kaynağa erişimi yalnızca belirli alanların üyeleriyle kısıtlarken kullanılmalıdır. Bu iddianın olmaması, hesabın Google tarafından barındırılan bir alana ait olmadığını gösterir.
PHP'de kimlik jetonunu doğrulamak üzere PHP için Google API İstemci Kitaplığı'nı kullanın. Kitaplığı yükleyin (örneğin, Composer kullanarak):
composer require google/apiclientArdından,
verifyIdToken()
işlevini çağırın. Örneğin:
require_once 'vendor/autoload.php'; // Get $id_token via HTTPS POST. $client = new Google_Client(['client_id' => $CLIENT_ID]); // Specify the CLIENT_ID of the app that accesses the backend $payload = $client->verifyIdToken($id_token); if ($payload) { $userid = $payload['sub']; // If the request specified a Google Workspace domain //$domain = $payload['hd']; } else { // Invalid ID token }
verifyIdToken
işlevi, JWT imzasını, aud
hak talebini, exp
hak talebini ve iss
hak talebini doğrular.
Kimlik jetonunun bir Google Workspace veya Cloud kuruluş hesabını temsil ettiğini doğrulamanız gerekiyorsa kullanıcının barındırılan alanını belirten hd
hak talebini kontrol edebilirsiniz. Bu, bir kaynağa erişimi yalnızca belirli alanların üyeleriyle kısıtlarken kullanılmalıdır. Bu iddianın olmaması, hesabın Google tarafından barındırılan bir alana ait olmadığını gösterir.
Python'da kimlik jetonunu doğrulamak için verify_oauth2_token işlevini kullanın. Örneğin:
from google.oauth2 import id_token from google.auth.transport import requests # (Receive token by HTTPS POST) # ... try: # Specify the CLIENT_ID of the app that accesses the backend: idinfo = id_token.verify_oauth2_token(token, requests.Request(), CLIENT_ID) # Or, if multiple clients access the backend server: # idinfo = id_token.verify_oauth2_token(token, requests.Request()) # if idinfo['aud'] not in [CLIENT_ID_1, CLIENT_ID_2, 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. userid = idinfo['sub'] except ValueError: # Invalid token pass
verify_oauth2_token
işlevi, JWT imzasını, aud
hak talebini ve exp
hak talebini doğrular.
Ayrıca, verify_oauth2_token
tarafından döndürülen nesneyi inceleyerek hd
hak talebini (varsa) doğrulamanız gerekir. Arka uç sunucusuna birden fazla istemci erişirse aud
talebini manuel olarak da doğrulayın.
Jetonbilgi uç noktasını çağırma
Hata ayıklama için kimlik jetonu imzasını doğrulamanın kolay bir yolu, tokeninfo
uç noktasını kullanmaktır. Bu uç noktanın çağrılması, kendi kodunuzda doğru doğrulamayı ve yük ayıklamayı test ederken doğrulamanın büyük kısmını sizin için yapan ek bir ağ isteği içerir. İstekler kısıtlanabileceği veya başka şekilde aralıklı hatalara maruz kalabileceğinden üretim kodunda kullanıma uygun değildir.
tokeninfo
uç noktasını kullanarak kimlik jetonunu doğrulamak için uç noktaya bir HTTPS POST veya GET isteği gönderin ve kimlik jetonunuzu id_token
parametresinde iletin.
Örneğin, "XYZ123" jetonunu doğrulamak için aşağıdaki GET isteğini yapın:
https://oauth2.googleapis.com/tokeninfo?id_token=XYZ123
Jeton düzgün şekilde imzalandıysa ve iss
ile exp
hak talepleri beklenen değerleri içeriyorsa bir HTTP 200 yanıtı alırsınız. Burada, gövde JSON biçimli kimlik jetonu taleplerini içerir.
Aşağıda örnek bir yanıt verilmiştir:
{ // 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" }
Kimlik jetonunun bir Google Workspace hesabını temsil ettiğini doğrulamanız gerekiyorsa kullanıcının barındırılan alanını belirten hd
hak talebini kontrol edebilirsiniz. Bu, bir kaynağa erişimi yalnızca belirli alanların üyeleriyle kısıtlarken kullanılmalıdır. Bu iddianın olmaması hesabın Google Workspace tarafından barındırılan bir alana ait olmadığını gösterir.
Hesap veya oturum oluşturma
Jetonu doğruladıktan sonra, kullanıcının zaten kullanıcı veritabanınızda olup olmadığını kontrol edin. Bu durumda, kullanıcı için kimliği doğrulanmış bir oturum oluşturun. Kullanıcı henüz kullanıcı veritabanınızda değilse kimlik jetonu yükündeki bilgilerden yeni bir kullanıcı kaydı oluşturun ve kullanıcı için oturum oluşturun. Uygulamanızda yeni oluşturulmuş bir kullanıcı tespit ettiğinizde kullanıcıdan ihtiyaç duyduğunuz ek profil bilgilerini girmesini isteyebilirsiniz.
Hesaplar Arası Koruma ile kullanıcılarınızın hesaplarının güvenliğini sağlama
Bir kullanıcının oturum açması için Google'a bağlı olduğunuzda, Google'ın kullanıcı verilerini korumak için oluşturduğu tüm güvenlik özelliklerinden ve altyapıdan otomatik olarak yararlanırsınız. Ancak, çok düşük olasılıkla da olsa kullanıcının Google Hesabı güvenliği ihlal edilirse veya başka önemli güvenlik olayları söz konusuysa uygulamanız saldırıya açık olabilir. Hesaplarınızı büyük güvenlik olaylarına karşı daha iyi korumak için Google'dan güvenlik uyarıları almak üzere Hesaplar Arası Koruma'yı kullanın. Bu etkinlikleri aldığınızda kullanıcının Google Hesabı'nın güvenliğiyle ilgili önemli değişiklikleri görebilirsiniz. Ardından hesaplarınızın güvenliğini sağlamak için hizmetinizde işlem yapabilirsiniz.