Guía de Integración OAuth2 y OpenID Connect

Esta sección está orientada a desarrolladores que necesitan implementar login con el proveedor de identidad:

• Aplicaciones web (frontend + backend).
• Aplicaciones backend que consumen APIs protegidas.
• Integraciones que requieren identidad de usuario mediante OIDC.

Qué resuelve esta guía

• Cómo implementar el flujo de autorización recomendado (authorization_code + PKCE).
• Cómo intercambiar code por tokens y consultar userinfo.
• Cómo validar, revocar y cerrar sesión de forma segura.
• Cómo consumir la API de directorio con token OAuth2.

Estándares de referencia

• OAuth 2.0 (RFC 6749): modelo de autorización y tipos de grant.
• PKCE (RFC 7636): protección del flujo de código de autorización.
• OpenID Connect Core 1.0: capa de identidad sobre OAuth2.
• OpenID Connect Discovery 1.0: descubrimiento automático de metadatos.
• OAuth 2.0 Token Introspection (RFC 7662): validación de tokens.
• OAuth 2.0 Token Revocation (RFC 7009): revocación de tokens.
• JSON Web Key (RFC 7517) y JWT (RFC 7519): verificación de firmas y estructura de tokens.

Ruta sugerida de lectura

1. Introducción y decisiones de arquitectura.
2. Discovery OIDC y configuración de cliente.
3. Flujo de login paso a paso con ejemplos HTTP.
4. Consumo de endpoints de negocio (/api/v1/directory/users/*).