feat(security): implementar autenticacion por API Key institucional para Moodle, purga de tareas y hardening

This commit is contained in:
2026-10-16 16:16:44 -03:00
parent 1e6faa1301
commit 1560bc2a67
10 changed files with 115 additions and 14 deletions
+12
View File
@@ -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. - **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. - **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 ## [3.5.4] - 2026-10-16
### Added ### Added
- Integración completa bidireccional con el Web Service `moodle_api` de Moodle Local (`10.0.0.207`) usando token dedicado `810428346d3601c68a37a315fcba8d4391629f46`. - Integración completa bidireccional con el Web Service `moodle_api` de Moodle Local (`10.0.0.207`) usando token dedicado `810428346d3601c68a37a315fcba8d4391629f46`.
+11 -2
View File
@@ -245,8 +245,17 @@ Memoria del proyecto entre sesiones para la rama `dev`.
- **Sincronización Bidireccional Moodle -> Edu Space**: - **Sincronización Bidireccional Moodle -> Edu Space**:
- Agregado el endpoint administrativo `POST /api/v1/admin/moodle/sync-from-moodle`. - 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`. - Incorporados los métodos `get_courses()`, `get_categories()` y `sync_from_moodle_to_app()` en `MoodleClient`.
- **Resolución de Lints de la IDE**: - **Sprint v3.5.5: Autenticación por API Key para Moodle, Purga de Tareas y Hardening**:
- Ajustado `.vscode/settings.json` y carga modular dinámica en `scripts/import_moodle_to_app.py`. - **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 ## Próximos pasos
1. Monitorear los inicios de sesión delegados en producción con cuentas docentes y estudiantiles. 1. Monitorear los inicios de sesión delegados en producción con cuentas docentes y estudiantiles.
+1 -1
View File
@@ -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. 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) **Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)
**Entorno de Producción:** `https://eduspace.oemspot.com.ar` (LXC `10.0.0.217`) **Entorno de Producción:** `https://eduspace.oemspot.com.ar` (LXC `10.0.0.217`)
+1 -1
View File
@@ -2,7 +2,7 @@
## Gestión de Espacios Áulicos, Asignación de Comisiones y Operatoria de Bedelía ## Gestión de Espacios Áulicos, Asignación de Comisiones y Operatoria de Bedelía
**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA) **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 **Fecha de Actualización:** 16 de Octubre de 2026
**Rama Base:** `dev` **Rama Base:** `dev`
+1 -1
View File
@@ -6,7 +6,7 @@ from flask_babel import Babel, gettext as _
from config.config import Config from config.config import Config
# Initialize extensions # Initialize extensions
__version__ = "3.5.4" __version__ = "3.5.5"
db = SQLAlchemy() db = SQLAlchemy()
migrate = Migrate() migrate = Migrate()
cors = CORS() cors = CORS()
+83 -3
View File
@@ -2385,14 +2385,94 @@ def test_moodle_connection():
return jsonify(result), 400 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 @jwt_required
def sync_data_from_moodle(): def get_moodle_api_key():
"""Sincroniza usuarios, roles y catálogo desde Moodle hacia Admin Edu Space.""" """Retorna la clave API institucional configurada para Moodle."""
acting_user = getattr(g, 'jwt_user', None) acting_user = getattr(g, 'jwt_user', None)
if not (acting_user and (acting_user.is_admin() or getattr(acting_user, 'role', '').upper() == 'ADMIN')): 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 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 from app.services.moodle_client import moodle_client
try: try:
res = moodle_client.sync_from_moodle_to_app() res = moodle_client.sync_from_moodle_to_app()
+1 -1
View File
@@ -7,7 +7,7 @@ OPENAPI_SPEC = {
"info": { "info": {
"title": "Edu-Space REST API", "title": "Edu-Space REST API",
"description": "Enterprise Academic & Physical Space Management REST API with JWT Authentication and Role-Based Access Control.", "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": [ "servers": [
{ {
+1 -1
View File
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
setup( setup(
name="edu-space-admin", name="edu-space-admin",
version="3.5.4", version="3.5.5",
description="Administrative interface for Edu-Space Classroom Management System", description="Administrative interface for Edu-Space Classroom Management System",
author="Edu-Space Development Team", author="Edu-Space Development Team",
author_email="admin@edu-space.com", author_email="admin@edu-space.com",
+1 -1
View File
@@ -1,6 +1,6 @@
{ {
"name": "frontend", "name": "frontend",
"version": "3.5.4", "version": "3.5.5",
"description": "", "description": "",
"main": "index.js", "main": "index.js",
"scripts": { "scripts": {
+3 -3
View File
@@ -85,9 +85,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), {
}); });
// Versiones institucionales del sistema // Versiones institucionales del sistema
const APP_VERSION = '3.5.4'; const APP_VERSION = '3.5.5';
const FRONTEND_VERSION = '3.5.4'; const FRONTEND_VERSION = '3.5.5';
const BACKEND_VERSION = '3.5.4'; const BACKEND_VERSION = '3.5.5';
env.addGlobal('app_version', APP_VERSION); env.addGlobal('app_version', APP_VERSION);
env.addGlobal('frontend_version', FRONTEND_VERSION); env.addGlobal('frontend_version', FRONTEND_VERSION);