One Tap oturum açma istemcisi, kullanıcı bir Google kimliği kodu seçtiğinde Google Hesabı. Kimlik jetonu, kullanıcı kimliğinin imzalanmış bir onayıdır ve Kullanıcının temel profil bilgilerini içerir (muhtemelen bir e-posta adresi de dahil olmak üzere) Google tarafından onaylanmıştır.
Kullanılabilir kimlik jetonları, aşağıdakilerle güvenli bir şekilde kimlik doğrulaması yapmak için kullanılabilir: veya kullanıcıyı otomatik olarak yeni bir hesaba kaydetmek Bu sayede kullanıcının e-posta adresini doğrulamanız gerekmez.
Oturum açmak veya bir kullanıcıyı kimlik jetonuyla kaydetmek için jetonu uygulamanızın arka uçta olması gerekir. Arka uçta bir Google API istemcisi kullanarak jetonu doğrulayın kitaplığı veya genel amaçlı bir JWT kitaplığıdır. Kullanıcı daha önce bu Google Hesabı ile uygulamada oturum açıyorsanız yeni bir hesap oluşturun.
İsteğe bağlı olarak, tekrar saldırılarını önlemek için tek seferlik rastgele sayı kullanmayı seçtiyseniz getNonce arka uç sunucunuza Kimlik Jetonu ile birlikte göndermek ve kimlik doğrulamasından etkilenen beklenen değerdir. Tek seferlik rastgele sayı kullanma seçeneğini, kullanıcı güvenliğini iyileştirmesidir.
Kimlik bilgileri nesnesinden bir kimlik jetonu alma
Bir kullanıcının kimlik bilgilerini aldıktan sonra, kimlik bilgileri nesnesinin bir kimlik jetonu içerir. Varsa arka ucunuza gönderin.
Java
public class YourActivity extends AppCompatActivity { // ... private static final int REQ_ONE_TAP = 2; // Can be any integer unique to the Activity. private boolean showOneTapUI = true; // ... @Override protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) { super.onActivityResult(requestCode, resultCode, data); switch (requestCode) { case REQ_ONE_TAP: try { SignInCredential credential = oneTapClient.getSignInCredentialFromIntent(data); String idToken = credential.getGoogleIdToken(); if (idToken != null) { // Got an ID token from Google. Use it to authenticate // with your backend. Log.d(TAG, "Got ID token."); } } catch (ApiException e) { // ... } break; } } }
Kotlin
class YourActivity : AppCompatActivity() { // ... private val REQ_ONE_TAP = 2 // Can be any integer unique to the Activity private var showOneTapUI = true // ... override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) { super.onActivityResult(requestCode, resultCode, data) when (requestCode) { REQ_ONE_TAP -> { try { val credential = oneTapClient.getSignInCredentialFromIntent(data) val idToken = credential.googleIdToken when { idToken != null -> { // Got an ID token from Google. Use it to authenticate // with your backend. Log.d(TAG, "Got ID token.") } else -> { // Shouldn't happen. Log.d(TAG, "No ID token!") } } } catch (e: ApiException) { // ... } } } // ... }
Kimlik jetonunun bütünlüğünü doğrulayın
Kimlik jetonunu HTTPS POST ile aldıktan sonra bütünlüğü doğrulamanız gerekir belirtilebilir.
Jetonun geçerli olduğunu doğrulamak için aşağıdaki koşulların sağlandığından emin olun: karşılanıyorsa:
- Kimlik jetonu Google tarafından düzgün bir şekilde imzalandı. Google'ın genel anahtarlarını kullanın
(kullanılabilir
JWK veya
PEM biçimini kullanın)
kullanın. Bu anahtarlar düzenli olarak döndürülür; incelemek
ne zaman olduğunu belirlemek için yanıttaki
Cache-Control
üstbilgisi bunları tekrar almanız gerekir. - Kimlik jetonundaki
aud
değeri, uygulamanızın izin vermiştir. Bu kontrol, kötü amaçlı bir sunucuya kimlik jetonlarının verilmesini önlemek için gereklidir. uygulamanızın arka uç sunucusunda aynı kullanıcıyla ilgili verilere erişmek için kullanılan bir uygulamadır. - Kimlik jetonundaki
iss
değeri şuna eşit:accounts.google.com
veyahttps://accounts.google.com
. - Kimlik jetonunun geçerlilik süresi (
exp
) geçmedi. - Kimlik jetonunun bir Google Workspace veya Cloud'u temsil ettiğini doğrulamanız gerekiyorsa
hd
hak talebini kontrol edebilirsiniz. Bu hak talebi, barındırılan etkinliklerin kullanıcının alanıyla ilişkilidir. Bu, bir kaynağa erişimi yalnızca belirli alan adlarında kullanılabilir. Bu hak talebinin olmaması, hesabın Google tarafından barındırılan alan.
email
, email_verified
ve hd
alanlarını kullanarak aşağıdakilerin geçerli olup olmadığını belirleyebilirsiniz:
Google, e-posta adreslerini barındırır ve bu adres konusunda yetkilidir. Google'ın yetkili olduğu durumlarda
kullanıcının yasal hesap sahibi olduğu biliniyorsa, şifre veya diğer iletişim bilgilerini atlayabilirsiniz.
isteyebilirsiniz.
Google'ın yetkili olduğu durumlar:
email
adresinin@gmail.com
son eki var. Bu bir Gmail hesabı.email_verified
doğru vehd
ayarlandı. Bu bir G Suite hesabı.
Kullanıcılar, Gmail veya G Suite kullanmadan Google Hesaplarına kaydolabilir. Zaman
email
, @gmail.com
son eki içermiyor ve hd
mevcut değilse Google
kimlik doğrulama, şifre veya diğer sorgulama yöntemlerinin önerildiğini doğrulama
gösterir. email_verified
, Google'ın ilk olarak
kullanıcı hesabı sırasında üçüncü tarafın
e-posta hesabı değişmiş olabilir.
Bu doğrulama adımlarını uygulamak için kendi kodunuzu yazmak yerine,
Platformunuz için bir Google API istemci kitaplığı veya genel amaçlı bir
JWT kitaplığı. Geliştirme ve hata ayıklama için tokeninfo
hattımızı arayabilirsiniz
doğrulama uç noktası.
Google API İstemci Kitaplığı Kullanma
Google API İstemci Kitaplıklarından birini kullanarak (ör. Java, Node.js PHP Python) kullanın Google kimliği jetonlarını üretim ortamında doğrulamak için önerilen yöntemdir.
Java'da bir kimlik jetonunu doğrulamak için GoogleIdTokenVerifier nesnesini tanımlayı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'yi doğrular
imza, aud
hak talebi, iss
hak talebi ve
exp
hak talebi.
Kimlik jetonunun bir Google Workspace veya Cloud'u temsil ettiğini doğrulamanız gerekiyorsa
alan adını kontrol ederek hd
hak talebini doğrulayabilirsiniz.
Payload.getHostedDomain()
yöntemi tarafından döndürülür.
email
hak talebi, hesabın bir alan tarafından yönetilmesini sağlamak için yeterli değil
ya da çalıştığınız kuruma bağlıdır.
Node.js'de bir 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 --save
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 doğrular
JWT imzası, aud
talebi, exp
talebi,
ve iss
hak talebi.
Kimlik jetonunun bir Google Workspace veya Cloud'u temsil ettiğini doğrulamanız gerekiyorsa
hd
hak talebini kontrol edebilirsiniz. Bu hak talebi, barındırılan etkinliklerin
kullanıcının alanıyla ilişkilidir. Bu, bir kaynağa erişimi yalnızca üyelerle kısıtlarken kullanılmalıdır
belirli alan adlarında kullanılabilir. Bu hak talebinin olmaması, hesabın
Google tarafından barındırılan bir alan adı.
PHP'deki bir kimlik jetonunu doğrulamak için PHP için Google API İstemci Kitaplığı'nı kullanın. Kitaplığı yükleyin (örneğin, Composer kullanarak):
composer require google/apiclient
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 doğrular
JWT imzası, aud
talebi, exp
talebi,
ve iss
hak talebi.
Kimlik jetonunun bir Google Workspace veya Cloud'u temsil ettiğini doğrulamanız gerekiyorsa
hd
hak talebini kontrol edebilirsiniz. Bu hak talebi, barındırılan etkinliklerin
kullanıcının alanıyla ilişkilidir. Bu, bir kaynağa erişimi yalnızca üyelerle kısıtlarken kullanılmalıdır
belirli alan adlarında kullanılabilir. Bu hak talebinin olmaması, hesabın
Google tarafından barındırılan bir alan adı.
Python'da bir 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'yi doğrular.
imza, aud
hak talebi ve exp
hak talebi.
hd
alan adını da doğrulamanız gerekiyor.
hak talebinde bulunmak (geçerliyse)
verify_oauth2_token
iade. Birden fazla müşteri
arka uç sunucusunda aud
hak talebini manuel olarak da doğrulayın.
Jeton bilgisi uç noktasını çağırma
Hata ayıklama için kimlik jetonu imzasını doğrulamanın kolay bir yolu,
tokeninfo
uç noktasını kullanın. Bu uç noktanın çağrılmasında bir
düzgün testiniz sırasında doğrulamanın çoğunu sizin için yapan ek ağ isteği
doğrulama ve yük ayıklama işlemlerini kendi kodunuzda gerçekleştirin. Üretimde kullanılmaya uygun değil
zaman zaman hatalarına maruz kalabilir. Bu nedenle istekler kısıtlanabilir veya
tokeninfo
uç noktasını kullanarak kimlik jetonunu doğrulamak için HTTPS oluşturun
uç noktaya POST veya GET isteği gönderebilir ve kimlik jetonunuzu
id_token
parametresinden yararlanın.
Ö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 talebi beklenen değerlere sahipse bir HTTP 200 yanıtı alırsınız.
JSON biçiminde kimlik jetonu hak taleplerini içerir.
Örnek bir yanıt şöyle:
{ // 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 aşağıdakileri kontrol edebilirsiniz:
Kullanıcının barındırılan alan adını belirten hd
hak talebi. Bu özellik, şu durumlarda kullanılmalıdır:
Bir kaynağa erişimi yalnızca belirli alanların üyeleriyle kısıtlayarak. 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ınızda olup olmadığını kontrol edin Öyleyse kullanıcı için kimliği doğrulanmış bir oturum oluşturun. Kullanıcı kullanıcı veritabanınızda henüz yoksa, verilen bilgilerden yeni bir kullanıcı kaydı oluşturun kullanıcı için bir oturum oluşturun. Etkili bir ekip oluşturmak için profil bilgileri için ek profil bilgileri sağlamanıza gerek yoktur. yeni oluşturulan kullanıcıyı eklemeniz gerekir.
Kullanıcılarınızın güvenliğini sağlama Hesaplar Arası Koruma bulunan hesaplar
Bir kullanıcının oturum açması için Google'a güvendiğinizde, otomatik olarak Google'ın, kullanıcı verilerini teminat altına almak üzere geliştirdiği güvenlik özellikleri ve altyapıdır. Ancak, küçük bir ihtimal de olsa kullanıcının Google Hesabının güvenliğinin ihlal edilmesi veya kullanıcının uygulamanız saldırıya açık hale gelebilir. Hesabınızı daha iyi korumak için etkinlikleri için Hesaplar Arasında Koruma'yı seçin. Bu etkinlikleri aldığınızda kullanıcıların Google Hesaplarının güvenliğindeki önemli değişiklikleri ve bu değişikliklerin Ardından, hesaplarınızın güvenliğini sağlamak için hizmetinizle ilgili işlem yapabilirsiniz.