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 @@ + + +
+ + +
+ Acceso de Contingencia y Recuperación
+