Si usas el Acceso con Google en una app o sitio que se comunica con un servidor de backend, es posible que debas identificar al usuario con una sesión activa en el servidor. Para hacerlo de manera segura, después de que un usuario acceda correctamente, envía el token de ID del usuario a tu servidor mediante HTTPS. Luego, en el servidor, verifica la integridad del token de ID y usa la información del usuario que este contiene para establecer una sesión o crear una cuenta nueva.
Envía el token de ID a tu servidor
Primero, cuando el usuario acceda, obtén su token de ID:
-
Cuando configures el Acceso con Google, llama al método
requestIdToken
y pásale el ID de cliente web del servidor.// Request only the user's ID token, which can be used to identify the // user securely to your backend. This will contain the user's basic // profile (name, profile picture URL, etc) so you should not need to // make an additional call to personalize your application. GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN) .requestIdToken(getString(R.string.server_client_id)) .requestEmail() .build();
-
Cuando se inicie tu app, verifica si el usuario ya accedió a tu app con Google, en este o en otro dispositivo, llamando a
silentSignIn
:GoogleSignIn.silentSignIn() .addOnCompleteListener( this, new OnCompleteListener<GoogleSignInAccount>() { @Override public void onComplete(@NonNull Task<GoogleSignInAccount> task) { handleSignInResult(task); } });
-
Si el usuario no puede acceder de forma silenciosa, presenta tu experiencia normal cuando sale de su cuenta y proporciónale la opción de acceder. Cuando el usuario acceda, obtén su
GoogleSignInAccount
en el resultado de la actividad del intent de acceso:// This task is always completed immediately, there is no need to attach an // asynchronous listener. Task<GoogleSignInAccount> task = GoogleSignIn.getSignedInAccountFromIntent(data); handleSignInResult(task);
-
Después de que el usuario acceda de forma silenciosa o explícita, obtén el token de ID desde el objeto
GoogleSignInAccount
:private void handleSignInResult(@NonNull Task<GoogleSignInAccount> completedTask) { try { GoogleSignInAccount account = completedTask.getResult(ApiException.class); String idToken = account.getIdToken(); // TODO(developer): send ID Token to server and validate updateUI(account); } catch (ApiException e) { Log.w(TAG, "handleSignInResult:error", e); updateUI(null); } }
Luego, envía el token de ID a tu servidor con una solicitud HTTPS POST:
HttpClient httpClient = new DefaultHttpClient(); HttpPost httpPost = new HttpPost("https://yourbackend.example.com/tokensignin"); try { List<NameValuePair> nameValuePairs = new ArrayList<NameValuePair>(1); nameValuePairs.add(new BasicNameValuePair("idToken", idToken)); httpPost.setEntity(new UrlEncodedFormEntity(nameValuePairs)); HttpResponse response = httpClient.execute(httpPost); int statusCode = response.getStatusLine().getStatusCode(); final String responseBody = EntityUtils.toString(response.getEntity()); Log.i(TAG, "Signed in as: " + responseBody); } catch (ClientProtocolException e) { Log.e(TAG, "Error sending ID token to backend.", e); } catch (IOException e) { Log.e(TAG, "Error sending ID token to backend.", e); }
Verifica la integridad del token de ID
Después de recibir el token de ID mediante HTTPS POST, debes verificar su integridad.
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
.
Llama al extremo de tokeninfo
Una manera sencilla de validar la firma de un token de ID para la depuración es
usa el extremo tokeninfo
. Llamar a este extremo implica
una solicitud de red adicional que realice la mayor parte de la validación por ti mientras pruebas las
y la extracción de cargas útiles
en tu propio código. No es apto para uso en producción
código, ya que las solicitudes pueden ser limitadas o estar sujetas a errores intermitentes.
Para validar un token de ID con el extremo tokeninfo
, crea un protocolo HTTPS
POST o GET al extremo y pasa tu token de ID en el
Parámetro id_token
.
Por ejemplo, para validar el token “XYZ123”, realiza la siguiente solicitud GET:
https://oauth2.googleapis.com/tokeninfo?id_token=XYZ123
Si el token está firmado correctamente, y iss
y exp
tienen los valores esperados, recibirás una respuesta HTTP 200,
contiene las reclamaciones de tokens de ID con formato JSON.
Esta es una respuesta de ejemplo:
{ // 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" }
Si necesitas validar que el token de ID representa una cuenta de Google Workspace, puedes verificarlo.
La reclamación hd
, que indica el dominio alojado del usuario Se debe usar cuando
restringir el acceso a un recurso únicamente a los miembros de ciertos dominios. La ausencia de este reclamo
indica que la cuenta no pertenece a un dominio alojado de Google Workspace.
Crea una cuenta o sesión
Después de verificar el token, comprueba si el usuario ya se encuentra en tu base de datos de usuarios. De ser así, establece una sesión autenticada para el usuario. Si el usuario aún no se encuentra en tu base de datos, crea un registro de usuario nuevo a partir de la información de la carga útil del token de ID y establece una sesión para el usuario. Puedes solicitarle al usuario cualquier información de perfil adicional que necesites cuando detectas un usuario recién creado en tu app.
Cómo proteger las cuentas de tus usuarios con la Protección integral de la cuenta
Si dependes de Google para que un usuario acceda, te beneficiarás automáticamente de todas las funciones de seguridad y la infraestructura que Google creó para proteger los datos del usuario. Sin embargo, en el caso improbable de que la Cuenta de Google del usuario se vea comprometida o de que se produzca algún otro evento de seguridad importante, tu app también podría ser vulnerable a ataques. Para proteger mejor tus cuentas de cualquier evento de seguridad importante, usa la Protección integral de la cuenta para recibir alertas de seguridad de Google. Cuando recibes estos eventos, obtienes visibilidad de los cambios importantes en la seguridad de la Cuenta de Google del usuario y puedes tomar medidas en el servicio para proteger tus cuentas.