Quickstarts
Conecte su aplicación para el inicio de sesión mediante OpenID Connect, con guías de copiar y pegar para el flujo genérico, Node, Python y React.
Estas guías consiguen que una aplicación autentique a los usuarios a través de la plataforma mediante OpenID Connect (OIDC). Empiece por el flujo genérico para entender las piezas que intervienen y pase después a la guía que corresponda a su stack.
| Guía | Para qué sirve |
|---|---|
| OpenID Connect (Authorization Code + PKCE) | El protocolo en sí, con HTTP puro y curl. Lea esta guía primero; las demás se apoyan en ella. |
| Backend Node / Express | Una aplicación web renderizada en el servidor o respaldada por una API, en Node.js. |
| Backend Python / Flask | Una aplicación web renderizada en el servidor, en Python. |
| Aplicación de página única en React | Una aplicación de navegador sin backend propio. |
| Cliente Financial-grade API (FAPI 2.0) | Una aplicación con un perfil de seguridad FAPI 2.0: private key JWT, pushed authorization requests, DPoP. |
| Proteger una API | El otro lado: validar los access tokens de la plataforma en su propia API y aplicar los scopes. |
Para llamar a la API REST de gestión de la plataforma desde un servicio de backend (no para el inicio de sesión de usuarios), utilice en su lugar el quickstart machine-to-machine que encontrará en APIs.
Antes de empezar
-
Registre su aplicación. En la Admin Console, añada una aplicación y elija el tipo de OIDC que corresponda a su despliegue: un cliente confidential para todo lo que tenga un backend capaz de guardar un secreto (Node/Express, Python/Flask), o un cliente public para una aplicación de página única o nativa que no pueda hacerlo. Consulte Aplicaciones.
-
Anote las credenciales. Un cliente confidential tiene un client ID y un client secret; un cliente public tiene solo un client ID y se apoya en PKCE. Guarde el secreto en el servidor, nunca en código del navegador.
-
Añada su redirect URI. Registre la URL exacta a la que la plataforma devuelve al usuario tras el inicio de sesión (por ejemplo,
https://app.example.com/callback). Las redirect URI se comparan carácter por carácter: el esquema, el host, el puerto, la ruta y la barra final deben ser idénticos; no se admiten comodines. -
Conozca sus endpoints. Todo lo que sigue puede descubrirse en el documento de configuración OpenID de su instancia:
https://<your-domain>/.well-known/openid-configurationSustituya
<your-domain>por el dominio de inicio de sesión de su instancia (su dominio propio, si tiene uno; en caso contrario, el host de la plataforma). Este documento enumeraauthorization_endpoint,token_endpoint,userinfo_endpoint,jwks_uriyend_session_endpoint. Trate el documento de discovery como la fuente de verdad y deje que su biblioteca lo lea, en lugar de codificar las rutas de forma fija.
Los endpoints de un vistazo
A modo de orientación, estas son las rutas estándar:
| Propósito | Ruta |
|---|---|
| Discovery | /.well-known/openid-configuration |
| Autorización | /authorize |
| Token | /oauth/token |
| UserInfo | /userinfo |
| Claves de firma (JWKS) | /.well-known/jwks |
| Cierre de sesión (end session) | /logout |
PKCE es obligatorio para los clientes public y para las aplicaciones con un perfil de seguridad Financial-grade API, y S256 es el único método de challenge aceptado. Utilice siempre Authorization Code con PKCE; el flujo implicit no es recomendable.