Autenticación para desarrollo local

Esta guía cubre cómo funciona la autenticación en el entorno de desarrollo local, incluyendo la configuración de Keycloak y los procedimientos de inicio de sesión.

Configuración de Keycloak

Keycloak se ejecuta en http://localhost:8081 y se configura automáticamente con importaciones de realm cuando ejecutas make start-deps.

Consola de administración de Keycloak

• URL: http://localhost:8081
• Nombre de usuario: admin
• Contraseña: admin

Realms

Realm	Propósito	Usado por
internal	Usuarios administrativos	Panel de administración
customer	Clientes del banco	Portal del cliente

Las definiciones de realm se almacenan en dev/keycloak/ y se importan automáticamente al iniciar.

Inicio de sesión en el panel de administración

1. Navega a http://admin.localhost:4455
2. Serás redirigido a Keycloak
3. Inicia sesión con: admin@galoy.io
4. El panel de administración usa el realm internal de Keycloak con OIDC Code Flow

Inicio de sesión en el portal del cliente

1. Primero, crea un cliente a través del panel de administración
2. Abre http://app.localhost:4455 en un navegador separado o ventana de incógnito
3. Introduce la dirección de correo electrónico del cliente
4. Recupera el código de inicio de sesión:

make get-customer-login-code EMAIL=customer@example.com

5. Introduce el código para completar el inicio de sesión

El portal del cliente usa NextAuth con el proveedor de Keycloak para autenticación OIDC.

Flujo de autenticación

Cómo funciona Oathkeeper

Oathkeeper se encuentra en el puerto 4455 y gestiona toda la autenticación:

1. Recibe solicitudes entrantes con tokens JWT Bearer
2. Valida la firma JWT contra el endpoint JWKS de Keycloak
3. Emite un JWT interno con audiencia específica de ruta y sujeto de usuario
4. Redirige la solicitud al servicio upstream apropiado (admin-server o customer-server)

Los servidores backend solo aceptan JWT internos de Oathkeeper — verifican usando el JWKS de Oathkeeper y comprueban la reclamación de audiencia.

Duración de los tokens (desarrollo)

Token	Duración
Token de acceso	5 minutos
Token de actualización	30 minutos
Sesión	8 horas