El cliente de acceso de One Tap recupera un token de ID de Google cuando el usuario selecciona un Cuenta de Google. Un token de ID es una aserción firmada de la identidad de un usuario que también contiene la información básica del perfil de un usuario, que posiblemente incluya una dirección de correo electrónico que Google verificó.
Cuando haya tokens de ID disponibles, podrás usarlos para autenticarte de forma segura con el backend de tu app o registrar automáticamente al usuario en una cuenta nueva sin tener que verificar la dirección de correo electrónico del usuario.
Para que un usuario acceda o registre a un usuario con un token de ID, envía el token al backend. En el backend, verifica el token con un cliente de la API de Google. una biblioteca de JWT de uso general o una biblioteca JWT de uso general. Si el usuario no accedió a tu con esta Cuenta de Google, crea una cuenta nueva.
Si de forma opcional has elegido usar un nonce para evitar ataques de repetición, usa getNonce para enviarlo junto con el token de ID a tu servidor de backend y al valor esperado. Te recomendamos que consideres usar un nonce para mejorar la seguridad y la protección de los usuarios.
Obtén un token de ID del objeto de credenciales
Luego de que recuperes las credenciales de un usuario, verifica si el objeto de credenciales incluye un token de ID. Si es así, envíala a tu backend.
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) { // ... } } } // ... }
Verifica la integridad del token de ID
Luego de recibir el token de ID a través de HTTPS POST, debes verificar la integridad del token.
Para verificar que el token sea válido, asegúrate de que se cumplan los siguientes requisitos: se cumplen los siguientes criterios:
- Google debe firmar correctamente el token de ID. Usa las claves públicas de Google
(disponible en
JWK o
PEM)
para verificar la firma del token. Estas claves se rotan con regularidad; examinar
el encabezado
Cache-Control
en la respuesta para determinar cuándo deberías recuperarlos de nuevo. - El valor de
aud
en el token de ID es igual a uno de los IDs de cliente. Esta comprobación es necesaria para prevenir tokens de ID emitidos a un app que se usa para acceder a los datos del mismo usuario en el servidor de backend de tu app. - El valor de
iss
en el token de ID es igual aaccounts.google.com
ohttps://accounts.google.com
. - No pasó la hora de vencimiento (
exp
) del token de ID. - Si necesitas validar que el token de ID represente un espacio de nombres de Google Workspace o Cloud
de tu organización, puedes verificar la reclamación de
hd
, que indica el estado dominio del usuario. Se debe usar cuando se restringe el acceso a un recurso a solo los miembros del determinados dominios. La ausencia de este reclamo indica que la cuenta no pertenece a un Dominio alojado en Google.
Usa los campos email
, email_verified
y hd
para determinar si
Google aloja una dirección de correo electrónico y tiene la autoridad para hacerlo. En los casos en que Google tenga autoridad,
se sabe que el usuario es el propietario legítimo de la cuenta, por lo que puedes omitir la contraseña u otra
de verificación de identidad.
Casos en los que Google es confiable:
email
tiene el sufijo@gmail.com
; esta es una cuenta de Gmail.email_verified
es verdadero yhd
está configurado. Esta es una cuenta de G Suite.
Los usuarios pueden registrarse en Cuentas de Google sin usar Gmail ni G Suite. Cuándo
email
no contiene un sufijo @gmail.com
y hd
está ausente; Google no lo hace
se recomienda verificar con métodos de verificación, tanto confiables como con contraseñas
del usuario. email_verified
también puede ser verdadero, ya que Google verificó inicialmente el
usuario cuando se creó la cuenta de Google, sin embargo, la propiedad del tercero
de correo electrónico puede haber cambiado desde entonces.
En lugar de escribir tu propio código para realizar estos pasos de verificación, te recomendamos
recomendamos usar una biblioteca cliente de API de Google para tu plataforma o una biblioteca
biblioteca JWT. Para desarrollo y depuración, puedes llamar a nuestro tokeninfo
.
extremo de validación.
Usa una biblioteca cliente de la API de Google
Usar una de las bibliotecas cliente de las APIs de Google (p.ej., Java Node.js, PHP Python) es la forma recomendada de validar tokens de ID de Google en un entorno de producción.
Para validar un token de ID en Java, utiliza el GoogleIdTokenVerifier. Por ejemplo:
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."); }
El método GoogleIdTokenVerifier.verify()
verifica el JWT
firma, la reclamación de aud
, la reclamación de iss
y el
exp
reclamo.
Si necesitas validar que el token de ID represente un espacio de nombres de Google Workspace o Cloud
cuenta de organización, puedes verificar la reclamación de hd
si revisas el nombre de dominio
que muestra el método Payload.getHostedDomain()
El dominio de la
La reclamación email
no es suficiente para garantizar que la cuenta esté administrada por un dominio.
u organización.
Para validar un token de ID en Node.js, usa la biblioteca de Google Auth para Node.js. Instala la biblioteca:
npm install google-auth-library --saveLuego, llama a la función
verifyIdToken()
. Por ejemplo:
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);
La función verifyIdToken
verifica
la firma de JWT, la reclamación aud
, la reclamación exp
y la reclamación de iss
.
Si necesitas validar que el token de ID represente un espacio de nombres de Google Workspace o Cloud
de tu organización, puedes verificar la reclamación de hd
, que indica el estado
dominio del usuario. Se debe usar cuando se restringe el acceso a un recurso solo a los miembros
de ciertos dominios. La ausencia de este reclamo indica que la cuenta no pertenece a
un dominio alojado en Google.
Para validar un token de ID en PHP, usa la biblioteca cliente de la API de Google para PHP. Instala la biblioteca (por ejemplo, con Composer):
composer require google/apiclientLuego, llama a la función
verifyIdToken()
. Por ejemplo:
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 }
La función verifyIdToken
verifica
la firma de JWT, la reclamación aud
, la reclamación exp
y la reclamación de iss
.
Si necesitas validar que el token de ID represente un espacio de nombres de Google Workspace o Cloud
de tu organización, puedes verificar la reclamación de hd
, que indica el estado
dominio del usuario. Se debe usar cuando se restringe el acceso a un recurso solo a los miembros
de ciertos dominios. La ausencia de este reclamo indica que la cuenta no pertenece a
un dominio alojado en Google.
Para validar un token de ID en Python, usa el verify_oauth2_token . Por ejemplo:
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
La función verify_oauth2_token
verifica el JWT
firma, la reclamación de aud
y la reclamación de exp
.
También debes verificar el hd
.
reclamación (si corresponde), examinando el objeto que
Se muestra verify_oauth2_token
. Si varios clientes acceden a la
de backend, verifica también de forma manual la reclamación aud
.
调用 tokeninfo 端点
为调试验证 ID 令牌签名的一种简单方法是
使用 tokeninfo
端点。调用此端点涉及
这个额外的网络请求会为您完成大部分的验证工作,
验证和载荷提取。不适合在生产环境中使用
因为请求可能会受到限制或出现间歇性错误。
如需使用 tokeninfo
端点验证 ID 令牌,请创建 HTTPS
POST 或 GET 请求发送到端点,并在
id_token
参数。
例如,要验证令牌“XYZ123”,请发出以下 GET 请求:
https://oauth2.googleapis.com/tokeninfo?id_token=XYZ123
如果令牌经过正确签名,并且 iss
和 exp
具有预期值,就会收到 HTTP 200 响应,其中正文
包含 JSON 格式的 ID 令牌声明。
以下是示例响应:
{ // 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" }
如果您需要验证 ID 令牌是否代表 Google Workspace 账号,可以先查看
hd
声明,指示用户的托管网域。只有在以下情况下,
从而仅允许特定网域中的成员访问资源。缺少此声明
表示该账号不属于 Google Workspace 托管网域。
Crea una cuenta o sesión
Después de que hayas verificado el token, comprueba si el usuario ya está en tu cuenta de usuario en la base de datos. Si es así, establece una sesión autenticada para el usuario. Si el usuario aún no está en tu base de datos de usuarios, crea un nuevo registro de usuario a partir de la en la carga útil del token de ID y establecer una sesión para el usuario. Puedes pedirle al usuario para obtener cualquier información de perfil adicional que necesites cuando detectes usuario recién creado en tu app.
Proteger las contraseñas de los usuarios con la Protección integral de la cuenta
Cuando confías en Google para que un usuario acceda, te beneficiarás automáticamente de todas las la infraestructura y las funciones de seguridad que Google creó para proteger los datos del usuario. Sin embargo, en el caso improbable de que se vulnere la Cuenta de Google del usuario o de que haya otro evento de seguridad significativo, tu app también puede ser vulnerable a ataques. Para proteger mejor tus de eventos de seguridad importantes, usa Varias cuentas Protección para recibir alertas de seguridad de Google. Cuando recibes estos eventos, obtener visibilidad sobre los cambios importantes en la seguridad de la cuenta de Google del usuario y podrás tomar medidas en el servicio para proteger tus cuentas.