Sesion 08 - Seguridad con Auth Service
Este documento sirve como guia de trabajo para la sesion de seguridad sobre la arquitectura de microservicios.
No reemplaza los README de cada modulo. Se usa como apoyo practico para esta fase del curso.
Objetivo
Implementar una primera capa de seguridad industrial sobre el sistema distribuido:
- autenticacion centralizada
- usuarios y roles
- emision de JWT
- base lista para integracion con
gateway - arquitectura preparada para reemplazo posterior por
Keycloak
Idea central de la sesion
En esta fase, gateway no se convierte en proveedor de identidad.
Se crea un microservicio especializado:
auth-service
Responsable de:
- login
- validacion de credenciales
- carga de usuarios y roles
- emision de JWT
En el estado actual de S8 P1:
gatewayya valida ese JWTproductoya se comporta como resource servercatalogose mantiene protegido solo desdegatewaypara comparar enfoques- el emisor de tokens podra ser reemplazado despues por
Keycloak
Arquitectura objetivo de P1
Cliente -> Auth Service -> JWT
Cliente -> Gateway -> Producto / Catalogo
En P1:
auth-serviceautenticaauth-serviceemite JWT- el resto del sistema se prepara para consumir esa identidad
Cambios implementados en esta sesion
1. Creacion de auth-service
Se creo el modulo:
services/auth-ms
Con base alineada al resto de microservicios:
- Config Client
- Eureka Client
- Actuator
- Prometheus
- Flyway
- MySQL
- Spring Security
- SpringDoc
2. Configuracion externa
Se agregaron:
infra/config-repo/auth-ms-dev.ymlinfra/config-repo/auth-ms-prod.yml
Incluyen:
- datasource
- eureka
- management
- configuracion JWT
3. Modelo de seguridad
Se definio una base minima:
usersrolesuser_roles
Con el objetivo de:
- autenticar usuarios locales en
P1 - emitir JWT propios
- desacoplar identidad de
gateway - facilitar reemplazo posterior por
Keycloak
4. Migracion y seed inicial
Se creo:
V1__create_users_roles_tables.sql
Y se cargan usuarios iniciales:
admin / admin123user / user123
Con roles:
ADMINUSER
5. Login y JWT
Se implemento:
POST /auth/login
Con:
- autenticacion via Spring Security
- contrasenas cifradas con
BCrypt - emision de JWT con claims estandar
Claims emitidos:
subissiatexprolespreferred_username
Significado de los claims:
sub-> sujeto autenticado; en esta fase representa elusernameiss-> emisor del token; identifica aauthiat-> momento exacto en que el token fue emitidoexp-> momento exacto en que el token deja de ser validoroles-> autoridades del usuario, utiles para autorizacion coarse-grainedpreferred_username-> nombre de usuario legible y reusable en integraciones futuras
Archivos trabajados
services/auth-ms/pom.xmlservices/auth-ms/src/main/resources/application.ymlservices/auth-ms/src/main/resources/logback-spring.xmlservices/auth-ms/src/main/resources/db/migration/V1__create_users_roles_tables.sqlservices/auth-ms/src/main/java/com/upeu/auth/AuthApplication.javaservices/auth-ms/src/main/java/com/upeu/auth/config/JwtProperties.javaservices/auth-ms/src/main/java/com/upeu/auth/config/PasswordConfig.javaservices/auth-ms/src/main/java/com/upeu/auth/config/SecurityConfig.javaservices/auth-ms/src/main/java/com/upeu/auth/config/DataInitializer.javaservices/auth-ms/src/main/java/com/upeu/auth/entity/AuthUser.javaservices/auth-ms/src/main/java/com/upeu/auth/entity/Role.javaservices/auth-ms/src/main/java/com/upeu/auth/repository/AuthUserRepository.javaservices/auth-ms/src/main/java/com/upeu/auth/repository/RoleRepository.javaservices/auth-ms/src/main/java/com/upeu/auth/dto/AuthLoginRequest.javaservices/auth-ms/src/main/java/com/upeu/auth/dto/AuthLoginResponse.javaservices/auth-ms/src/main/java/com/upeu/auth/service/CustomUserDetailsService.javaservices/auth-ms/src/main/java/com/upeu/auth/service/JwtService.javaservices/auth-ms/src/main/java/com/upeu/auth/service/AuthService.javaservices/auth-ms/src/main/java/com/upeu/auth/controller/AuthController.javaservices/auth-ms/compose-dev.ymlservices/auth-ms/compose.ymlinfra/config-repo/auth-ms-dev.ymlinfra/config-repo/auth-ms-prod.yml
Preparacion
DEV
Levantar:
- config
- eureka
- mysql de
auth - auth
PROD
Levantar:
- infra
- mysql de
auth - auth
Paso 1. Levantar auth-service en DEV
1. Config Server
cd infra/config-server
./mvnw spring-boot:run
2. Registry Server
cd infra/registry-server
./mvnw spring-boot:run
3. MySQL auth dev
cd services/auth
docker compose -f compose-dev.yml up -d
4. Auth dev
cd services/auth
./mvnw spring-boot:run
Paso 2. Verificar salud y observabilidad base
Probar:
http://localhost:8042/actuator/health
http://localhost:8042/actuator/metrics
http://localhost:8042/actuator/prometheus
Que debe aprender el alumno:
auth-servicenace integrado al ecosistema del sistema distribuido- seguridad no se implementa aislada de operacion y observabilidad
Paso 3. Verificar carga inicial de usuarios y roles
Validar que la aplicacion arranca sin error de migracion ni de seed.
Usuarios esperados:
admin / admin123user / user123
Roles esperados:
ADMINUSER
Que debe aprender el alumno:
- la seguridad parte de un modelo persistente
- no se depende de usuarios hardcodeados en memoria
Paso 4. Probar login
Request
POST http://localhost:8042/auth/login
Payload:
{
"username": "admin",
"password": "admin123"
}
Respuesta esperada
{
"accessToken": "eyJhbGciOiJIUzI1NiJ9...",
"tokenType": "Bearer",
"expiresIn": 3600000,
"username": "admin",
"roles": ["ROLE_ADMIN"]
}
Que debe aprender el alumno:
- Spring Security autentica
auth-serviceemite JWT- el token ya representa identidad y roles
- cada claim del token tiene una responsabilidad concreta dentro del sistema
Paso 5. Probar fallos de autenticacion
Caso 1
Usuario inexistente
Caso 2
Password incorrecta
Caso 3
Usuario deshabilitado
Que debe aprender el alumno:
- autenticacion no es solo emitir token
- el sistema debe fallar correctamente cuando las credenciales no son validas
Paso 6. Inspeccionar el JWT
Revisar que el token contenga:
subissiatexprolespreferred_username
Interpretacion recomendada:
subresponde quien es el usuario autenticadoissresponde quien emitio el tokeniatyexpcontrolan la vigencia del JWTroleshabilita autorizacion por perfiles o autoridadespreferred_usernameayuda a interoperabilidad, depuracion y trazabilidad
Que debe aprender el alumno:
- el contrato real entre
auth-servicey el resto del sistema es el JWT - esa es la clave para luego reemplazar el emisor por
Keycloak
Paso 7. Entender la frontera hacia gateway
En esta sesion:
auth-serviceautentica y emite
En el cierre actual de esta fase:
gatewayya valida el JWT- ya existen rutas publicas y privadas
productoya valida JWT localmentecatalogoqueda sin seguridad propia en esta fase y se restringe desdegateway
Que debe aprender el alumno:
- identidad y enforcement no son la misma responsabilidad
auth-serviceygatewaycolaboran, pero no son lo mismo- no todos los microservicios tienen que adoptar la misma estrategia de proteccion al mismo tiempo
Paso 8. Integrar validacion JWT en gateway
En este bloque, gateway deja de ser solo punto de enrutamiento y pasa a comportarse como borde seguro del sistema.
Se implementa:
- validacion de firma del JWT
- validacion del
issuer - validacion estandar de vigencia del token
- lectura del claim
roles - mapeo de
rolesa autoridades de Spring Security
Tambien se dejan rutas publicas:
/auth/**/actuator/health/actuator/info/actuator/prometheus- rutas Swagger necesarias para documentacion
Y el resto de rutas queda protegido.
Que debe aprender el alumno:
auth-serviceemite identidadgatewayaplica enforcement- el JWT es el contrato de seguridad entre ambos
Paso 9. Probar rutas publicas y privadas desde gateway
1. Reiniciar servicios clave en DEV
Levantar o reiniciar:
configeurekaauthgateway
2. Obtener JWT desde auth
$body = @{
username = "admin"
password = "admin123"
} | ConvertTo-Json
$response = Invoke-RestMethod `
-Method Post `
-Uri "http://localhost:8042/auth/login" `
-ContentType "application/json" `
-Body $body
$response
$token = $response.accessToken
Guardar el valor de:
accessToken- o usar directamente la variable
$token
3. Probar una ruta privada sin token
Invoke-WebRequest `
-Uri "http://localhost:8090/api/v1/productos/detalle/1"
Resultado esperado:
401 Unauthorized
4. Probar la misma ruta con token
Invoke-RestMethod `
-Method Get `
-Uri "http://localhost:8090/api/v1/productos/detalle/1" `
-Headers @{ Authorization = "Bearer $token" }
Resultado esperado:
- acceso permitido
- respuesta del flujo normal del sistema
5. Probar una ruta publica
http://localhost:8090/actuator/health
Resultado esperado:
- las rutas publicas siguen accesibles sin JWT
Que debe aprender el alumno:
- seguridad no significa bloquear todo indiscriminadamente
- el borde del sistema debe distinguir entre rutas publicas y privadas
- el token ya tiene valor operativo real en la arquitectura
Preguntas para el alumno
- Por que
gatewayno deberia ser el proveedor principal de identidad? - Que diferencia hay entre autenticar y autorizar?
- Por que el modelo
users,roles,user_roleses mejor que guardar un solo rol en la tabla de usuario? - Que ventajas da emitir JWT con claims estandar?
- Por que este diseño facilita una migracion futura a
Keycloak?
Checklist de evaluacion
Para cerrar esta fase, el alumno debe presentar evidencia de:
auth-servicelevantado endevGET /actuator/healthGET /actuator/prometheus- migracion Flyway aplicada
- usuarios y roles iniciales cargados
POST /auth/loginexitoso- fallo correcto ante credenciales invalidas
- token JWT emitido con claims esperados
gatewayrechazando rutas privadas sin tokengatewayaceptando rutas privadas con token validoproductorechazando acceso directo sin tokenproductoaceptando acceso directo con token valido
Cierre de la fase auth-service
La fase S8 P1 se considera bien encaminada cuando el alumno puede demostrar:
- autenticacion centralizada
- usuarios y roles persistidos
- login funcional
- JWT emitido correctamente
- integracion base con
gateway - rutas publicas y privadas diferenciadas desde el borde
productoprotegido como resource servercatalogoaun protegido solo porgatewaypara contraste didactico
Siguiente paso recomendado
Despues de esta sesion, el siguiente bloque natural es:
- pruebas de autorizacion por rol sobre
producto - validacion integral del flujo
auth -> gateway -> producto - prueba comparativa entre
productoprotegido localmente ycatalogoprotegido solo desdegateway - pruebas en
prod - preparacion para evolucionar a
Keycloak