From 836e605697aaeb59270155bffaa4c1639fd76c2d Mon Sep 17 00:00:00 2001 From: Carlos Tello Date: Wed, 21 Oct 2026 12:36:15 -0300 Subject: [PATCH] feat: login de emergencia admin en /adm/login y despliegue por defecto de auth unico (v3.8.5) --- CHANGELOG.md | 17 +++ MEMORY.md | 16 +-- backend/app/__init__.py | 2 +- backend/routers/auth.py | 68 ++++++++++++ backend/setup.py | 2 +- backend/tests/test_adm_login.py | 95 ++++++++++++++++ frontend/package.json | 2 +- frontend/src/app.js | 9 +- frontend/src/routes/adm.js | 57 ++++++++++ frontend/src/routes/auth.js | 11 +- frontend/views/auth/admin_login.html | 139 ++++++++++++++++++++++++ frontend/views/auth/login.html | 38 +------ specs/006-login-emergencia-adm/plan.md | 46 ++++++++ specs/006-login-emergencia-adm/spec.md | 45 ++++++++ specs/006-login-emergencia-adm/tasks.md | 42 +++++++ 15 files changed, 540 insertions(+), 49 deletions(-) create mode 100644 backend/tests/test_adm_login.py create mode 100644 frontend/src/routes/adm.js create mode 100644 frontend/views/auth/admin_login.html create mode 100644 specs/006-login-emergencia-adm/plan.md create mode 100644 specs/006-login-emergencia-adm/spec.md create mode 100644 specs/006-login-emergencia-adm/tasks.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 8987fd4..31f2dea 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,23 @@ El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1 - **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1. - **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción. +## [3.8.5] - 2026-10-21 +### Added +- **Aislamiento de Login de Emergencia ADMIN en `/adm/login` (Spec 006)**: + - Enrutador dedicado `/adm` y vista `/adm/login` en Frontend BFF con rate limiting (`authLimiter`). + - Endpoint REST `POST /api/v1/auth/adm-login` en backend FastAPI exclusivo para administradores (`is_admin == True`), emitiendo auditoría explícita (`ADMIN_EMERGENCY_LOGIN_SUCCESS`, `ADMIN_EMERGENCY_LOGIN_DENIED`, `ADMIN_EMERGENCY_LOGIN_FAILED`). + - Redirección de conveniencia desde `/adm` hacia `/adm/login`. + - Nueva plantilla Nunjucks sobria y segura `frontend/views/auth/admin_login.html`. +- **Despliegue Automático por Proveedor Único**: + - Detección reactiva de proveedores activos en `frontend/src/routes/auth.js`. + - Si Moodle es el único proveedor institucional habilitado, se presenta desplegado automáticamente (`show`) con los campos de credenciales accesibles de inmediato. + - Eliminación de divisores superfluos cuando existe un solo modo de autenticación activo. + +### Removed +- **Limpieza de Interfaz Pública en `/auth/login`**: + - Eliminado el mensaje informativo *"El acceso con contraseña local está deshabilitado para usuarios generales"*. + - Eliminado el modal público `adminEmergencyModal` (*"Acceso de Emergencia ADMIN"*), evitando la exposición innecesaria de accesos administrativos a usuarios finales y posibles atacantes. + ## [3.8.4] - 2026-10-21 ### Fixed - **Resolución Rigurosa de Tipado Estático y Cero Diagnósticos LSP (Principio 10)**: diff --git a/MEMORY.md b/MEMORY.md index 83293f6..d5bbb32 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -9,13 +9,15 @@ Memoria del proyecto entre sesiones para la rama `dev`. - Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables. - Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación. - Reinicialización segura del sistema con contraseña de Administrador. -- **Sprint Activo: Cero Diagnósticos LSP y Tipado Estático — v3.8.4**: - - **Resolución Rigurosa de Tipado en Modelos y Routers**: - - `Career.subjects` y `Subject.commissions` / `Subject.careers`: Retiradas las anotaciones de lista en relaciones que desorientaban a SQLAlchemy y Pyright, permitiendo inferir descriptores `InstrumentedAttribute` con soporte completo de `.any()` en queries de `academic.py`. - - `Career.to_dict()`: Conteo protegido con `isinstance(subs, (list, set, tuple))` satisfaciendo el protocolo `Sized`. - - `sheets_importer.py`: Normalizaciones de `manual_dt`, `date_from_dt`, `date_to_dt` y `row_specific_date` evaluando `datetime` previo a `date` (`isinstance(d, datetime)` antes de `isinstance(d, date)`), erradicando advertencias de comparación cruzada. - - **Suite de Pruebas Automatizadas**: 62 pruebas ejecutadas con pytest pasando al 100% (62 passed, 0 failed). Cero errores en código (`@[current_problems]`). Pyright `0 errors, 0 warnings`. - - **Versión Consolidada**: `v3.8.4`. +- **Sprint Activo: Aislamiento de Login de Emergencia Admin y Despliegue de Auth Único — v3.8.5**: + - **Aislamiento de Login Admin de Emergencia**: + - Creado enrutador y vista `/adm/login` (con redirección `/adm` -> `/adm/login`) para administradores de contingencia, protegido con `authLimiter`. + - Endpoint REST dedicado `POST /api/v1/auth/adm-login` en FastAPI que restringe estrictamente el acceso a roles `ADMIN` y emite logs de auditoría segregados (`ADMIN_EMERGENCY_LOGIN_SUCCESS`, `ADMIN_EMERGENCY_LOGIN_DENIED`, `ADMIN_EMERGENCY_LOGIN_FAILED`). + - Eliminados de la vista pública `/auth/login` el mensaje *"El acceso con contraseña local está deshabilitado para usuarios generales"* y el modal *"Acceso de Emergencia ADMIN"*. + - **Despliegue Automático por Proveedor Único**: + - Detección en BFF (`is_single_provider`). Si únicamente Moodle está habilitado, el formulario de login aparece expandido (`show`) de forma predeterminada, sin divisores redundantes ni pasos extra. + - **Suite de Pruebas y Tipado**: 66 pruebas ejecutadas con pytest pasando al 100% (66 passed, 0 failed). Cero errores en código (`@[current_problems]`). Pyright `0 errors, 0 warnings`. + - **Versión Consolidada**: `v3.8.5`. ## Decisiones (y por qué) - **Flujo Secuencial de Bedelía (9 Pasos)**: Estandarizar la carga operativa en: 1) Sede -> 2) Aula -> 3) Ciclo Lectivo -> 4) Carrera -> 5) Materia (vinculada a Carrera) -> 6) Comisión (asociada a Materia, Carrera y Ciclo) -> 7) Profesores -> 8) Alumnos -> 9) Reserva de Espacio. Esto asegura consistencia e integridad relacional. diff --git a/backend/app/__init__.py b/backend/app/__init__.py index 43757af..fe2e53c 100644 --- a/backend/app/__init__.py +++ b/backend/app/__init__.py @@ -7,7 +7,7 @@ from typing import Any from database import db, get_db, engine, SessionLocal, session from config.config import Config -__version__ = "3.8.4" +__version__ = "3.8.5" class DummyContext: def __enter__(self): diff --git a/backend/routers/auth.py b/backend/routers/auth.py index b0e9267..1ca589c 100644 --- a/backend/routers/auth.py +++ b/backend/routers/auth.py @@ -121,6 +121,74 @@ def login(payload: LoginRequest, response: Response): } +@auth_router.post("/adm-login") +def adm_login(payload: LoginRequest, response: Response): + """Inicio de sesión administrativo de emergencia/contingencia.""" + user = user_service.authenticate(payload.email, payload.password) + if not user: + AuditService.log( + action='ADMIN_EMERGENCY_LOGIN_FAILED', + module='auth', + user_email=payload.email, + details=f"Intento fallido en consola de emergencia ADMIN para {payload.email}." + ) + raise HTTPException( + status_code=status.HTTP_401_UNAUTHORIZED, + detail="Credenciales de acceso incorrectas o cuenta inactiva." + ) + + is_admin = user.is_admin() or getattr(user, 'role', '').upper() == 'ADMIN' + if not is_admin: + AuditService.log( + action='ADMIN_EMERGENCY_LOGIN_DENIED', + module='auth', + user=user, + entity_id=user.id, + details=f"Usuario sin privilegios de administrador ({user.email}) intentó acceder por consola de emergencia." + ) + raise HTTPException( + status_code=status.HTTP_403_FORBIDDEN, + detail="Acceso denegado. Esta consola de emergencia está reservada exclusivamente a administradores del sistema." + ) + + AuditService.log( + action='ADMIN_EMERGENCY_LOGIN_SUCCESS', + module='auth', + user=user, + entity_id=user.id, + details=f"Acceso de emergencia exitoso a consola administrativa - Usuario: {user.email}" + ) + + tokens = JWTService.generate_tokens(user) + profile = user_service.get_profile_data(user) + + response.set_cookie( + key="access_token", + value=tokens["access_token"], + httponly=True, + samesite="lax", + path="/" + ) + response.set_cookie( + key="refresh_token", + value=tokens["refresh_token"], + httponly=True, + samesite="lax", + max_age=7 * 24 * 3600, + path="/api/v1/auth/refresh" + ) + + return { + 'status': 'success', + 'access_token': tokens['access_token'], + 'refresh_token': tokens['refresh_token'], + 'token_type': tokens['token_type'], + 'expires_in': tokens['expires_in'], + 'user': profile + } + + + @auth_router.post("/google") def google_auth(payload: GoogleAuthRequest, response: Response): """Inicio de sesión delegado institucional Google OAuth 2.0.""" diff --git a/backend/setup.py b/backend/setup.py index 240c62e..ee1211a 100644 --- a/backend/setup.py +++ b/backend/setup.py @@ -2,7 +2,7 @@ from setuptools import setup, find_packages setup( name="edu-space-admin", - version="3.8.4", + version="3.8.5", description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)", author="Edu-Space Development Team", author_email="admin@edu-space.com", diff --git a/backend/tests/test_adm_login.py b/backend/tests/test_adm_login.py new file mode 100644 index 0000000..9fd7d48 --- /dev/null +++ b/backend/tests/test_adm_login.py @@ -0,0 +1,95 @@ +""" +Tests for Admin Emergency Login endpoint (/api/v1/auth/adm-login). +""" +from fastapi.testclient import TestClient +from werkzeug.security import generate_password_hash +from main import app +from app.models.user import User + + +def test_adm_login_success(init_database): + """Admin credentials allow successful login in emergency endpoint.""" + client = TestClient(app) + admin = User( + email="emergency.admin@unicaba.edu.ar", + name="Emergency Administrator", + password_hash=generate_password_hash("AdminPass123!"), + role="ADMIN", + is_active=True + ) + init_database.session.add(admin) + init_database.session.commit() + + res = client.post('/api/v1/auth/adm-login', json={ + 'email': 'emergency.admin@unicaba.edu.ar', + 'password': 'AdminPass123!' + }) + assert res.status_code == 200 + data = res.json() + assert data['status'] == 'success' + assert 'access_token' in data + assert 'refresh_token' in data + assert data['user']['role'].upper() == 'ADMIN' + assert 'access_token' in res.cookies + + +def test_adm_login_invalid_credentials(init_database): + """Wrong credentials return 401 Unauthorized.""" + client = TestClient(app) + admin = User( + email="admin.wrongpass@unicaba.edu.ar", + name="Admin Wrong Pass", + password_hash=generate_password_hash("CorrectPass123!"), + role="ADMIN", + is_active=True + ) + init_database.session.add(admin) + init_database.session.commit() + + res = client.post('/api/v1/auth/adm-login', json={ + 'email': 'admin.wrongpass@unicaba.edu.ar', + 'password': 'BadPassword!' + }) + assert res.status_code == 401 + assert "incorrectas" in res.json()['detail'].lower() + + +def test_adm_login_denied_for_regular_user(init_database): + """Regular users (Docente/Estudiante) cannot use emergency admin login, receiving 403.""" + client = TestClient(app) + teacher = User( + email="profesor.test@unicaba.edu.ar", + name="Profesor Test", + password_hash=generate_password_hash("DocentePass123!"), + role="DOCENTE", + is_active=True + ) + init_database.session.add(teacher) + init_database.session.commit() + + res = client.post('/api/v1/auth/adm-login', json={ + 'email': 'profesor.test@unicaba.edu.ar', + 'password': 'DocentePass123!' + }) + assert res.status_code == 403 + assert "exclusivamente a administradores" in res.json()['detail'].lower() + + +def test_adm_login_inactive_user(init_database): + """Inactive admin cannot log in, receiving 401.""" + client = TestClient(app) + admin = User( + email="inactive.admin@unicaba.edu.ar", + name="Inactive Admin", + password_hash=generate_password_hash("Pass123!"), + role="ADMIN", + is_active=False + ) + init_database.session.add(admin) + init_database.session.commit() + + res = client.post('/api/v1/auth/adm-login', json={ + 'email': 'inactive.admin@unicaba.edu.ar', + 'password': 'Pass123!' + }) + assert res.status_code == 401 diff --git a/frontend/package.json b/frontend/package.json index 84c5c61..83655c9 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,6 +1,6 @@ { "name": "frontend", - "version": "3.8.4", + "version": "3.8.5", "description": "", "main": "index.js", "scripts": { diff --git a/frontend/src/app.js b/frontend/src/app.js index f7c871d..3e5d4ff 100644 --- a/frontend/src/app.js +++ b/frontend/src/app.js @@ -66,6 +66,7 @@ const generalLimiter = rateLimit({ }); app.post('/auth/login', authLimiter); app.post('/auth/moodle', authLimiter); +app.post('/adm/login', authLimiter); app.use('/api', generalLimiter); // Configuración de middlewares con soporte para importaciones masivas y payloads extensos @@ -85,9 +86,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), { }); // Versiones institucionales del sistema -const APP_VERSION = '3.8.4'; -const FRONTEND_VERSION = '3.8.4'; -const BACKEND_VERSION = '3.8.4'; +const APP_VERSION = '3.8.5'; +const FRONTEND_VERSION = '3.8.5'; +const BACKEND_VERSION = '3.8.5'; env.addGlobal('app_version', APP_VERSION); env.addGlobal('frontend_version', FRONTEND_VERSION); @@ -303,6 +304,7 @@ app.get('/version', (req, res) => { // Rutas Principales const indexRoutes = require('./routes/index'); const authRoutes = require('./routes/auth'); +const admRoutes = require('./routes/adm'); const dashboardRoutes = require('./routes/dashboard'); const classroomsRoutes = require('./routes/classrooms'); const scheduleRoutes = require('./routes/schedule'); @@ -338,6 +340,7 @@ app.use('/api/v1', async (req, res) => { app.use('/', indexRoutes); app.use('/auth', authRoutes); +app.use('/adm', admRoutes); app.use('/dashboard', dashboardRoutes); app.use('/classrooms', classroomsRoutes); app.use('/schedule', scheduleRoutes); diff --git a/frontend/src/routes/adm.js b/frontend/src/routes/adm.js new file mode 100644 index 0000000..1416480 --- /dev/null +++ b/frontend/src/routes/adm.js @@ -0,0 +1,57 @@ +const express = require('express'); +const router = express.Router(); +const apiClient = require('../services/apiClient'); + +const isSecureCookie = (req) => { + if (process.env.COOKIE_SECURE === 'true') return true; + if (process.env.COOKIE_SECURE === 'false') return false; + return Boolean(req.secure || req.protocol === 'https' || req.get('x-forwarded-proto') === 'https'); +}; + +// Redirección de conveniencia /adm a /adm/login +router.get('/', (req, res) => { + res.redirect('/adm/login'); +}); + +// Vista de autenticación de emergencia exclusiva para administradores +router.get('/login', (req, res) => { + res.render('auth/admin_login', { + error: req.query.error || null + }); +}); + +// Procesamiento de credenciales de emergencia de administración +router.post('/login', async (req, res) => { + try { + const email = req.body.username || req.body.email; + const password = req.body.password; + + if (!email || !password) { + return res.redirect('/adm/login?error=' + encodeURIComponent('Por favor complete todos los campos requeridos.')); + } + + const response = await apiClient.post('/auth/adm-login', { + email, + password + }); + + const token = response.data.access_token; + if (token) { + res.cookie('auth_token', token, { + httpOnly: true, + secure: isSecureCookie(req), + sameSite: 'lax', + maxAge: 24 * 60 * 60 * 1000 // 1 día + }); + return res.redirect('/dashboard'); + } + + return res.redirect('/adm/login?error=' + encodeURIComponent('Autenticación administrativa fallida.')); + } catch (error) { + console.error('Admin emergency login error:', error.response?.data || error.message); + const errorMsg = error.response?.data?.detail || error.response?.data?.message || 'Credenciales de acceso incorrectas o cuenta no autorizada.'; + return res.redirect('/adm/login?error=' + encodeURIComponent(errorMsg)); + } +}); + +module.exports = router; diff --git a/frontend/src/routes/auth.js b/frontend/src/routes/auth.js index 81e79d3..8ed3a1b 100644 --- a/frontend/src/routes/auth.js +++ b/frontend/src/routes/auth.js @@ -27,14 +27,23 @@ router.get('/login', async (req, res) => { console.warn('Providers fetch notice in login:', e.message); } + const activeProvidersCount = (providers.local ? 1 : 0) + (providers.google ? 1 : 0) + (providers.moodle ? 1 : 0); + const isSingleProvider = activeProvidersCount === 1; + res.render('auth/login', { error: req.query.error || null, providers, google_client_id, - demo_access_enabled + demo_access_enabled, + active_providers_count: activeProvidersCount, + is_single_provider: isSingleProvider }); }); +router.get('/adm/login', (req, res) => { + res.redirect('/adm/login'); +}); + router.post('/login', async (req, res) => { try { const username = req.body.username || req.body.email; diff --git a/frontend/views/auth/admin_login.html b/frontend/views/auth/admin_login.html new file mode 100644 index 0000000..5501c3e --- /dev/null +++ b/frontend/views/auth/admin_login.html @@ -0,0 +1,139 @@ + + + + + + Consola de Emergencia - Edu-Space Admin + + + + + + + + + + + + + + + +
+
+ +
+
+ +
+ + +
+ + Consola Administrativa + +
+

Edu-Space Admin

+

Acceso de Contingencia y Recuperación

+
+ +
+ + {% if error %} + + {% endif %} + + +
+
+ +
+ + + + +
+
+ +
+ +
+ + + + + +
+
+ +
+ +
+
+ +
+ + + Acceso restringido • Todos los intentos son registrados y auditados + +
+ + v{{ app_version or '3.8.5' }} + +
+
+
+
+
+ + + + + + diff --git a/frontend/views/auth/login.html b/frontend/views/auth/login.html index d1cfa92..464122e 100644 --- a/frontend/views/auth/login.html +++ b/frontend/views/auth/login.html @@ -117,12 +117,12 @@ {% endif %} {% if providers.moodle %} - -
+
@@ -142,7 +142,7 @@ {% endif %}
- {% if not providers or providers.local %} + {% if (not is_single_provider) and (not providers or providers.local) and (providers.google or providers.moodle) %}
o con credenciales locales
{% endif %} {% endif %} @@ -181,13 +181,6 @@
- {% else %} -
- El acceso con contraseña local está deshabilitado para usuarios generales. - -
{% endif %} {% if demo_access_enabled %} @@ -232,31 +225,6 @@
- - - diff --git a/specs/006-login-emergencia-adm/plan.md b/specs/006-login-emergencia-adm/plan.md new file mode 100644 index 0000000..73ca444 --- /dev/null +++ b/specs/006-login-emergencia-adm/plan.md @@ -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`. diff --git a/specs/006-login-emergencia-adm/spec.md b/specs/006-login-emergencia-adm/spec.md new file mode 100644 index 0000000..e81b4bf --- /dev/null +++ b/specs/006-login-emergencia-adm/spec.md @@ -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`). diff --git a/specs/006-login-emergencia-adm/tasks.md b/specs/006-login-emergencia-adm/tasks.md new file mode 100644 index 0000000..d956069 --- /dev/null +++ b/specs/006-login-emergencia-adm/tasks.md @@ -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.