0007. Login administrativo exclusivo de root¶
Estado: Aceptado
Fecha: 2026-10-21
Autor: Duval Alcivar
Módulo(s) afectado(s): panel administrativo (core-admin): acceso y contraseña temporal
Evidencia: commit 3b81172 (2026-10-21) y src/session.ts, pending-password-change.ts
Contexto¶
El login de identidad distingue tres resultados: credenciales válidas, credenciales inválidas y contraseña temporal vencida. El panel, además, solo debe admitir administración global, no usuarios de tenant.
Decisión¶
El acceso usa POST /api/v1/auth/admin/login. Un 401 significa credenciales
inválidas; un 403 con password_temp_required guarda el username solo en
memoria (pending-password-change.ts) y navega a /login/cambiar-password, que
llama a POST /api/v1/auth/cambiar-password con la política 8–128 caracteres,
mayúscula, número y especial (espejo del ADR 0035 de identidad). Se rechaza
cualquier identidad que no sea root.
| Momento | Endpoint | Entrada |
|---|---|---|
| Login | POST /api/v1/auth/admin/login |
{username, password} → {access_token, expires_in} |
| Contraseña temporal | POST /api/v1/auth/cambiar-password |
{username, password_old, password_new, password_new_confirm} |
Alternativas descartadas¶
- Persistir el username pendiente en la URL o en storage — expone el identificador y sobrevive a la pestaña; en memoria el flujo se pierde al recargar, que es el comportamiento deseado.
Consecuencias¶
El panel no sirve para usuarios de tenant: es una consola de administración global. El cambio de contraseña temporal no se puede retomar tras una recarga y obliga a repetir el login.
Documentado a posteriori desde el código y el historial de Git del repositorio core-admin; la fecha corresponde al commit que introdujo la decisión, no a la fecha de publicación en este sitio (2026-11-09).