feat: login de emergencia admin en /adm/login y despliegue por defecto de auth unico (v3.8.5)

This commit is contained in:
2026-10-21 12:36:15 -03:00
parent 85fa1b389f
commit 836e605697
15 changed files with 540 additions and 49 deletions
+46
View File
@@ -0,0 +1,46 @@
# Plan: 006-login-emergencia-adm - Aislamiento de Login de Emergencia Admin y Despliegue Automático por Proveedor Único
## 1. Arquitectura y Enfoque de Solución
El objetivo es separar el acceso de emergencia para administradores de la pantalla de login general `/auth/login`, eliminar textos informativos y modales que revelen la existencia del acceso de emergencia o del bloqueo local a usuarios generales, y desplegar automáticamente el formulario de autenticación si existe un único proveedor activo (ej. Moodle).
### Componentes Involucrados:
1. **Backend Core (`backend/routers/auth.py`)**:
- Nuevo endpoint REST `POST /api/v1/auth/adm-login` exclusivo para administradores (`is_admin == True`).
- Auditoría estricta (`ADMIN_EMERGENCY_LOGIN_FAILED`, `ADMIN_EMERGENCY_LOGIN_DENIED`, `ADMIN_EMERGENCY_LOGIN_SUCCESS`).
- Retorno de tokens JWT estándar y cookies seguras.
2. **Frontend BFF (`frontend/src/routes/auth.js` y `frontend/src/app.js`)**:
- Rutas `GET /adm/login` y `POST /adm/login` protegidas con `authLimiter`.
- Redirección `GET /adm` -> `/adm/login`.
- Inyección de `is_single_provider` y `active_providers_count` en `GET /login`.
3. **Frontend Vistas (`frontend/views/auth/`)**:
- Nueva plantilla `admin_login.html` sobria, segura y desacoplada de enlaces públicos.
- Limpieza en `login.html`: eliminación del alert "El acceso con contraseña local está deshabilitado..." y del modal `adminEmergencyModal`.
- Soporte para proveedor único: Moodle desplegado por defecto con la clase `.show` si es el único habilitado.
---
## 2. Fases de Implementación
### Fase 1: Backend Core (API FastAPI)
- Agregar endpoint `POST /api/v1/auth/adm-login` en `backend/routers/auth.py`.
- Incorporar auditoría específica y validación de rol `ADMIN`.
- Escribir tests automatizados en `backend/tests/test_adm_login.py`.
### Fase 2: Frontend BFF & Rate Limiter
- Configurar `authLimiter` para `/adm/login` en `frontend/src/app.js`.
- Configurar rutas `GET /adm/login`, `POST /adm/login` y alias `/adm` en `frontend/src/routes/auth.js` o `app.js`.
- Pasar metadatos de proveedores en `GET /login` para identificar si hay un único proveedor habilitado.
### Fase 3: Vistas Nunjucks
- Crear `frontend/views/auth/admin_login.html`.
- Modificar `frontend/views/auth/login.html`:
- Retirar texto y modal de emergencia admin.
- Aplicar apertura automática de Moodle (`collapse show`) si `is_single_provider and providers.moodle`.
- Ocultar divisores redundantes si hay un solo proveedor.
### Fase 4: Pruebas, Verificación y Despliegue
- Ejecutar suite `pytest tests -v` en backend.
- Ejecutar `npx pyright` para verificar 0 errores de tipado.
- Bump de versión a `v3.8.5` (`package.json`, `app.js`, `__init__.py`, `setup.py`, `CHANGELOG.md`, `MEMORY.md`).
- `git add .`, commit y `git push origin dev`.
- Despliegue continuo en LXC Producción `10.0.0.217` (`https://eduspace.oemspot.com.ar`) y verificación HTTP 200 en `/version`.
+45
View File
@@ -0,0 +1,45 @@
# 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`).
+42
View File
@@ -0,0 +1,42 @@
# Tareas: 006-login-emergencia-adm - Aislamiento de Login de Emergencia Admin y Despliegue Automático por Proveedor Único
## Tareas
- [x] **T01: Endpoint Backend `/api/v1/auth/adm-login` y Auditoría**
- **Descripción**: Crear el endpoint `POST /api/v1/auth/adm-login` en `backend/routers/auth.py`. Autenticar credenciales locales y validar estrictamente que el usuario tenga rol `ADMIN` (`is_admin == True`). Emitir eventos de auditoría específicos (`ADMIN_EMERGENCY_LOGIN_FAILED`, `ADMIN_EMERGENCY_LOGIN_DENIED`, `ADMIN_EMERGENCY_LOGIN_SUCCESS`).
- **Hecho cuando**: El endpoint responda 200 con tokens a usuarios admin válidos, 401 a credenciales inválidas y 403 a usuarios no admin.
- **Estimación**: 20 min.
- [x] **T02: Pruebas Automatizadas Backend para Adm Login**
- **Descripción**: Crear archivo de test `backend/tests/test_adm_login.py` cubriendo: autenticación de admin exitosa, rechazo a credenciales erróneas, y rechazo con 403 a usuarios comunes que intenten entrar por la consola de emergencia.
- **Hecho cuando**: `pytest backend/tests/test_adm_login.py` pase al 100%.
- **Estimación**: 15 min.
- [x] **T03: Rutas BFF y Rate Limiting para `/adm/login`**
- **Descripción**: En `frontend/src/app.js` y `frontend/src/routes/auth.js`, configurar `authLimiter` para las solicitudes POST hacia `/adm/login`. Manejar GET `/adm/login` para mostrar la plantilla administrativa y POST `/adm/login` comunicándose con `/api/v1/auth/adm-login` o `/auth/login`. Agregar redirección de `GET /adm` a `/adm/login`.
- **Hecho cuando**: Acceder a `/adm` o `/adm/login` cargue la pantalla correspondiente y las peticiones POST estén protegidas por el limitador.
- **Estimación**: 20 min.
- [x] **T04: Plantilla Nunjucks `admin_login.html`**
- **Descripción**: Crear la vista `frontend/views/auth/admin_login.html` con estética institucional sobria, soporte de modo oscuro/claro, formulario de usuario/contraseña, manejo de errores y sin enlaces visibles hacia la vista pública.
- **Hecho cuando**: La vista renderice correctamente los campos y mensajes de error sin fallos de estilo.
- **Estimación**: 15 min.
- [x] **T05: Limpieza de `/auth/login` y Despliegue por Proveedor Único**
- **Descripción**: En `frontend/src/routes/auth.js` calcular si solo hay 1 proveedor activo (`is_single_provider`). En `frontend/views/auth/login.html`:
1. Eliminar el alert "El acceso con contraseña local está deshabilitado para usuarios generales".
2. Eliminar el modal `adminEmergencyModal`.
3. Si `is_single_provider` y `providers.moodle` es el único activo, agregar la clase `show` a `#moodleLoginForm` para que aparezca abierto de inmediato.
4. Ocultar divisores ("o con credenciales locales") cuando solo haya un único proveedor activo.
- **Hecho cuando**: `/auth/login` no muestre ningún rastro de acceso admin de emergencia y Moodle se despliegue abierto directamente si es el único proveedor.
- **Estimación**: 20 min.
- [x] **T06: Verificación de Código, Pyright y Suite de Pruebas**
- **Descripción**: Ejecutar `npx pyright` verificando 0 errores y correr la suite completa de pruebas `pytest tests -v` en backend.
- **Hecho cuando**: Pyright tenga 0 errores y todos los tests aprueben.
- **Estimación**: 15 min.
- [x] **T07: Bump Semántico a v3.8.5, Git Push y Despliegue en Producción**
- **Descripción**: Incrementar versión a `3.8.5` en `package.json`, `frontend/src/app.js`, `backend/__init__.py`, `backend/setup.py`, `CHANGELOG.md` y `MEMORY.md`. Hacer commit y `git push origin dev`. Desplegar en LXC `10.0.0.217` y verificar HTTP 200 en `/version`.
- **Hecho cuando**: Servidor en producción responda versión `3.8.5` tanto en backend como frontend.
- **Estimación**: 15 min.