Skip to Content

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íaPara 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 / ExpressUna aplicación web renderizada en el servidor o respaldada por una API, en Node.js.
Backend Python / FlaskUna aplicación web renderizada en el servidor, en Python.
Aplicación de página única en ReactUna 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 APIEl 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

  1. 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.

  2. 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.

  3. 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.

  4. 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-configuration

    Sustituya <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 enumera authorization_endpoint, token_endpoint, userinfo_endpoint, jwks_uri y end_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ósitoRuta
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.

En esta página