46 lines
4.6 KiB
Markdown
46 lines
4.6 KiB
Markdown
# Espec: 006-login-emergencia-adm - Aislamiento de Login de Emergencia Admin y Despliegue Automático por Proveedor Único
|
|
|
|
## 1. Visión General y Propósito
|
|
El acceso de emergencia para administradores se encontraba expuesto visualmente en la pantalla principal `/auth/login` cuando la autenticación local estaba deshabilitada para usuarios generales, mostrando alertas explícitas ("El acceso con contraseña local está deshabilitado para usuarios generales") y un modal directo ("Acceso de Emergencia ADMIN").
|
|
Esta visibilidad pública no deseada atrae intentos de fuerza bruta y expone innecesariamente rutas administrativas a usuarios finales.
|
|
|
|
Asimismo, la pantalla general de autenticación requería clics redundantes cuando solo un proveedor de identidad estaba activo (ej. Moodle colapsado por defecto requiriendo apertura manual).
|
|
|
|
El propósito de esta especificación es:
|
|
1. **Aislar el Login de Emergencia**: Mudar el acceso administrativo local a una ruta no enlazada públicamente (`/adm/login`), reservada para el personal de administración.
|
|
2. **Eliminar Indicadores Administrativos en `/auth/login`**: Quitar todo texto informativo de bloqueo local y modales de emergencia de la vista pública de usuarios generales.
|
|
3. **Despliegue Automático Predeterminado**: Si solo existe un método de autenticación activo (ej. Moodle), debe presentarse desplegado y listo para su uso inmediato sin requerir clics adicionales.
|
|
|
|
---
|
|
|
|
## 2. Requisitos en Sintaxis EARS (Español Estricto)
|
|
|
|
### 2.1. Aislamiento de Login de Emergencia
|
|
- **RF-01 (Ubicuo)**: EL SISTEMA dispondrá de la ruta dedicada `/adm/login` (GET y POST) en el Frontend BFF para el inicio de sesión exclusivo de Administradores con credenciales locales de contingencia.
|
|
- **RF-02 (Basado en Eventos)**: CUANDO un usuario ingrese credenciales válidas con rol `ADMIN` en `/adm/login`, EL SISTEMA emitirá la cookie segura `auth_token` y redirigirá al usuario hacia `/dashboard`.
|
|
- **RF-03 (No Deseado / Excepciones)**: SI un usuario sin rol `ADMIN` o con credenciales incorrectas intenta iniciar sesión en `/adm/login`, ENTONCES EL SISTEMA denegará el acceso, registrará el evento de auditoría y redirigirá a `/adm/login?error=...` con el mensaje de error correspondiente.
|
|
- **RF-04 (Ubicuo)**: EL SISTEMA aplicará protección estricta contra ataques de fuerza bruta (`authLimiter`) en las solicitudes POST dirigidas a `/adm/login`.
|
|
|
|
### 2.2. Limpieza de Interfaz en `/auth/login` Público
|
|
- **RF-05 (Ubicuo)**: EL SISTEMA omitirá en `/auth/login` cualquier mención, texto ("El acceso con contraseña local está deshabilitado para usuarios generales"), enlace o modal referente al "Acceso de Emergencia ADMIN" cuando el acceso local esté deshabilitado para usuarios generales.
|
|
- **RF-06 (Estado)**: MIENTRAS la autenticación local esté deshabilitada (`providers.local == false`), EL SISTEMA presentará en `/auth/login` exclusivamente los proveedores institucionales federados (Google Workspace y/o Moodle).
|
|
|
|
### 2.3. Despliegue Automático de Modo de Autenticación Único
|
|
- **RF-07 (Estado)**: MIENTRAS exista exactamente un (1) solo modo de autenticación habilitado entre Google, Moodle y Local:
|
|
1. Si el único modo es Moodle, EL SISTEMA mostrará el formulario de Moodle desplegado (`show`) de forma predeterminada, con los campos de usuario y contraseña inmediatamente accesibles.
|
|
2. Si el único modo es Local, EL SISTEMA mostrará el formulario local sin divisores redundantes ("o con credenciales locales").
|
|
3. Si el único modo es Google, EL SISTEMA mostrará el botón institucional sin divisores.
|
|
- **RF-08 (Estado)**: MIENTRAS existan dos (2) o más modos de autenticación habilitados, EL SISTEMA mostrará los selectores con sus divisores correspondientes y acordeón interactivo.
|
|
|
|
---
|
|
|
|
## 3. Criterios de Aceptación y Finalización (DoD)
|
|
1. Ruta `/adm/login` operativa en Frontend BFF con vista dedicada sobria (`frontend/views/auth/admin_login.html`).
|
|
2. Endpoint `/api/v1/auth/adm-login` o validación en backend asegurando que solo usuarios con rol `ADMIN` puedan autenticarse por dicha vía.
|
|
3. Vista `/auth/login` limpia: cero textos de "Acceso de Emergencia ADMIN" ni avisos de deshabilitación local.
|
|
4. Si Moodle es el único habilitado, el formulario de Moodle aparece desplegado automáticamente sin requerir clic para abrirlo.
|
|
5. Cobertura de pruebas automatizadas con pytest en backend (`pytest tests -v`).
|
|
6. Pyright con 0 errores y 0 advertencias (`npx pyright`).
|
|
7. Bump semántico de versión a `v3.8.5`, registro en `CHANGELOG.md` y `MEMORY.md`.
|
|
8. `git push origin dev` y despliegue verificado en producción (`10.0.0.217` / `https://eduspace.oemspot.com.ar`).
|