Saltar a contenido

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).