Seguridad
NovaMarket usa Keycloak como proveedor de identidad (IdP) y OAuth2 / OpenID Connect para autenticación. Los microservicios actúan como OAuth2 Resource Servers y validan el JWT en el claim estándar Authorization: Bearer.
Componentes
| Componente | Rol |
|---|---|
| Keycloak | Login, usuarios, roles, emisión de JWT (RS256) |
| Gateway | Borde seguro: valida JWT en rutas protegidas |
| ms-articulo | Valida JWT localmente; autorización por rol en escrituras |
| market-ng | Cliente público OIDC (market-ng) con PKCE |
Realm novamarket
| Elemento | Valor |
|---|---|
| Cliente SPA | market-ng |
| Redirect DEV | http://localhost:4200/* |
| Claim de roles | roles (ej. ROLE_CAJERO, ROLE_ADMIN) |
| Access token | 3600 s (1 h); renovación vía keycloak-js |
Usuarios demo
| Usuario | Contraseña | Rol |
|---|---|---|
| admin | admin123 | ROLE_ADMIN |
| cajero | cajero123 | ROLE_CAJERO |
| supervisor | supervisor123 | ROLE_SUPERVISOR |
Flujo OIDC (Angular)
1. Usuario → "Entrar con Keycloak"
2. Redirect a Keycloak login
3. Keycloak → redirect a localhost:4200 con code (PKCE)
4. keycloak-js obtiene access_token
5. Interceptor HTTP añade Bearer a llamadas al gateway
Configuración backend
Gateway DEV (infra/config-repo/gateway-dev.yml):
spring:
security:
oauth2:
resourceserver:
jwt:
issuer-uri: http://localhost:41880/realms/novamarket
Gateway PROD:
issuer-uri: ${KEYCLOAK_ISSUER_URI:http://keycloak:8080/realms/novamarket}
ms-articulo: mismo issuer-uri en ms-articulo-{dev,prod}.yml.
El mapper realm-roles-claim en keycloak/realm/novamarket-realm.json expone roles compatibles con Spring Security (authoritiesClaimName: roles).
Autorización por rol
En ms-articulo:
| Método | Ruta | Requisito |
|---|---|---|
| GET | /api/v1/productos/** |
Autenticado |
| POST/PUT/DELETE | /api/v1/productos/** |
Rol ADMIN |
En gateway, rutas públicas (sin JWT) incluyen actualmente categorías, ventas y pagos para facilitar el POS — revisar SecurityConfig del gateway si se endurece la política.
Probar token manualmente
curl -s -X POST "http://localhost:41880/realms/novamarket/protocol/openid-connect/token" `
-H "Content-Type: application/x-www-form-urlencoded" `
-d "grant_type=password" `
-d "client_id=market-ng" `
-d "username=cajero" `
-d "password=cajero123"
Usar access_token en:
GET http://localhost:18080/api/v1/productos/detalle/1
Authorization: Bearer <token>
Evidencias (curso)
- Login Keycloak + captura Angular
- jwt.io con claims
iss,roles,exp - 401 sin token / 200 con token
- 403 cajero vs admin en POST producto
Ver también material histórico en docs/sesiones/s06-seguridad.md.