diff --git a/CHANGELOG.md b/CHANGELOG.md index 51de1aa..039c46c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,22 @@ 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.46] - 2026-10-28 +### Added & Security (Rotación Dinámica de Código QR cada 3 Segundos y Configuración Global) +- **Rotación Dinámica de Código QR Anti-Captura (3 Segundos)**: + - Se implementó la renovación automática del código QR cada 3 segundos en el modal global (`user_qr_modal.html`), en el perfil de usuario (`profile.html`) y en la credencial completa (`card.html`). + - Se incorporó una barra de progreso animada con gradiente y contador en vivo en milisegundos que exhibe visualmente la rotación activa y la protección anti-screenshot / anti-fraude. + - El bucle de rotación se pausa automáticamente cuando el modal se cierra o la pestaña pasa a segundo plano (`visibilitychange`), optimizando recursos de red y CPU. +- **Configuración Global Parametrizada (`SystemSetting`)**: + - Se agregaron las variables de configuración `qr_renewal_interval_seconds` (por defecto: 3s) y `qr_token_grace_period_seconds` (por defecto: 60s) en backend `SystemSetting`. + - Se creó una nueva pestaña en el panel de Configuración Global (`/admin/settings` -> *Credencial QR & Acceso*) con formulario de ajuste, selector de accesos directos (3s, 5s, 10s, 30s) y explicación técnica de la ventana de gracia criptográfica. + - Endpoints expuestos: `POST /api/v1/settings/security-qr` y `GET /api/v1/settings/all`. +- **Servicio Criptográfico `QRSecurityService` y Endpoint de Recepción**: + - `QRSecurityService.generate_qr_token` ahora admite `valid_seconds`, generando un JWT firmado con identificador único (`jti`), marca temporal (`iat`) y ventana de expiración controlada por la configuración de gracia. + - El endpoint `/api/v1/reception/my-qr-token` entrega en su payload el parámetro `renewal_interval_seconds` para que los clientes web ajusten su ciclo de renovación de forma dinámica. +- **Suite de Pruebas Automatizadas**: + - Se incorporaron pruebas unitarias y de integración en `tests/test_benefits_and_reception.py` verificando la entrega del parámetro y la actualización de los valores de configuración en caliente (118/118 pruebas superadas con éxito). + ## [3.8.45] - 2026-10-28 ### Added & UX (Acceso Global a Credencial Digital QR y Código QR Dinámico en Perfil de Usuario) - **Botón Global de Acceso a Credencial QR (`qr-credential-btn`)**: diff --git a/MEMORY.md b/MEMORY.md index ecf5203..e07d217 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -9,11 +9,11 @@ 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: Acceso Global a Credencial Digital QR y Código QR Dinámico en Perfil (v3.8.45)**: - - **Botón Global QR junto al Botón de Tema**: Incorporación del botón `.qr-credential-btn` en el footer del sidebar (`sidebar-footer`) y en la cabecera móvil (`mobile-header`), abriendo el modal `#userQrCredentialModal` para visualización y regeneración inmediata de la credencial QR del usuario. - - **Código QR Dinámico en Perfil (`/auth/profile`)**: Tarjeta destacada de Credencial Universitaria con renderizado de QR firmado, datos de DNI, rol y renovación interactiva en tiempo real. - - **Endpoint BFF `/credential/token`**: Endpoint en Express para provisión de tokens criptográficos firmados con HMAC y tiempo de validez de 72hs. - - **Versión Consolidada**: `v3.8.45`. +- **Sprint Activo: Rotación Dinámica de Código QR (3s) y Configuración Global (v3.8.46)**: + - **Rotación Dinámica de Código QR Anti-Captura (3 Segundos)**: Renovación automática del código QR cada 3 segundos en el modal global (`user_qr_modal.html`), en el perfil de usuario (`profile.html`) y en el carnet completo (`card.html`) con barra de progreso animada y contador en vivo. + - **Configuración Global Parametrizada (`SystemSetting`)**: Variables `qr_renewal_interval_seconds` (default 3s) y `qr_token_grace_period_seconds` (default 60s) configurables en el panel de Configuración Global (`/admin/settings` -> *Credencial QR & Acceso*) y respaldadas por `POST /api/v1/settings/security-qr`. + - **Criptografía y Recepción**: `QRSecurityService.generate_qr_token` con soporte de `valid_seconds`, payload dinámico en `/api/v1/reception/my-qr-token` y 118/118 tests automatizados pasando exitosamente. + - **Versión Consolidada**: `v3.8.46`. ## 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 7b77603..bbc3152 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.45" +__version__ = "3.8.46" class DummyContext: def __enter__(self): diff --git a/backend/app/services/qr_security_service.py b/backend/app/services/qr_security_service.py index 388dc24..47760e6 100644 --- a/backend/app/services/qr_security_service.py +++ b/backend/app/services/qr_security_service.py @@ -32,12 +32,19 @@ class QRSecurityService: return getattr(Config, 'SECRET_KEY', 'unicaba-secret-qr-key') @classmethod - def generate_qr_token(cls, user: User, hours_valid: int = DEFAULT_VALID_HOURS) -> str: + def generate_qr_token( + cls, + user: User, + hours_valid: int = DEFAULT_VALID_HOURS, + valid_seconds: Optional[int] = None + ) -> str: """ Emite un token JWT firmado de credencial institucional para el usuario. Contiene identificación, rol, DNI y tiempo de expiración. + Soporta valid_seconds para tokens dinámicos rotativos anti-captura. """ now = datetime.now(timezone.utc) + exp_delta = timedelta(seconds=valid_seconds) if valid_seconds is not None else timedelta(hours=hours_valid) payload = { "sub": str(user.id), "dni": user.document_number or "", @@ -46,7 +53,7 @@ class QRSecurityService: "type": cls.QR_TOKEN_TYPE, "jti": str(uuid.uuid4())[:8], "iat": now, - "exp": now + timedelta(hours=hours_valid) + "exp": now + exp_delta } return jwt.encode(payload, cls._get_secret(), algorithm="HS256") diff --git a/backend/routers/admin.py b/backend/routers/admin.py index cac17f6..3fa06c5 100644 --- a/backend/routers/admin.py +++ b/backend/routers/admin.py @@ -874,6 +874,11 @@ def get_all_settings(current_user: User = Depends(require_roles(["ADMIN"]))): 'output_limit': int(SystemSetting.get_value('ai_chat_output_limit', 65536) or 65536) } + security_qr = { + 'renewal_interval_seconds': int(SystemSetting.get_value('qr_renewal_interval_seconds', 3) or 3), + 'grace_period_seconds': int(SystemSetting.get_value('qr_token_grace_period_seconds', 60) or 60) + } + return { 'status': 'success', 'settings': { @@ -883,7 +888,8 @@ def get_all_settings(current_user: User = Depends(require_roles(["ADMIN"]))): 'moodle': moodle_config, 'ui': ui_config, 'ai': ai_config, - 'ai_assistant': ai_config + 'ai_assistant': ai_config, + 'security_qr': security_qr } } @@ -1076,6 +1082,64 @@ async def update_ui_settings( } +@admin_router.post("/settings/security-qr") +@admin_router.post("/admin/settings/security-qr") +async def update_security_qr_settings( + request: Request, + current_user: User = Depends(require_roles(["ADMIN"])) +): + """Actualiza la configuración de rotación y validez de las credenciales QR dinámicas.""" + data = await get_request_payload(request) + try: + renewal_sec = int(data.get('renewal_interval_seconds', 3) or 3) + except (ValueError, TypeError): + renewal_sec = 3 + + try: + grace_sec = int(data.get('grace_period_seconds', 60) or 60) + except (ValueError, TypeError): + grace_sec = 60 + + if renewal_sec < 1: + renewal_sec = 1 + if renewal_sec > 300: + renewal_sec = 300 + + if grace_sec < renewal_sec: + grace_sec = renewal_sec * 5 + if grace_sec > 3600: + grace_sec = 3600 + + SystemSetting.set_value( + 'qr_renewal_interval_seconds', + str(renewal_sec), + 'Intervalo de renovación dinámica de QR (segundos)', + category='security' + ) + SystemSetting.set_value( + 'qr_token_grace_period_seconds', + str(grace_sec), + 'Período de gracia y validez de tokens QR (segundos)', + category='security' + ) + + AuditService.log( + action='UPDATE_SECURITY_QR_SETTINGS', + module='settings', + user=current_user, + details=f"Parámetros QR actualizados: renovación={renewal_sec}s, gracia={grace_sec}s" + ) + + return { + 'status': 'success', + 'message': f'Configuración de credenciales QR guardada: renovación cada {renewal_sec} segundos.', + 'security_qr': { + 'renewal_interval_seconds': renewal_sec, + 'grace_period_seconds': grace_sec + } + } + + @admin_router.post("/settings/ai") @admin_router.post("/admin/settings/ai") async def update_ai_settings( diff --git a/backend/routers/reception.py b/backend/routers/reception.py index b51dd4e..d0f0fe6 100644 --- a/backend/routers/reception.py +++ b/backend/routers/reception.py @@ -6,6 +6,7 @@ from app import db from app.models.user import User from app.models.building import Building from app.models.access_log_qr import AccessLogQR +from app.models.setting import SystemSetting from app.services.audit_service import AuditService from app.services.qr_security_service import QRSecurityService from dependencies import get_current_user, require_roles @@ -146,8 +147,12 @@ def get_my_credential_qr_token( """ Genera y entrega el token criptográfico del código QR para la credencial digital del usuario autenticado (estudiante o docente). + Soporta rotación dinámica periódica (default 3s) configurada en SystemSetting. """ - token = QRSecurityService.generate_qr_token(current_user) + renewal_seconds = int(SystemSetting.get_value('qr_renewal_interval_seconds', 3) or 3) + grace_seconds = int(SystemSetting.get_value('qr_token_grace_period_seconds', 60) or 60) + + token = QRSecurityService.generate_qr_token(current_user, valid_seconds=grace_seconds) return { "status": "success", "qr_token": token, @@ -155,5 +160,7 @@ def get_my_credential_qr_token( "user_name": current_user.name, "user_dni": current_user.document_number, "user_role": (current_user.role or "ALUMNO").upper(), - "expires_in_hours": QRSecurityService.DEFAULT_VALID_HOURS + "expires_in_hours": QRSecurityService.DEFAULT_VALID_HOURS, + "renewal_interval_seconds": renewal_seconds, + "grace_period_seconds": grace_seconds } diff --git a/backend/setup.py b/backend/setup.py index 8005f76..0de4e3b 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.45", + version="3.8.46", 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_benefits_and_reception.py b/backend/tests/test_benefits_and_reception.py index 9b54cdb..c60ea7a 100644 --- a/backend/tests/test_benefits_and_reception.py +++ b/backend/tests/test_benefits_and_reception.py @@ -229,6 +229,51 @@ def test_reception_my_qr_token_endpoint(init_database): assert data["status"] == "success" assert "qr_token" in data assert data["user_name"] == "Valeria Paz" + assert "renewal_interval_seconds" in data + assert data["renewal_interval_seconds"] == 3 + assert "grace_period_seconds" in data + assert data["grace_period_seconds"] == 60 + + +def test_security_qr_settings_configuration(init_database): + """Verifica que el Administrador pueda configurar el tiempo de renovación desde Configuración Global.""" + client = TestClient(app) + admin = _get_or_create_user("test_admin_qr_config@unicaba.edu.ar", "Admin General", "ADMIN") + admin_tokens = JWTService.generate_tokens(admin) + admin_headers = {"Authorization": f"Bearer {admin_tokens['access_token']}"} + + # 1. Modificar parámetro a 5 segundos de rotación y 90 de gracia + resp = client.post( + "/api/v1/settings/security-qr", + json={"renewal_interval_seconds": 5, "grace_period_seconds": 90}, + headers=admin_headers + ) + assert resp.status_code == 200 + data = resp.json() + assert data["status"] == "success" + assert data["security_qr"]["renewal_interval_seconds"] == 5 + assert data["security_qr"]["grace_period_seconds"] == 90 + + # 2. Verificar que /settings/all reporte el nuevo valor + all_resp = client.get("/api/v1/settings/all", headers=admin_headers) + assert all_resp.status_code == 200 + all_settings = all_resp.json()["settings"] + assert "security_qr" in all_settings + assert all_settings["security_qr"]["renewal_interval_seconds"] == 5 + + # 3. Verificar que /reception/my-qr-token refleje los 5 segundos + student = _get_or_create_user("test_student_renew@unicaba.edu.ar", "Martín Fierro", "ALUMNO") + student_tokens = JWTService.generate_tokens(student) + token_resp = client.get("/api/v1/reception/my-qr-token", headers={"Authorization": f"Bearer {student_tokens['access_token']}"}) + assert token_resp.status_code == 200 + assert token_resp.json()["renewal_interval_seconds"] == 5 + + # 4. Restaurar a 3 segundos (default) + client.post( + "/api/v1/settings/security-qr", + json={"renewal_interval_seconds": 3, "grace_period_seconds": 60}, + headers=admin_headers + ) def test_live_context_benefit_search_integration(init_database): diff --git a/frontend/package.json b/frontend/package.json index e8d2cd0..9c7ea6c 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,6 +1,6 @@ { "name": "frontend", - "version": "3.8.45", + "version": "3.8.46", "description": "", "main": "index.js", "scripts": { diff --git a/frontend/src/app.js b/frontend/src/app.js index 0f183a9..39ddf1b 100644 --- a/frontend/src/app.js +++ b/frontend/src/app.js @@ -86,9 +86,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), { }); // Versiones institucionales del sistema -const APP_VERSION = '3.8.45'; -const FRONTEND_VERSION = '3.8.45'; -const BACKEND_VERSION = '3.8.45'; +const APP_VERSION = '3.8.46'; +const FRONTEND_VERSION = '3.8.46'; +const BACKEND_VERSION = '3.8.46'; env.addGlobal('app_version', APP_VERSION); env.addGlobal('frontend_version', FRONTEND_VERSION); diff --git a/frontend/src/routes/admin.js b/frontend/src/routes/admin.js index c075d0a..4fa74b5 100644 --- a/frontend/src/routes/admin.js +++ b/frontend/src/routes/admin.js @@ -1794,6 +1794,10 @@ const handleGlobalSettings = async (req, res) => { } if (settings) { settings.ui = settings.ui || { show_role_banner: true }; + settings.security_qr = settings.security_qr || { + renewal_interval_seconds: 3, + grace_period_seconds: 60 + }; } try { @@ -1893,6 +1897,7 @@ router.post('/settings/moodle/test', forwardSettingsAction); router.post('/settings/moodle/sync', forwardSettingsAction); router.get('/settings/moodle/stats', forwardSettingsAction); router.post('/settings/ui', forwardSettingsAction); +router.post('/settings/security-qr', forwardSettingsAction); router.post('/settings/ai', forwardSettingsAction); router.post('/settings/ai/test', forwardSettingsAction); router.post('/settings/reset_system', forwardSettingsAction); diff --git a/frontend/src/routes/credential.js b/frontend/src/routes/credential.js index bfabe3c..bcd38d0 100644 --- a/frontend/src/routes/credential.js +++ b/frontend/src/routes/credential.js @@ -7,12 +7,14 @@ router.use(requireAuth); router.get(['/my-card', '/', '/mi-credencial'], async (req, res) => { let qrToken = ''; let expiresInHours = 72; + let renewalIntervalSeconds = 3; try { const resp = await req.apiClient.get('/reception/my-qr-token'); if (resp.data) { qrToken = resp.data.qr_token || ''; expiresInHours = resp.data.expires_in_hours || 72; + renewalIntervalSeconds = resp.data.renewal_interval_seconds || 3; } } catch (err) { console.warn('QR token generation notice:', err.message); @@ -22,7 +24,8 @@ router.get(['/my-card', '/', '/mi-credencial'], async (req, res) => { title: 'Mi Credencial Digital — UniCABA', user: req.user, qrToken, - expiresInHours + expiresInHours, + renewalIntervalSeconds }); }); @@ -41,7 +44,8 @@ router.get('/token', async (req, res) => { user_name: req.user?.name || '', user_dni: req.user?.document_number || '', user_role: (req.user?.role || 'ALUMNO').toUpperCase(), - expires_in_hours: 72 + expires_in_hours: 72, + renewal_interval_seconds: 3 }); } }); diff --git a/frontend/views/admin/settings/global_config.html b/frontend/views/admin/settings/global_config.html index f5e99e9..c59bbaf 100644 --- a/frontend/views/admin/settings/global_config.html +++ b/frontend/views/admin/settings/global_config.html @@ -93,6 +93,11 @@ Asistente IA & LLM Local +