Descubra cómo OpenID Connect mejora la autenticación mediante el protocolo OAuth 2.0 para proporcionar una forma segura y estándar de autenticar a los usuarios.
Tabla de contenidos
- ¿Qué es OpenID Connect?
- Cómo funciona OIDC
- ¿Qué es OAuth 2.0?
- Beneficios de OIDC
- Explicación de los tokens de ID
- Implementación de OIDC
- Consideraciones de seguridad
- Solución de problemas
- Glosario de términos
¿Qué es OpenID Connect?
OpenID Connect (OIDC) es una capa de identidad construida sobre el protocolo OAuth 2.0. Permite a los clientes (como Esadax) verificar la identidad de los usuarios basándose en la autenticación realizada por un servidor de autorización.
- Desarrollado por la Fundación OpenID.
- Ampliamente adoptado en aplicaciones web y móviles modernas.
- Utilizado por Google, Microsoft, Auth0, Okta y más.
Cómo funciona OIDC
- El usuario intenta iniciar sesión en la aplicación cliente.
- El cliente redirige al usuario al proveedor de identidad (IdP).
- El usuario se autentica con el IdP (por ejemplo, nombre de usuario + contraseña, 2FA).
- IdP redirige de nuevo al cliente con un token de ID y (opcionalmente) un token de acceso.
- El cliente verifica la firma y las reclamaciones del token de identificación.
- El usuario se autentica y se crea una sesión.
¿Qué es OAuth 2.0?
| Característica | ¿Qué es OAuth 2.0? | Conexión de OpenID (OIDC) |
|---|---|---|
| Propósito | Autorización | Autenticación |
| Tipo de token | Token de acceso | Token de identificación + token de acceso |
| Identidad de usuario | No está garantizado | Explícitamente proporcionado |
| Acceso a datos de perfil | Requiere alcances adicionales | Compatible a través del ámbito openid |
| Reclamaciones normalizadas | No. | Sí |
✅ OIDC = OAuth 2.0 + identidad + información de usuario estandarizada.
Beneficios de OIDC
- Interoperabilidad: estándar en muchos proveedores y plataformas.
- Seguridad: Utiliza tokens firmados y flujos probados.
- Flexibilidad: Funciona para aplicaciones web, aplicaciones móviles y API.
- Escalabilidad: Ideal para sistemas distribuidos o multiusuario.
- Identidad federada: un inicio de sesión funciona en muchos servicios.
Explicación de los tokens de ID
Un ID Token es un JWT (JSON Web Token) que contiene información sobre el usuario.
- Reclamaciones comunes:
sub: Asunto (ID de usuario)email: Correo electrónico del usuarioname: Nombre completoiat: Emitido enexp: Fecha de vencimientoiss: Entidad emisoraaud: Audiencia (su aplicación)
Ejemplo de carga útil de token de identificación decodificado:
{
"sub": "1234567890",
"name": "Jane Doe",
"email": "jane@esadax.com",
"iat": 1692547200,
"exp": 1692550800,
"iss": "https://auth.provider.com",
"aud": "esadax-app"
}
Implementación de OIDC
- Elija un proveedor: Google, Auth0, Okta o autohospedado (por ejemplo, Keycloak).
- Registre su Aplicación: Obtenga un ID de cliente y un secreto de cliente.
- Redirigir Usuarios al Proveedor:
- Incluya
response_type=codeyscope=openid.
- Incluya
- Manejo de devolución de llamada:
- Intercambia el código por tokens usando el extremo
/tokendel proveedor.
- Intercambia el código por tokens usando el extremo
- Verificar token de identificación:
- Compruebe la firma,
aud,exp, y otras reclamaciones.
- Compruebe la firma,
- Crear sesión:
- Utilice los datos del token para autenticar al usuario en su sistema.
Consideraciones de seguridad
- Siempre validar tokens de identificación en el lado del servidor.
- Utilice HTTPS para evitar la intercepción de tokens.
- Establezca vidas útiles de token cortas y rote los secretos.
- Verifique
noncepara evitar ataques de repetición. - Utilice PKCE (Clave de prueba para intercambio de código) para clientes públicos como SPA y aplicaciones móviles.
Solución de problemas
- ¿Firma de token no válida?
- Asegúrese de que está utilizando la clave pública correcta (JWKS).
- ¿Público no válido (aud)?
- Compruebe que el token se emitió para su ID de cliente.
- ¿El token ha caducado?
- Actualice el token o vuelva a autenticar al usuario.
- ¿El proveedor no redirige?
- Verifica que tu URI de redireccionamiento coincida con lo registrado.
Glosario de términos
- OIDC: OpenID Connect, una capa de identidad sobre OAuth 2.0.
- OAuth 2.0: Protocolo para autorizar el acceso a los recursos.
- IdP: Proveedor de identidad (por ejemplo, Google, Okta) que autentica al usuario.
- ID Token: Un JWT que confirma la identidad del usuario.
- Token de acceso: Un token utilizado para acceder a las API protegidas.
- PKCE: Extensión de seguridad a OAuth 2.0 para clientes públicos.
