From 1560bc2a67fa4de06e66fc1e50ba35df2e23f26b Mon Sep 17 00:00:00 2001 From: Carlos Tello Date: Fri, 16 Oct 2026 16:16:44 -0300 Subject: [PATCH] feat(security): implementar autenticacion por API Key institucional para Moodle, purga de tareas y hardening --- CHANGELOG.md | 12 +++++ MEMORY.md | 13 ++++- README.md | 2 +- ROADMAP.md | 2 +- backend/app/__init__.py | 2 +- backend/app/routes/api/admin.py | 86 +++++++++++++++++++++++++++++-- backend/app/routes/api/openapi.py | 2 +- backend/setup.py | 2 +- frontend/package.json | 2 +- frontend/src/app.js | 6 +-- 10 files changed, 115 insertions(+), 14 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 81e9c66..77aadfa 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,18 @@ 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.5.5] - 2026-10-16 +### Added +- Mecanismo de autenticación mediante Clave API institucional (`X-API-Key` / `Authorization: ApiKey`) para sincronizaciones seguras desde Moodle y automatizaciones externas sin requerir tokens JWT interactivos. +- Endpoints de gestión de clave API: `GET /api/v1/admin/settings/moodle/api-key` y `POST /api/v1/admin/settings/moodle/api-key/regenerate`. +- Alias de sincronización `POST /api/v1/admin/settings/moodle/sync` consumible nativamente desde el botón de la interfaz web en la pantalla de Ajustes. +- Catálogo extendido de Web Services en Moodle Local (`10.0.0.207`) para el servicio `moodle_api`: añadidas funciones `enrol_manual_unenrol_users`, `core_enrol_unenrol_user_enrolment`, `core_role_assign_roles` y `core_role_unassign_roles`. +- Blindaje de seguridad en Moodle mediante restricción de IP (`iprestriction = 10.0.0.0/24`) en los tokens del servicio `moodle_api`. + +### Changed & Fixed +- Eliminadas las 6 tareas residuales pendientes de prueba en la tabla `moodle_sync_tasks` de `classrooms_db`. +- Resolución de type narrowings (`loader` en `moodle_replicator.py` y `role_obj` en `admin.py`) y configuración integral de paths de scripts y venv en `pyrightconfig.json`. + ## [3.5.4] - 2026-10-16 ### Added - Integración completa bidireccional con el Web Service `moodle_api` de Moodle Local (`10.0.0.207`) usando token dedicado `810428346d3601c68a37a315fcba8d4391629f46`. diff --git a/MEMORY.md b/MEMORY.md index b951c66..96e2478 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -245,8 +245,17 @@ Memoria del proyecto entre sesiones para la rama `dev`. - **Sincronización Bidireccional Moodle -> Edu Space**: - Agregado el endpoint administrativo `POST /api/v1/admin/moodle/sync-from-moodle`. - Incorporados los métodos `get_courses()`, `get_categories()` y `sync_from_moodle_to_app()` en `MoodleClient`. - - **Resolución de Lints de la IDE**: - - Ajustado `.vscode/settings.json` y carga modular dinámica en `scripts/import_moodle_to_app.py`. +- **Sprint v3.5.5: Autenticación por API Key para Moodle, Purga de Tareas y Hardening**: + - **Purga de Tareas de Sincronización Residuales**: + - Eliminadas las 6 tareas pendientes residuales de prueba (#1 a #6) en la tabla `moodle_sync_tasks` de `classrooms_db` en `10.0.0.217`, dejando la cola limpia en 0 registros. + - **Ampliación de Funciones Web Services en Moodle Local (`10.0.0.207`)**: + - Asignadas al servicio `moodle_api` las funciones `enrol_manual_unenrol_users`, `core_enrol_unenrol_user_enrolment`, `core_role_assign_roles` y `core_role_unassign_roles`, completando el catálogo a 15 funciones esenciales. + - **Seguridad por Restricción de Red (IP Restriction)**: + - Fijada la restricción de red `iprestriction = '10.0.0.0/24'` en `mdl_external_tokens`, asegurando que solo el tráfico interno institucional pueda utilizar los tokens de Moodle. + - **Autenticación por API Key Institucional en Admin Edu Space**: + - Creado mecanismo para autenticar endpoints de sincronización (`/settings/moodle/sync` y `/moodle/sync-from-moodle`) mediante `X-API-Key` institucional de 64 caracteres hex. + - Generada y almacenada la clave API institucional cifrada con Fernet en `system_settings` (`classrooms_db`). + - Agregados endpoints para consulta y regeneración de clave API (`/api/v1/admin/settings/moodle/api-key`). ## Próximos pasos 1. Monitorear los inicios de sesión delegados en producción con cuentas docentes y estudiantiles. diff --git a/README.md b/README.md index 8bc1115..084c43d 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ Plataforma integral de gestión áulica, asignación de espacios, control de hor El proyecto se basa en una arquitectura **desacoplada (Frontend / Backend)** en formato monorepo. -**Versión Actual:** `3.5.4` (Integración Moodle API Bidireccional & Login Delegado) +**Versión Actual:** `3.5.5` (API Key Institucional Moodle, Purga de Tareas y Hardening) **Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA) **Entorno de Producción:** `https://eduspace.oemspot.com.ar` (LXC `10.0.0.217`) diff --git a/ROADMAP.md b/ROADMAP.md index 894d5a6..b292a5b 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -2,7 +2,7 @@ ## Gestión de Espacios Áulicos, Asignación de Comisiones y Operatoria de Bedelía **Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA) -**Versión:** 3.5.4 (Integración Moodle API Bidireccional & Login Delegado) +**Versión:** 3.5.5 (API Key Institucional Moodle, Purga de Tareas y Hardening) **Fecha de Actualización:** 16 de Octubre de 2026 **Rama Base:** `dev` diff --git a/backend/app/__init__.py b/backend/app/__init__.py index 6919849..1683e88 100644 --- a/backend/app/__init__.py +++ b/backend/app/__init__.py @@ -6,7 +6,7 @@ from flask_babel import Babel, gettext as _ from config.config import Config # Initialize extensions -__version__ = "3.5.4" +__version__ = "3.5.5" db = SQLAlchemy() migrate = Migrate() cors = CORS() diff --git a/backend/app/routes/api/admin.py b/backend/app/routes/api/admin.py index af4066e..1d21039 100644 --- a/backend/app/routes/api/admin.py +++ b/backend/app/routes/api/admin.py @@ -2385,14 +2385,94 @@ def test_moodle_connection(): return jsonify(result), 400 -@api_admin_bp.route('/moodle/sync-from-moodle', methods=['POST']) +def _verify_moodle_api_key_or_admin() -> bool: + """Valida si la petición proviene de Moodle vía API Key autorizada o de un administrador.""" + from app.models.setting import SystemSetting + import secrets + + # Verificar Header de API Key (X-API-Key o Authorization: ApiKey ...) + api_key_header = request.headers.get('X-API-Key') or request.headers.get('X-Moodle-Api-Key') + if not api_key_header and request.headers.get('Authorization', '').startswith('ApiKey '): + api_key_header = request.headers.get('Authorization', '').replace('ApiKey ', '').strip() + + if api_key_header: + saved_key = SystemSetting.get_decrypted_value('moodle_api_key', '') + if saved_key and secrets.compare_digest(api_key_header.strip(), saved_key.strip()): + return True + + acting_user = getattr(g, 'jwt_user', None) + if acting_user and (acting_user.is_admin() or getattr(acting_user, 'role', '').upper() == 'ADMIN'): + return True + + return False + + +@api_admin_bp.route('/settings/moodle/api-key', methods=['GET']) @jwt_required -def sync_data_from_moodle(): - """Sincroniza usuarios, roles y catálogo desde Moodle hacia Admin Edu Space.""" +def get_moodle_api_key(): + """Retorna la clave API institucional configurada para Moodle.""" acting_user = getattr(g, 'jwt_user', None) if not (acting_user and (acting_user.is_admin() or getattr(acting_user, 'role', '').upper() == 'ADMIN')): return jsonify({'error': 'Forbidden', 'message': 'Acceso no autorizado.'}), 403 + import secrets + from app.models.setting import SystemSetting + api_key = SystemSetting.get_decrypted_value('moodle_api_key', '') + if not api_key: + api_key = secrets.token_hex(32) + SystemSetting.set_encrypted_value('moodle_api_key', api_key, 'Clave API secreta para integración bidireccional segura con Moodle', category='sso_moodle') + + return jsonify({ + 'status': 'success', + 'api_key': api_key, + 'header_name': 'X-API-Key', + 'sync_endpoint': '/api/v1/admin/settings/moodle/sync' + }), 200 + + +@api_admin_bp.route('/settings/moodle/api-key/regenerate', methods=['POST']) +@jwt_required +def regenerate_moodle_api_key(): + """Regenera una nueva clave API criptográfica para sincronizaciones seguras con Moodle.""" + acting_user = getattr(g, 'jwt_user', None) + if not (acting_user and (acting_user.is_admin() or getattr(acting_user, 'role', '').upper() == 'ADMIN')): + return jsonify({'error': 'Forbidden', 'message': 'Acceso no autorizado.'}), 403 + + import secrets + from app.models.setting import SystemSetting + new_key = secrets.token_hex(32) + SystemSetting.set_encrypted_value('moodle_api_key', new_key, 'Clave API secreta para integración bidireccional segura con Moodle', category='sso_moodle') + + return jsonify({ + 'status': 'success', + 'api_key': new_key, + 'message': 'Clave API de Moodle regenerada exitosamente.' + }), 200 + + +@api_admin_bp.route('/moodle/sync-from-moodle', methods=['POST']) +@api_admin_bp.route('/settings/moodle/sync', methods=['POST']) +def sync_data_from_moodle(): + """Sincroniza usuarios, roles y catálogo desde Moodle hacia Admin Edu Space (autenticado por JWT o X-API-Key).""" + # Intentar cargar JWT si está presente + auth_header = request.headers.get('Authorization', '') + if auth_header.startswith('Bearer '): + token = auth_header.replace('Bearer ', '').strip() + try: + from app.services.jwt_service import JWTService + from app.services.user_service import user_service + payload = JWTService.decode_token(token, expected_type='access') + sub = payload.get('sub') + if sub: + user = user_service.get_by_id(int(sub)) + if user and user.is_active: + g.jwt_user = user + except Exception: + pass + + if not _verify_moodle_api_key_or_admin(): + return jsonify({'error': 'Forbidden', 'message': 'Acceso no autorizado. Se requiere token JWT de ADMIN o header X-API-Key válido.'}), 403 + from app.services.moodle_client import moodle_client try: res = moodle_client.sync_from_moodle_to_app() diff --git a/backend/app/routes/api/openapi.py b/backend/app/routes/api/openapi.py index 378b5f3..b29106e 100644 --- a/backend/app/routes/api/openapi.py +++ b/backend/app/routes/api/openapi.py @@ -7,7 +7,7 @@ OPENAPI_SPEC = { "info": { "title": "Edu-Space REST API", "description": "Enterprise Academic & Physical Space Management REST API with JWT Authentication and Role-Based Access Control.", - "version": "3.5.4" + "version": "3.5.5" }, "servers": [ { diff --git a/backend/setup.py b/backend/setup.py index 48ea991..0554ea6 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.5.4", + version="3.5.5", description="Administrative interface for Edu-Space Classroom Management System", author="Edu-Space Development Team", author_email="admin@edu-space.com", diff --git a/frontend/package.json b/frontend/package.json index c9287d7..50d3ef3 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,6 +1,6 @@ { "name": "frontend", - "version": "3.5.4", + "version": "3.5.5", "description": "", "main": "index.js", "scripts": { diff --git a/frontend/src/app.js b/frontend/src/app.js index 76f2bf8..1c8847d 100644 --- a/frontend/src/app.js +++ b/frontend/src/app.js @@ -85,9 +85,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), { }); // Versiones institucionales del sistema -const APP_VERSION = '3.5.4'; -const FRONTEND_VERSION = '3.5.4'; -const BACKEND_VERSION = '3.5.4'; +const APP_VERSION = '3.5.5'; +const FRONTEND_VERSION = '3.5.5'; +const BACKEND_VERSION = '3.5.5'; env.addGlobal('app_version', APP_VERSION); env.addGlobal('frontend_version', FRONTEND_VERSION);