From 4668117c35ada47eaa9fd3355210d8ef830e1805 Mon Sep 17 00:00:00 2001 From: Carlos Tello Date: Wed, 28 Oct 2026 13:32:30 -0300 Subject: [PATCH] feat(reception): add strict anti-capture expiration to dynamic QR and fix Buenos Aires timezone display (v3.8.49) --- CHANGELOG.md | 11 ++++ MEMORY.md | 11 ++-- backend/app/__init__.py | 2 +- backend/app/services/qr_security_service.py | 53 ++++++++++---------- backend/routers/reception.py | 49 +++++++++++++++--- backend/schemas/reception_dto.py | 2 + backend/setup.py | 2 +- backend/tests/test_benefits_and_reception.py | 11 +++- frontend/package.json | 2 +- frontend/src/app.js | 6 +-- frontend/src/routes/reception.js | 19 ++++++- frontend/views/reception/scanner.html | 21 +++++++- 12 files changed, 138 insertions(+), 51 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 682a0d4..b340842 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,17 @@ 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.49] - 2026-10-28 +### Added & Fixed (Anti-Captura Estricto en QR Dinámico, Corrección de Zona Horaria de Buenos Aires y Registro Óptico) +- **Corrección Integral del Desfasaje Horario en Registros de Ingreso**: + - Se corrigió el desfasaje de 3 horas en la visualización de ingresos en la Consola de Recepción (`/reception/scanner`), donde los registros se mostraban en hora UTC (16:18 hs) en lugar de la hora local argentina (13:18 hs). + - Se implementó la función `to_argentina_time` en el backend (`reception.py`) para convertir los datetimes a la zona horaria oficial `America/Argentina/Buenos_Aires` (UTC-3), poblando el nuevo atributo `scanned_time` ("HH:MM hs"). + - En el frontend (`reception.js` y `scanner.html`), se adaptaron tanto el render inicial de Nunjucks como las actualizaciones AJAX periódicas para formatear la hora en la zona horaria institucional de Buenos Aires. +- **Ventana Estricta Anti-Captura de Pantalla en el QR Dinámico**: + - Se ajustó el periodo de gracia y expiración del token JWT dinámico (`valid_seconds`) reduciéndolo de 60 segundos al valor estricto de seguridad de 6 segundos (por defecto `renewal_seconds + 3`). + - Esto garantiza que cualquier captura de pantalla o fotografía tomada al código QR expire a los pocos segundos, siendo categóricamente rechazada por el backend si han transcurrido 10 segundos o más (`jwt.ExpiredSignatureError`). + - Se priorizó la validación criptográfica estricta de JWT en `QRSecurityService.decode_and_resolve_user` con mensaje claro de advertencia al operador: *"La credencial digital ha expirado (anti-captura activo). Renueve el código en la pantalla del usuario."* + ## [3.8.48] - 2026-10-28 ### Added & Fixed (Optimización de Respuestas de UdeCi, Control Óptico en Recepción y Normalización de Teclado Español) - **Fidelidad Fáctica y Listados Directos de Comisiones y Docentes en UdeCi**: diff --git a/MEMORY.md b/MEMORY.md index 7eae3b5..825340c 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -9,12 +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: Optimización de UdeCi, Control Óptico en Recepción y Normalización de Teclado (v3.8.48)**: - - **Fidelidad Fáctica y Listados Directos de UdeCi**: `LiveContextService` inyecta la nómina completa y verídica de comisiones y docentes activos ante consultas como "qué comisiones hay" o "dame un listado", eliminando evasiones ("ve al menú") y alucinaciones sobre profesores inexistentes. System prompt reforzado para ratificar que los datos en vivo provienen 100% de PostgreSQL y no son mock. - - **Foco Permanente en Consola de Recepción**: Captura y forzado permanente del cursor en `#scannerInput` con temporizador cíclico, foco inmediato al cargar y tras escaneo, y re-enfoque ante clics en la pantalla para pistolas ópticas USB HID. Indicador visual con animación de pulso (*Lector Listo*). - - **Compatibilidad con Pistolas Ópticas en Teclado en Español**: Solución a la traducción de `:` a `Ñ` producida por lectores ópticos emulando teclado US en sistemas en español (cadenas `UNICABAÑUSRÑ144ÑDNIÑ`). Normalización bidireccional y regex tolerante en `QRSecurityService.decode_and_resolve_user`. - - **Dashboard y Ruta Predeterminada de Recepción**: `/reception/scanner` fijada como página de inicio y destino de marca para el perfil `RECEPCION` en todos los flujos de autenticación e impersonación. - - **Versión Consolidada**: `v3.8.48`. +- **Sprint Activo: Anti-Captura Estricto en QR Dinámico y Corrección de Zona Horaria (v3.8.49)**: + - **Corrección Integral del Desfasaje Horario (16:18 vs 13:18)**: Solucionado el desfasaje de 3 horas en la Consola de Recepción (`/reception/scanner`). Se implementó `to_argentina_time` en `reception.py` convirtiendo los timestamps a la zona horaria institucional de Buenos Aires (`America/Argentina/Buenos_Aires`, UTC-3) e inyectando `scanned_time`. Adaptado tanto el render Nunjucks inicial como las actualizaciones periódicas AJAX. + - **Ventana Estricta Anti-Captura en QR Dinámico**: Periodo de validez del JWT reducido a 6 segundos (`valid_seconds = 6`), de modo que capturas de pantalla o fotos del código QR de 10 segundos o más queden categóricamente expiradas y rechazadas con `jwt.ExpiredSignatureError`. + - **Priorización Criptográfica**: `decode_and_resolve_user` evalúa prioritariamente la firma JWT con control de expiración estricto, informando al operador: *"La credencial digital ha expirado (anti-captura activo). Renueve el código en la pantalla del usuario."* + - **Versión Consolidada**: `v3.8.49`. ## 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 b3a5fd8..47001d2 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.48" +__version__ = "3.8.49" class DummyContext: def __enter__(self): diff --git a/backend/app/services/qr_security_service.py b/backend/app/services/qr_security_service.py index 038dae0..2ff77b6 100644 --- a/backend/app/services/qr_security_service.py +++ b/backend/app/services/qr_security_service.py @@ -82,6 +82,33 @@ class QRSecurityService: if clean_normalized.startswith("UNICABA:QR:"): clean_normalized = clean_normalized[len("UNICABA:QR:"):].strip() + # 1. Intentar validar como JWT criptográfico institucional primero + if clean_normalized.count(".") == 2: + try: + payload = jwt.decode( + clean_normalized, + cls._get_secret(), + algorithms=["HS256"], + options={"verify_exp": True} + ) + if payload.get("type") != cls.QR_TOKEN_TYPE: + return None, "DENEGADO", "El token no corresponde a una credencial institucional válida." + + user_id = payload.get("sub") + user = User.query.get(int(user_id)) if user_id else None + if not user: + return None, "DENEGADO", "Usuario no encontrado en la base de datos." + + if not user.is_active: + return user, "RESTRINGIDO", "La cuenta del usuario se encuentra inactiva o suspendida." + + return user, "AUTORIZADO", "Credencial institucional válida y activa." + except jwt.ExpiredSignatureError: + return None, "DENEGADO", "La credencial digital ha expirado (anti-captura activo). Renueve el código en la pantalla del usuario." + except jwt.PyJWTError as e: + return None, "DENEGADO", f"Firma criptográfica inválida: {str(e)}" + + # 2. Formatos fallback (cuando no es un JWT): # A. Intentar extraer patrón institucional UNICABA:USR: usr_match = re.search(r"USR:(\d+)", clean_normalized) if usr_match: @@ -107,32 +134,6 @@ class QRSecurityService: return user_by_dni, "RESTRINGIDO", "Usuario inactivo en el sistema institucional." return user_by_dni, "AUTORIZADO", f"Identificación validada por documento de identidad (DNI {doc})." - # C. Intentar validar como JWT institucional - if clean_normalized.count(".") == 2: - try: - payload = jwt.decode( - clean_normalized, - cls._get_secret(), - algorithms=["HS256"], - options={"verify_exp": True} - ) - if payload.get("type") != cls.QR_TOKEN_TYPE: - return None, "DENEGADO", "El token no corresponde a una credencial institucional válida." - - user_id = payload.get("sub") - user = User.query.get(int(user_id)) if user_id else None - if not user: - return None, "DENEGADO", "Usuario no encontrado en la base de datos." - - if not user.is_active: - return user, "RESTRINGIDO", "La cuenta del usuario se encuentra inactiva o suspendida." - - return user, "AUTORIZADO", "Credencial institucional válida y activa." - except jwt.ExpiredSignatureError: - return None, "DENEGADO", "La credencial digital ha expirado. El alumno debe abrir su app para renovarla." - except jwt.PyJWTError as e: - return None, "DENEGADO", f"Firma criptográfica inválida: {str(e)}" - # D. Fallback: Lectura de pistola óptica o documento directo (ej: 'DNI:12345678' o '12345678') doc_num = clean_normalized if doc_num.upper().startswith("DNI:"): diff --git a/backend/routers/reception.py b/backend/routers/reception.py index d0f0fe6..bd69f74 100644 --- a/backend/routers/reception.py +++ b/backend/routers/reception.py @@ -1,5 +1,5 @@ -from datetime import datetime, timezone -from typing import Optional, List +from datetime import datetime, timezone, timedelta +from typing import Optional, List, Tuple from fastapi import APIRouter, Depends, HTTPException, Query, status from app import db @@ -20,6 +20,25 @@ from schemas.reception_dto import ( router = APIRouter(prefix="/api/v1/reception", tags=["Reception & Access Control"]) +def to_argentina_time(dt_val: Optional[datetime]) -> Tuple[str, str]: + """Convierte un datetime (UTC) a la hora local institucional de Buenos Aires (UTC-3).""" + if not dt_val: + return "", "--" + try: + from zoneinfo import ZoneInfo + tz_ar = ZoneInfo("America/Argentina/Buenos_Aires") + if dt_val.tzinfo is None: + dt_utc = dt_val.replace(tzinfo=timezone.utc) + else: + dt_utc = dt_val.astimezone(timezone.utc) + local_dt = dt_utc.astimezone(tz_ar) + except Exception: + offset = timedelta(hours=-3) + local_dt = (dt_val if dt_val.tzinfo is None else dt_val.replace(tzinfo=None)) + offset + + return local_dt.isoformat(), local_dt.strftime("%H:%M hs") + + @router.post("/verify-qr", response_model=QRVerificationResponseDTO) def verify_qr_and_register_access( payload: QRVerificationRequestDTO, @@ -68,6 +87,8 @@ def verify_qr_and_register_access( else f"Acceso observado: {reason}" ) + scanned_at_iso, scanned_time_str = to_argentina_time(now_utc) + return QRVerificationResponseDTO( status=auth_status, message=message, @@ -78,7 +99,8 @@ def verify_qr_and_register_access( matricula_status="REGULAR / ACTIVO" if user.is_active else "SUSPENDIDO / INACTIVO", photo_url=None, todays_classes=classes, - scanned_at=now_utc.isoformat() + scanned_at=scanned_at_iso, + scanned_time=scanned_time_str ) # Si el código QR es inválido o el usuario no existe @@ -90,6 +112,8 @@ def verify_qr_and_register_access( details={"reason": reason, "raw_snippet": payload.qr_token[:15]} ) + scanned_at_iso, scanned_time_str = to_argentina_time(now_utc) + return QRVerificationResponseDTO( status="DENEGADO", message=reason, @@ -100,7 +124,8 @@ def verify_qr_and_register_access( matricula_status="NO REGISTRADO", photo_url=None, todays_classes=[], - scanned_at=now_utc.isoformat() + scanned_at=scanned_at_iso, + scanned_time=scanned_time_str ) @@ -112,7 +137,7 @@ def get_recent_access_logs( ): """ Retorna los últimos ingresos registrados en el punto de acceso. - Permite monitoreo en tiempo real para el personal de Recepción y Seguridad. + Permite monitoreo en tiempo real para el personal de Recepción y Seguridad con hora local de Buenos Aires. """ query = AccessLogQR.query if building_id: @@ -122,6 +147,7 @@ def get_recent_access_logs( items = [] for l in logs: + scanned_at_iso, scanned_time_str = to_argentina_time(l.scanned_at) items.append(AccessLogResponseDTO( id=l.id, user_name=l.user.name if l.user else "Usuario no disponible", @@ -129,7 +155,8 @@ def get_recent_access_logs( user_role=l.user.role if l.user else None, building_name=l.building.name if l.building else "Sede no especificada", scanned_by_name=l.scanned_by.name if l.scanned_by else "Recepción", - scanned_at=l.scanned_at.isoformat(), + scanned_at=scanned_at_iso, + scanned_time=scanned_time_str, status=l.status, reason=l.reason )) @@ -147,10 +174,16 @@ 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. + Soporta rotación dinámica periódica (default 3s) y ventana de validez anti-captura estricta (default 6s). """ 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) + # Ventana estricta anti-captura: el token expira pasados pocos segundos (default 6s) + # de modo que una captura de pantalla de 10 segundos queda garantizadamente rechazada. + configured_grace = SystemSetting.get_value('qr_token_grace_period_seconds', None) + if configured_grace is not None: + grace_seconds = int(configured_grace) + else: + grace_seconds = max(renewal_seconds + 3, 6) token = QRSecurityService.generate_qr_token(current_user, valid_seconds=grace_seconds) return { diff --git a/backend/schemas/reception_dto.py b/backend/schemas/reception_dto.py index 5ef5d3c..6387ed5 100644 --- a/backend/schemas/reception_dto.py +++ b/backend/schemas/reception_dto.py @@ -31,6 +31,7 @@ class QRVerificationResponseDTO(BaseModel): photo_url: Optional[str] = None todays_classes: List[TodayClassDTO] = Field(default_factory=list, description="Clases presenciales o virtuales asignadas para hoy") scanned_at: str = Field(..., description="Timestamp de registro del escaneo") + scanned_time: Optional[str] = Field(None, description="Hora formateada en zona horaria local de Buenos Aires (HH:MM hs)") class AccessLogResponseDTO(BaseModel): @@ -41,6 +42,7 @@ class AccessLogResponseDTO(BaseModel): building_name: str scanned_by_name: str scanned_at: str + scanned_time: Optional[str] = None status: str reason: Optional[str] = None diff --git a/backend/setup.py b/backend/setup.py index fcb93f8..7e21b0b 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.48", + version="3.8.49", 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 8cc445a..b1435e9 100644 --- a/backend/tests/test_benefits_and_reception.py +++ b/backend/tests/test_benefits_and_reception.py @@ -246,8 +246,15 @@ def test_reception_my_qr_token_endpoint(init_database): 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 + assert data["grace_period_seconds"] == 6 + + # Verificar que el token expire y sea rechazado ante capturas de pantalla viejas (> 6s) + expired_token = QRSecurityService.generate_qr_token(student, valid_seconds=1) + import time + time.sleep(1.1) + exp_user, exp_status, exp_reason = QRSecurityService.decode_and_resolve_user(expired_token) + assert exp_status == "DENEGADO" + assert "expirado" in exp_reason.lower() def test_security_qr_settings_configuration(init_database): diff --git a/frontend/package.json b/frontend/package.json index 369e758..5c45b94 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,6 +1,6 @@ { "name": "frontend", - "version": "3.8.48", + "version": "3.8.49", "description": "", "main": "index.js", "scripts": { diff --git a/frontend/src/app.js b/frontend/src/app.js index fd1f6dc..6c893cb 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.48'; -const FRONTEND_VERSION = '3.8.48'; -const BACKEND_VERSION = '3.8.48'; +const APP_VERSION = '3.8.49'; +const FRONTEND_VERSION = '3.8.49'; +const BACKEND_VERSION = '3.8.49'; env.addGlobal('app_version', APP_VERSION); env.addGlobal('frontend_version', FRONTEND_VERSION); diff --git a/frontend/src/routes/reception.js b/frontend/src/routes/reception.js index ec3c748..62190fb 100644 --- a/frontend/src/routes/reception.js +++ b/frontend/src/routes/reception.js @@ -27,7 +27,24 @@ router.get('/scanner', async (req, res) => { req.apiClient.get('/reception/recent-logs', { params: { limit: 15 } }) ]); buildings = respBld.data?.buildings || respBld.data || []; - recentLogs = respLogs.data?.items || []; + recentLogs = (respLogs.data?.items || []).map(l => { + let timeStr = l.scanned_time; + if (!timeStr && l.scanned_at) { + try { + const raw = l.scanned_at; + const d = new Date(raw.endsWith('Z') || raw.includes('+') || raw.includes('-') ? raw : raw + 'Z'); + timeStr = d.toLocaleTimeString('es-AR', { + hour: '2-digit', + minute: '2-digit', + hour12: false, + timeZone: 'America/Argentina/Buenos_Aires' + }) + ' hs'; + } catch (e) { + timeStr = l.scanned_at.substring(11, 16) + ' hs'; + } + } + return { ...l, scanned_time: timeStr || '--' }; + }); } catch (err) { console.warn('Reception scanner init notice:', err.message); } diff --git a/frontend/views/reception/scanner.html b/frontend/views/reception/scanner.html index 0f6d925..62d0fe0 100644 --- a/frontend/views/reception/scanner.html +++ b/frontend/views/reception/scanner.html @@ -161,7 +161,7 @@ {{ log.user_role or 'ALUMNO' }} {{ log.user_dni or '--' }} {{ log.building_name }} - {{ log.scanned_at | replace('T', ' ') | truncate(16, true, '') }} + {{ log.scanned_time if log.scanned_time else (log.scanned_at | replace('T', ' ') | truncate(16, true, '')) }} {% if log.status == 'AUTORIZADO' %} OK @@ -397,7 +397,7 @@ ${l.user_role || 'ALUMNO'} ${l.user_dni || '--'} ${l.building_name} - ${l.scanned_at ? l.scanned_at.replace('T', ' ').substring(11, 16) + ' hs' : '--'} + ${formatLogTime(l)} ${l.status === 'AUTORIZADO' ? 'OK' : l.status} @@ -411,6 +411,23 @@ } } + function formatLogTime(l) { + if (l.scanned_time) return l.scanned_time; + if (!l.scanned_at) return '--'; + try { + const raw = l.scanned_at; + const d = new Date(raw.endsWith('Z') || raw.includes('+') || raw.includes('-') ? raw : raw + 'Z'); + return d.toLocaleTimeString('es-AR', { + hour: '2-digit', + minute: '2-digit', + hour12: false, + timeZone: 'America/Argentina/Buenos_Aires' + }) + ' hs'; + } catch (e) { + return l.scanned_at.substring(11, 16) + ' hs'; + } + } + // Feedback sonoro opcional vía Web Audio API function playBeep(success) { try {