feat: login de emergencia admin en /adm/login y despliegue por defecto de auth unico (v3.8.5)
This commit is contained in:
@@ -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`.
|
||||
@@ -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`).
|
||||
@@ -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.
|
||||
Reference in New Issue
Block a user