feat(reception): add strict anti-capture expiration to dynamic QR and fix Buenos Aires timezone display (v3.8.49)

This commit is contained in:
2026-10-28 13:32:30 -03:00
parent 3dbd22cc3c
commit 4668117c35
12 changed files with 138 additions and 51 deletions
+11
View File
@@ -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**:
+5 -6
View File
@@ -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.
+1 -1
View File
@@ -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):
+27 -26
View File
@@ -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:<id>
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:"):
+41 -8
View File
@@ -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 {
+2
View File
@@ -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
+1 -1
View File
@@ -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",
+9 -2
View File
@@ -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):
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "frontend",
"version": "3.8.48",
"version": "3.8.49",
"description": "",
"main": "index.js",
"scripts": {
+3 -3
View File
@@ -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);
+18 -1
View File
@@ -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);
}
+19 -2
View File
@@ -161,7 +161,7 @@
<td><span class="badge bg-light text-dark border">{{ log.user_role or 'ALUMNO' }}</span></td>
<td>{{ log.user_dni or '--' }}</td>
<td>{{ log.building_name }}</td>
<td>{{ log.scanned_at | replace('T', ' ') | truncate(16, true, '') }}</td>
<td>{{ log.scanned_time if log.scanned_time else (log.scanned_at | replace('T', ' ') | truncate(16, true, '')) }}</td>
<td class="text-center">
{% if log.status == 'AUTORIZADO' %}
<span class="badge bg-success-subtle text-success">OK</span>
@@ -397,7 +397,7 @@
<td><span class="badge bg-light text-dark border">${l.user_role || 'ALUMNO'}</span></td>
<td>${l.user_dni || '--'}</td>
<td>${l.building_name}</td>
<td>${l.scanned_at ? l.scanned_at.replace('T', ' ').substring(11, 16) + ' hs' : '--'}</td>
<td>${formatLogTime(l)}</td>
<td class="text-center">
<span class="badge ${l.status === 'AUTORIZADO' ? 'bg-success-subtle text-success' : 'bg-danger-subtle text-danger'}">
${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 {