2.9 KiB
2.9 KiB
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:
- Backend Core (
backend/routers/auth.py):- Nuevo endpoint REST
POST /api/v1/auth/adm-loginexclusivo 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.
- Nuevo endpoint REST
- Frontend BFF (
frontend/src/routes/auth.jsyfrontend/src/app.js):- Rutas
GET /adm/loginyPOST /adm/loginprotegidas conauthLimiter. - Redirección
GET /adm->/adm/login. - Inyección de
is_single_provideryactive_providers_countenGET /login.
- Rutas
- Frontend Vistas (
frontend/views/auth/):- Nueva plantilla
admin_login.htmlsobria, 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 modaladminEmergencyModal. - Soporte para proveedor único: Moodle desplegado por defecto con la clase
.showsi es el único habilitado.
- Nueva plantilla
2. Fases de Implementación
Fase 1: Backend Core (API FastAPI)
- Agregar endpoint
POST /api/v1/auth/adm-loginenbackend/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
authLimiterpara/adm/loginenfrontend/src/app.js. - Configurar rutas
GET /adm/login,POST /adm/loginy alias/admenfrontend/src/routes/auth.jsoapp.js. - Pasar metadatos de proveedores en
GET /loginpara 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) siis_single_provider and providers.moodle. - Ocultar divisores redundantes si hay un solo proveedor.
Fase 4: Pruebas, Verificación y Despliegue
- Ejecutar suite
pytest tests -ven backend. - Ejecutar
npx pyrightpara 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 ygit 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.