feat(security): implementar autenticacion por API Key institucional para Moodle, purga de tareas y hardening
This commit is contained in:
@@ -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`.
|
||||||
|
|||||||
@@ -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.
|
||||||
|
|||||||
@@ -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
@@ -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`
|
||||||
|
|
||||||
|
|||||||
@@ -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()
|
||||||
|
|||||||
@@ -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()
|
||||||
|
|||||||
@@ -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
@@ -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,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
@@ -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);
|
||||||
|
|||||||
Reference in New Issue
Block a user