# 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)](https://dts-identity.com/es/docs/quickstarts/oidc-authorization-code.md) | El protocolo en sí, con HTTP puro y curl. Lea esta guía primero; las demás se apoyan en ella. |
| [Backend Node / Express](https://dts-identity.com/es/docs/quickstarts/node-express.md) | Una aplicación web renderizada en el servidor o respaldada por una API, en Node.js. |
| [Backend Python / Flask](https://dts-identity.com/es/docs/quickstarts/python-flask.md) | Una aplicación web renderizada en el servidor, en Python. |
| [Aplicación de página única en React](https://dts-identity.com/es/docs/quickstarts/react-spa.md) | Una aplicación de navegador sin backend propio. |
| [Cliente Financial-grade API (FAPI 2.0)](https://dts-identity.com/es/docs/quickstarts/fapi-2.md) | Una aplicación con un perfil de seguridad FAPI 2.0: private key JWT, pushed authorization requests, DPoP. |
| [Proteger una API](https://dts-identity.com/es/docs/quickstarts/protect-an-api.md) | 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](https://dts-identity.com/es/docs/integrations/apis.md#call-the-management-api-machine-to-machine-quickstart).

## Antes de empezar [#before-you-start]

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](https://dts-identity.com/es/docs/integrations/applications.md#choosing-an-oidc-type-by-deployment-shape).
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](https://dts-identity.com/es/docs/branding/custom-domains.md), 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ó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.
