feat: login de emergencia admin en /adm/login y despliegue por defecto de auth unico (v3.8.5)

This commit is contained in:
2026-10-21 12:36:15 -03:00
parent 85fa1b389f
commit 836e605697
15 changed files with 540 additions and 49 deletions
+17
View File
@@ -11,6 +11,23 @@ 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.8.5] - 2026-10-21
### Added
- **Aislamiento de Login de Emergencia ADMIN en `/adm/login` (Spec 006)**:
- Enrutador dedicado `/adm` y vista `/adm/login` en Frontend BFF con rate limiting (`authLimiter`).
- Endpoint REST `POST /api/v1/auth/adm-login` en backend FastAPI exclusivo para administradores (`is_admin == True`), emitiendo auditoría explícita (`ADMIN_EMERGENCY_LOGIN_SUCCESS`, `ADMIN_EMERGENCY_LOGIN_DENIED`, `ADMIN_EMERGENCY_LOGIN_FAILED`).
- Redirección de conveniencia desde `/adm` hacia `/adm/login`.
- Nueva plantilla Nunjucks sobria y segura `frontend/views/auth/admin_login.html`.
- **Despliegue Automático por Proveedor Único**:
- Detección reactiva de proveedores activos en `frontend/src/routes/auth.js`.
- Si Moodle es el único proveedor institucional habilitado, se presenta desplegado automáticamente (`show`) con los campos de credenciales accesibles de inmediato.
- Eliminación de divisores superfluos cuando existe un solo modo de autenticación activo.
### Removed
- **Limpieza de Interfaz Pública en `/auth/login`**:
- Eliminado el mensaje informativo *"El acceso con contraseña local está deshabilitado para usuarios generales"*.
- Eliminado el modal público `adminEmergencyModal` (*"Acceso de Emergencia ADMIN"*), evitando la exposición innecesaria de accesos administrativos a usuarios finales y posibles atacantes.
## [3.8.4] - 2026-10-21 ## [3.8.4] - 2026-10-21
### Fixed ### Fixed
- **Resolución Rigurosa de Tipado Estático y Cero Diagnósticos LSP (Principio 10)**: - **Resolución Rigurosa de Tipado Estático y Cero Diagnósticos LSP (Principio 10)**:
+9 -7
View File
@@ -9,13 +9,15 @@ Memoria del proyecto entre sesiones para la rama `dev`.
- Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables. - Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables.
- Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación. - 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. - Reinicialización segura del sistema con contraseña de Administrador.
- **Sprint Activo: Cero Diagnósticos LSP y Tipado Estático — v3.8.4**: - **Sprint Activo: Aislamiento de Login de Emergencia Admin y Despliegue de Auth Único — v3.8.5**:
- **Resolución Rigurosa de Tipado en Modelos y Routers**: - **Aislamiento de Login Admin de Emergencia**:
- `Career.subjects` y `Subject.commissions` / `Subject.careers`: Retiradas las anotaciones de lista en relaciones que desorientaban a SQLAlchemy y Pyright, permitiendo inferir descriptores `InstrumentedAttribute` con soporte completo de `.any()` en queries de `academic.py`. - Creado enrutador y vista `/adm/login` (con redirección `/adm` -> `/adm/login`) para administradores de contingencia, protegido con `authLimiter`.
- `Career.to_dict()`: Conteo protegido con `isinstance(subs, (list, set, tuple))` satisfaciendo el protocolo `Sized`. - Endpoint REST dedicado `POST /api/v1/auth/adm-login` en FastAPI que restringe estrictamente el acceso a roles `ADMIN` y emite logs de auditoría segregados (`ADMIN_EMERGENCY_LOGIN_SUCCESS`, `ADMIN_EMERGENCY_LOGIN_DENIED`, `ADMIN_EMERGENCY_LOGIN_FAILED`).
- `sheets_importer.py`: Normalizaciones de `manual_dt`, `date_from_dt`, `date_to_dt` y `row_specific_date` evaluando `datetime` previo a `date` (`isinstance(d, datetime)` antes de `isinstance(d, date)`), erradicando advertencias de comparación cruzada. - Eliminados de la vista pública `/auth/login` el mensaje *"El acceso con contraseña local está deshabilitado para usuarios generales"* y el modal *"Acceso de Emergencia ADMIN"*.
- **Suite de Pruebas Automatizadas**: 62 pruebas ejecutadas con pytest pasando al 100% (62 passed, 0 failed). Cero errores en código (`@[current_problems]`). Pyright `0 errors, 0 warnings`. - **Despliegue Automático por Proveedor Único**:
- **Versión Consolidada**: `v3.8.4`. - Detección en BFF (`is_single_provider`). Si únicamente Moodle está habilitado, el formulario de login aparece expandido (`show`) de forma predeterminada, sin divisores redundantes ni pasos extra.
- **Suite de Pruebas y Tipado**: 66 pruebas ejecutadas con pytest pasando al 100% (66 passed, 0 failed). Cero errores en código (`@[current_problems]`). Pyright `0 errors, 0 warnings`.
- **Versión Consolidada**: `v3.8.5`.
## Decisiones (y por qué) ## 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. - **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 database import db, get_db, engine, SessionLocal, session
from config.config import Config from config.config import Config
__version__ = "3.8.4" __version__ = "3.8.5"
class DummyContext: class DummyContext:
def __enter__(self): def __enter__(self):
+68
View File
@@ -121,6 +121,74 @@ def login(payload: LoginRequest, response: Response):
} }
@auth_router.post("/adm-login")
def adm_login(payload: LoginRequest, response: Response):
"""Inicio de sesión administrativo de emergencia/contingencia."""
user = user_service.authenticate(payload.email, payload.password)
if not user:
AuditService.log(
action='ADMIN_EMERGENCY_LOGIN_FAILED',
module='auth',
user_email=payload.email,
details=f"Intento fallido en consola de emergencia ADMIN para {payload.email}."
)
raise HTTPException(
status_code=status.HTTP_401_UNAUTHORIZED,
detail="Credenciales de acceso incorrectas o cuenta inactiva."
)
is_admin = user.is_admin() or getattr(user, 'role', '').upper() == 'ADMIN'
if not is_admin:
AuditService.log(
action='ADMIN_EMERGENCY_LOGIN_DENIED',
module='auth',
user=user,
entity_id=user.id,
details=f"Usuario sin privilegios de administrador ({user.email}) intentó acceder por consola de emergencia."
)
raise HTTPException(
status_code=status.HTTP_403_FORBIDDEN,
detail="Acceso denegado. Esta consola de emergencia está reservada exclusivamente a administradores del sistema."
)
AuditService.log(
action='ADMIN_EMERGENCY_LOGIN_SUCCESS',
module='auth',
user=user,
entity_id=user.id,
details=f"Acceso de emergencia exitoso a consola administrativa - Usuario: {user.email}"
)
tokens = JWTService.generate_tokens(user)
profile = user_service.get_profile_data(user)
response.set_cookie(
key="access_token",
value=tokens["access_token"],
httponly=True,
samesite="lax",
path="/"
)
response.set_cookie(
key="refresh_token",
value=tokens["refresh_token"],
httponly=True,
samesite="lax",
max_age=7 * 24 * 3600,
path="/api/v1/auth/refresh"
)
return {
'status': 'success',
'access_token': tokens['access_token'],
'refresh_token': tokens['refresh_token'],
'token_type': tokens['token_type'],
'expires_in': tokens['expires_in'],
'user': profile
}
@auth_router.post("/google") @auth_router.post("/google")
def google_auth(payload: GoogleAuthRequest, response: Response): def google_auth(payload: GoogleAuthRequest, response: Response):
"""Inicio de sesión delegado institucional Google OAuth 2.0.""" """Inicio de sesión delegado institucional Google OAuth 2.0."""
+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.8.4", version="3.8.5",
description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)", description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)",
author="Edu-Space Development Team", author="Edu-Space Development Team",
author_email="admin@edu-space.com", author_email="admin@edu-space.com",
+95
View File
@@ -0,0 +1,95 @@
"""
Tests for Admin Emergency Login endpoint (/api/v1/auth/adm-login).
"""
from fastapi.testclient import TestClient
from werkzeug.security import generate_password_hash
from main import app
from app.models.user import User
def test_adm_login_success(init_database):
"""Admin credentials allow successful login in emergency endpoint."""
client = TestClient(app)
admin = User(
email="emergency.admin@unicaba.edu.ar",
name="Emergency Administrator",
password_hash=generate_password_hash("AdminPass123!"),
role="ADMIN",
is_active=True
)
init_database.session.add(admin)
init_database.session.commit()
res = client.post('/api/v1/auth/adm-login', json={
'email': 'emergency.admin@unicaba.edu.ar',
'password': 'AdminPass123!'
})
assert res.status_code == 200
data = res.json()
assert data['status'] == 'success'
assert 'access_token' in data
assert 'refresh_token' in data
assert data['user']['role'].upper() == 'ADMIN'
assert 'access_token' in res.cookies
def test_adm_login_invalid_credentials(init_database):
"""Wrong credentials return 401 Unauthorized."""
client = TestClient(app)
admin = User(
email="admin.wrongpass@unicaba.edu.ar",
name="Admin Wrong Pass",
password_hash=generate_password_hash("CorrectPass123!"),
role="ADMIN",
is_active=True
)
init_database.session.add(admin)
init_database.session.commit()
res = client.post('/api/v1/auth/adm-login', json={
'email': 'admin.wrongpass@unicaba.edu.ar',
'password': 'BadPassword!'
})
assert res.status_code == 401
assert "incorrectas" in res.json()['detail'].lower()
def test_adm_login_denied_for_regular_user(init_database):
"""Regular users (Docente/Estudiante) cannot use emergency admin login, receiving 403."""
client = TestClient(app)
teacher = User(
email="profesor.test@unicaba.edu.ar",
name="Profesor Test",
password_hash=generate_password_hash("DocentePass123!"),
role="DOCENTE",
is_active=True
)
init_database.session.add(teacher)
init_database.session.commit()
res = client.post('/api/v1/auth/adm-login', json={
'email': 'profesor.test@unicaba.edu.ar',
'password': 'DocentePass123!'
})
assert res.status_code == 403
assert "exclusivamente a administradores" in res.json()['detail'].lower()
def test_adm_login_inactive_user(init_database):
"""Inactive admin cannot log in, receiving 401."""
client = TestClient(app)
admin = User(
email="inactive.admin@unicaba.edu.ar",
name="Inactive Admin",
password_hash=generate_password_hash("Pass123!"),
role="ADMIN",
is_active=False
)
init_database.session.add(admin)
init_database.session.commit()
res = client.post('/api/v1/auth/adm-login', json={
'email': 'inactive.admin@unicaba.edu.ar',
'password': 'Pass123!'
})
assert res.status_code == 401
+1 -1
View File
@@ -1,6 +1,6 @@
{ {
"name": "frontend", "name": "frontend",
"version": "3.8.4", "version": "3.8.5",
"description": "", "description": "",
"main": "index.js", "main": "index.js",
"scripts": { "scripts": {
+6 -3
View File
@@ -66,6 +66,7 @@ const generalLimiter = rateLimit({
}); });
app.post('/auth/login', authLimiter); app.post('/auth/login', authLimiter);
app.post('/auth/moodle', authLimiter); app.post('/auth/moodle', authLimiter);
app.post('/adm/login', authLimiter);
app.use('/api', generalLimiter); app.use('/api', generalLimiter);
// Configuración de middlewares con soporte para importaciones masivas y payloads extensos // Configuración de middlewares con soporte para importaciones masivas y payloads extensos
@@ -85,9 +86,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), {
}); });
// Versiones institucionales del sistema // Versiones institucionales del sistema
const APP_VERSION = '3.8.4'; const APP_VERSION = '3.8.5';
const FRONTEND_VERSION = '3.8.4'; const FRONTEND_VERSION = '3.8.5';
const BACKEND_VERSION = '3.8.4'; const BACKEND_VERSION = '3.8.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);
@@ -303,6 +304,7 @@ app.get('/version', (req, res) => {
// Rutas Principales // Rutas Principales
const indexRoutes = require('./routes/index'); const indexRoutes = require('./routes/index');
const authRoutes = require('./routes/auth'); const authRoutes = require('./routes/auth');
const admRoutes = require('./routes/adm');
const dashboardRoutes = require('./routes/dashboard'); const dashboardRoutes = require('./routes/dashboard');
const classroomsRoutes = require('./routes/classrooms'); const classroomsRoutes = require('./routes/classrooms');
const scheduleRoutes = require('./routes/schedule'); const scheduleRoutes = require('./routes/schedule');
@@ -338,6 +340,7 @@ app.use('/api/v1', async (req, res) => {
app.use('/', indexRoutes); app.use('/', indexRoutes);
app.use('/auth', authRoutes); app.use('/auth', authRoutes);
app.use('/adm', admRoutes);
app.use('/dashboard', dashboardRoutes); app.use('/dashboard', dashboardRoutes);
app.use('/classrooms', classroomsRoutes); app.use('/classrooms', classroomsRoutes);
app.use('/schedule', scheduleRoutes); app.use('/schedule', scheduleRoutes);
+57
View File
@@ -0,0 +1,57 @@
const express = require('express');
const router = express.Router();
const apiClient = require('../services/apiClient');
const isSecureCookie = (req) => {
if (process.env.COOKIE_SECURE === 'true') return true;
if (process.env.COOKIE_SECURE === 'false') return false;
return Boolean(req.secure || req.protocol === 'https' || req.get('x-forwarded-proto') === 'https');
};
// Redirección de conveniencia /adm a /adm/login
router.get('/', (req, res) => {
res.redirect('/adm/login');
});
// Vista de autenticación de emergencia exclusiva para administradores
router.get('/login', (req, res) => {
res.render('auth/admin_login', {
error: req.query.error || null
});
});
// Procesamiento de credenciales de emergencia de administración
router.post('/login', async (req, res) => {
try {
const email = req.body.username || req.body.email;
const password = req.body.password;
if (!email || !password) {
return res.redirect('/adm/login?error=' + encodeURIComponent('Por favor complete todos los campos requeridos.'));
}
const response = await apiClient.post('/auth/adm-login', {
email,
password
});
const token = response.data.access_token;
if (token) {
res.cookie('auth_token', token, {
httpOnly: true,
secure: isSecureCookie(req),
sameSite: 'lax',
maxAge: 24 * 60 * 60 * 1000 // 1 día
});
return res.redirect('/dashboard');
}
return res.redirect('/adm/login?error=' + encodeURIComponent('Autenticación administrativa fallida.'));
} catch (error) {
console.error('Admin emergency login error:', error.response?.data || error.message);
const errorMsg = error.response?.data?.detail || error.response?.data?.message || 'Credenciales de acceso incorrectas o cuenta no autorizada.';
return res.redirect('/adm/login?error=' + encodeURIComponent(errorMsg));
}
});
module.exports = router;
+10 -1
View File
@@ -27,14 +27,23 @@ router.get('/login', async (req, res) => {
console.warn('Providers fetch notice in login:', e.message); console.warn('Providers fetch notice in login:', e.message);
} }
const activeProvidersCount = (providers.local ? 1 : 0) + (providers.google ? 1 : 0) + (providers.moodle ? 1 : 0);
const isSingleProvider = activeProvidersCount === 1;
res.render('auth/login', { res.render('auth/login', {
error: req.query.error || null, error: req.query.error || null,
providers, providers,
google_client_id, google_client_id,
demo_access_enabled demo_access_enabled,
active_providers_count: activeProvidersCount,
is_single_provider: isSingleProvider
}); });
}); });
router.get('/adm/login', (req, res) => {
res.redirect('/adm/login');
});
router.post('/login', async (req, res) => { router.post('/login', async (req, res) => {
try { try {
const username = req.body.username || req.body.email; const username = req.body.username || req.body.email;
+139
View File
@@ -0,0 +1,139 @@
<!DOCTYPE html>
<html lang="es" data-bs-theme="dark">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Consola de Emergencia - Edu-Space Admin</title>
<!-- Favicon -->
<link rel="icon" type="image/png" href="/img/favicon.png">
<!-- Script Anti-Flicker para Modo Claro / Oscuro -->
<script>
(function() {
const storedTheme = localStorage.getItem('theme');
const theme = storedTheme || (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light');
document.documentElement.setAttribute('data-bs-theme', theme);
})();
</script>
<!-- Bootstrap 5 CSS -->
<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
<link href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.10.0/font/bootstrap-icons.css" rel="stylesheet">
<!-- Design System Theme -->
<link href="/css/theme.css" rel="stylesheet">
<style>
.admin-badge {
background: rgba(220, 53, 69, 0.15);
color: #dc3545;
border: 1px solid rgba(220, 53, 69, 0.3);
font-size: 0.72rem;
letter-spacing: 0.8px;
font-weight: 700;
text-transform: uppercase;
}
[data-bs-theme="dark"] .admin-badge {
background: rgba(248, 113, 113, 0.15);
color: #f87171;
border-color: rgba(248, 113, 113, 0.3);
}
</style>
</head>
<body>
<div class="auth-wrapper">
<div class="auth-card">
<!-- Header con Controles Superiores & Logo Oficial -->
<div class="auth-header">
<div class="auth-controls">
<button class="theme-toggle-btn" type="button" aria-label="Cambiar tema" title="Modo Claro/Oscuro">
<i class="bi bi-moon-stars-fill"></i>
</button>
</div>
<img src="/img/logo_unicaba.png" alt="UniCABA" class="auth-logo">
<div class="mt-2 mb-1">
<span class="badge admin-badge px-2 py-1 rounded-pill">
<i class="bi bi-shield-lock-fill me-1"></i>Consola Administrativa
</span>
</div>
<h4 class="fw-bold mb-1">Edu-Space Admin</h4>
<p class="text-muted small mb-0">Acceso de Contingencia y Recuperación</p>
</div>
<div class="px-4 pb-4 pt-2">
<!-- Flash Messages -->
{% if error %}
<div class="alert alert-danger alert-dismissible fade show rounded-3 py-2 small" role="alert">
<i class="bi bi-exclamation-triangle-fill me-1"></i> {{ error }}
<button type="button" class="btn-close py-2" data-bs-dismiss="alert"></button>
</div>
{% endif %}
<!-- Formulario de Autenticación de Emergencia ADMIN -->
<form action="/adm/login" method="POST" id="adminLoginForm" novalidate>
<div class="mb-3">
<label for="adminEmail" class="form-label small fw-semibold text-muted">Correo Administrador</label>
<div class="input-group">
<span class="input-group-text bg-body-tertiary border-end-0 text-muted">
<i class="bi bi-person-badge"></i>
</span>
<input type="email" class="form-control border-start-0 ps-0" id="adminEmail" name="email"
required placeholder="admin@unicaba.edu.ar" autofocus>
</div>
</div>
<div class="mb-3">
<label for="adminPassword" class="form-label small fw-semibold text-muted">Contraseña Maestra</label>
<div class="input-group">
<span class="input-group-text bg-body-tertiary border-end-0 text-muted">
<i class="bi bi-key-fill"></i>
</span>
<input type="password" class="form-control border-start-0 border-end-0 ps-0" id="adminPassword" name="password"
required placeholder="Ingresa tu clave de emergencia">
<button class="btn btn-outline-secondary border-start-0 bg-body-tertiary text-muted" type="button" id="togglePasswordBtn" title="Mostrar/Ocultar contraseña">
<i class="bi bi-eye" id="togglePasswordIcon"></i>
</button>
</div>
</div>
<div class="d-grid mb-3 mt-4">
<button type="submit" class="btn btn-danger btn-lg fw-semibold py-2">
<i class="bi bi-shield-check me-1"></i> Acceder a Consola
</button>
</div>
</form>
<div class="text-center mt-3">
<small class="text-muted d-inline-flex align-items-center" style="font-size: 0.73rem;">
<i class="bi bi-incognito text-danger me-1"></i>
Acceso restringido • Todos los intentos son registrados y auditados
</small>
<div class="mt-2">
<span class="badge bg-body-tertiary text-secondary border font-monospace" style="font-size: 0.68rem;">
<i class="bi bi-tag-fill me-1"></i>v{{ app_version or '3.8.5' }}
</span>
</div>
</div>
</div>
</div>
</div>
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
<script src="/js/theme-toggle.js"></script>
<script>
// Toggle password visibility
const toggleBtn = document.getElementById('togglePasswordBtn');
const passwordInput = document.getElementById('adminPassword');
const passwordIcon = document.getElementById('togglePasswordIcon');
if (toggleBtn && passwordInput && passwordIcon) {
toggleBtn.addEventListener('click', function() {
const type = passwordInput.getAttribute('type') === 'password' ? 'text' : 'password';
passwordInput.setAttribute('type', type);
passwordIcon.classList.toggle('bi-eye');
passwordIcon.classList.toggle('bi-eye-slash');
});
}
</script>
</body>
</html>
+3 -35
View File
@@ -117,12 +117,12 @@
{% endif %} {% endif %}
{% if providers.moodle %} {% if providers.moodle %}
<button type="button" class="btn btn-moodle py-2 d-flex align-items-center justify-content-center" data-bs-toggle="collapse" data-bs-target="#moodleLoginForm"> <button type="button" class="btn btn-moodle py-2 d-flex align-items-center justify-content-center" data-bs-toggle="collapse" data-bs-target="#moodleLoginForm" aria-expanded="{{ 'true' if (is_single_provider and providers.moodle) else 'false' }}">
<i class="bi bi-mortarboard-fill me-2 fs-5"></i> <i class="bi bi-mortarboard-fill me-2 fs-5"></i>
<span>Ingresar con Moodle UniCABA</span> <span>Ingresar con Moodle UniCABA</span>
</button> </button>
<div class="collapse mt-2" id="moodleLoginForm"> <div class="collapse mt-2 {{ 'show' if (is_single_provider and providers.moodle) else '' }}" id="moodleLoginForm">
<div class="card p-3 border-warning-subtle bg-body-tertiary"> <div class="card p-3 border-warning-subtle bg-body-tertiary">
<form action="/auth/moodle" method="POST"> <form action="/auth/moodle" method="POST">
<div class="mb-2"> <div class="mb-2">
@@ -142,7 +142,7 @@
{% endif %} {% endif %}
</div> </div>
{% if not providers or providers.local %} {% if (not is_single_provider) and (not providers or providers.local) and (providers.google or providers.moodle) %}
<div class="divider-text">o con credenciales locales</div> <div class="divider-text">o con credenciales locales</div>
{% endif %} {% endif %}
{% endif %} {% endif %}
@@ -181,13 +181,6 @@
</button> </button>
</div> </div>
</form> </form>
{% else %}
<div class="alert alert-info py-2 px-3 small rounded-3 mb-3 text-center">
<i class="bi bi-info-circle me-1"></i>El acceso con contraseña local está deshabilitado para usuarios generales.
<div class="mt-1">
<a href="#adminEmergencyModal" data-bs-toggle="modal" class="fw-semibold text-decoration-none">Acceso de Emergencia ADMIN</a>
</div>
</div>
{% endif %} {% endif %}
{% if demo_access_enabled %} {% if demo_access_enabled %}
@@ -232,31 +225,6 @@
</div> </div>
</div> </div>
</div> </div>
<!-- Modal Acceso de Emergencia ADMIN si local está inactivo -->
<div class="modal fade" id="adminEmergencyModal" tabindex="-1" aria-hidden="true">
<div class="modal-dialog modal-dialog-centered modal-sm">
<div class="modal-content">
<div class="modal-header py-2">
<h6 class="modal-title fw-bold"><i class="bi bi-shield-exclamation text-warning me-1"></i>Acceso de Emergencia ADMIN</h6>
<button type="button" class="btn-close" data-bs-dismiss="modal"></button>
</div>
<div class="modal-body">
<form action="/auth/login" method="POST">
<div class="mb-2">
<label class="form-label small fw-semibold">Email Administrador</label>
<input type="email" name="username" class="form-control form-control-sm" required placeholder="admin@unicaba.edu.ar">
</div>
<div class="mb-3">
<label class="form-label small fw-semibold">Contraseña</label>
<input type="password" name="password" class="form-control form-control-sm" required>
</div>
<button type="submit" class="btn btn-primary btn-sm w-100 fw-semibold">Ingresar como Admin</button>
</form>
</div>
</div>
</div>
</div>
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
<script src="/js/theme-toggle.js"></script> <script src="/js/theme-toggle.js"></script>
+46
View File
@@ -0,0 +1,46 @@
# Plan: 006-login-emergencia-adm - Aislamiento de Login de Emergencia Admin y Despliegue Automático por Proveedor Único
## 1. Arquitectura y Enfoque de Solución
El objetivo es separar el acceso de emergencia para administradores de la pantalla de login general `/auth/login`, eliminar textos informativos y modales que revelen la existencia del acceso de emergencia o del bloqueo local a usuarios generales, y desplegar automáticamente el formulario de autenticación si existe un único proveedor activo (ej. Moodle).
### Componentes Involucrados:
1. **Backend Core (`backend/routers/auth.py`)**:
- Nuevo endpoint REST `POST /api/v1/auth/adm-login` exclusivo para administradores (`is_admin == True`).
- Auditoría estricta (`ADMIN_EMERGENCY_LOGIN_FAILED`, `ADMIN_EMERGENCY_LOGIN_DENIED`, `ADMIN_EMERGENCY_LOGIN_SUCCESS`).
- Retorno de tokens JWT estándar y cookies seguras.
2. **Frontend BFF (`frontend/src/routes/auth.js` y `frontend/src/app.js`)**:
- Rutas `GET /adm/login` y `POST /adm/login` protegidas con `authLimiter`.
- Redirección `GET /adm` -> `/adm/login`.
- Inyección de `is_single_provider` y `active_providers_count` en `GET /login`.
3. **Frontend Vistas (`frontend/views/auth/`)**:
- Nueva plantilla `admin_login.html` sobria, segura y desacoplada de enlaces públicos.
- Limpieza en `login.html`: eliminación del alert "El acceso con contraseña local está deshabilitado..." y del modal `adminEmergencyModal`.
- Soporte para proveedor único: Moodle desplegado por defecto con la clase `.show` si es el único habilitado.
---
## 2. Fases de Implementación
### Fase 1: Backend Core (API FastAPI)
- Agregar endpoint `POST /api/v1/auth/adm-login` en `backend/routers/auth.py`.
- Incorporar auditoría específica y validación de rol `ADMIN`.
- Escribir tests automatizados en `backend/tests/test_adm_login.py`.
### Fase 2: Frontend BFF & Rate Limiter
- Configurar `authLimiter` para `/adm/login` en `frontend/src/app.js`.
- Configurar rutas `GET /adm/login`, `POST /adm/login` y alias `/adm` en `frontend/src/routes/auth.js` o `app.js`.
- Pasar metadatos de proveedores en `GET /login` para identificar si hay un único proveedor habilitado.
### Fase 3: Vistas Nunjucks
- Crear `frontend/views/auth/admin_login.html`.
- Modificar `frontend/views/auth/login.html`:
- Retirar texto y modal de emergencia admin.
- Aplicar apertura automática de Moodle (`collapse show`) si `is_single_provider and providers.moodle`.
- Ocultar divisores redundantes si hay un solo proveedor.
### Fase 4: Pruebas, Verificación y Despliegue
- Ejecutar suite `pytest tests -v` en backend.
- Ejecutar `npx pyright` para verificar 0 errores de tipado.
- Bump de versión a `v3.8.5` (`package.json`, `app.js`, `__init__.py`, `setup.py`, `CHANGELOG.md`, `MEMORY.md`).
- `git add .`, commit y `git push origin dev`.
- Despliegue continuo en LXC Producción `10.0.0.217` (`https://eduspace.oemspot.com.ar`) y verificación HTTP 200 en `/version`.
+45
View File
@@ -0,0 +1,45 @@
# Espec: 006-login-emergencia-adm - Aislamiento de Login de Emergencia Admin y Despliegue Automático por Proveedor Único
## 1. Visión General y Propósito
El acceso de emergencia para administradores se encontraba expuesto visualmente en la pantalla principal `/auth/login` cuando la autenticación local estaba deshabilitada para usuarios generales, mostrando alertas explícitas ("El acceso con contraseña local está deshabilitado para usuarios generales") y un modal directo ("Acceso de Emergencia ADMIN").
Esta visibilidad pública no deseada atrae intentos de fuerza bruta y expone innecesariamente rutas administrativas a usuarios finales.
Asimismo, la pantalla general de autenticación requería clics redundantes cuando solo un proveedor de identidad estaba activo (ej. Moodle colapsado por defecto requiriendo apertura manual).
El propósito de esta especificación es:
1. **Aislar el Login de Emergencia**: Mudar el acceso administrativo local a una ruta no enlazada públicamente (`/adm/login`), reservada para el personal de administración.
2. **Eliminar Indicadores Administrativos en `/auth/login`**: Quitar todo texto informativo de bloqueo local y modales de emergencia de la vista pública de usuarios generales.
3. **Despliegue Automático Predeterminado**: Si solo existe un método de autenticación activo (ej. Moodle), debe presentarse desplegado y listo para su uso inmediato sin requerir clics adicionales.
---
## 2. Requisitos en Sintaxis EARS (Español Estricto)
### 2.1. Aislamiento de Login de Emergencia
- **RF-01 (Ubicuo)**: EL SISTEMA dispondrá de la ruta dedicada `/adm/login` (GET y POST) en el Frontend BFF para el inicio de sesión exclusivo de Administradores con credenciales locales de contingencia.
- **RF-02 (Basado en Eventos)**: CUANDO un usuario ingrese credenciales válidas con rol `ADMIN` en `/adm/login`, EL SISTEMA emitirá la cookie segura `auth_token` y redirigirá al usuario hacia `/dashboard`.
- **RF-03 (No Deseado / Excepciones)**: SI un usuario sin rol `ADMIN` o con credenciales incorrectas intenta iniciar sesión en `/adm/login`, ENTONCES EL SISTEMA denegará el acceso, registrará el evento de auditoría y redirigirá a `/adm/login?error=...` con el mensaje de error correspondiente.
- **RF-04 (Ubicuo)**: EL SISTEMA aplicará protección estricta contra ataques de fuerza bruta (`authLimiter`) en las solicitudes POST dirigidas a `/adm/login`.
### 2.2. Limpieza de Interfaz en `/auth/login` Público
- **RF-05 (Ubicuo)**: EL SISTEMA omitirá en `/auth/login` cualquier mención, texto ("El acceso con contraseña local está deshabilitado para usuarios generales"), enlace o modal referente al "Acceso de Emergencia ADMIN" cuando el acceso local esté deshabilitado para usuarios generales.
- **RF-06 (Estado)**: MIENTRAS la autenticación local esté deshabilitada (`providers.local == false`), EL SISTEMA presentará en `/auth/login` exclusivamente los proveedores institucionales federados (Google Workspace y/o Moodle).
### 2.3. Despliegue Automático de Modo de Autenticación Único
- **RF-07 (Estado)**: MIENTRAS exista exactamente un (1) solo modo de autenticación habilitado entre Google, Moodle y Local:
1. Si el único modo es Moodle, EL SISTEMA mostrará el formulario de Moodle desplegado (`show`) de forma predeterminada, con los campos de usuario y contraseña inmediatamente accesibles.
2. Si el único modo es Local, EL SISTEMA mostrará el formulario local sin divisores redundantes ("o con credenciales locales").
3. Si el único modo es Google, EL SISTEMA mostrará el botón institucional sin divisores.
- **RF-08 (Estado)**: MIENTRAS existan dos (2) o más modos de autenticación habilitados, EL SISTEMA mostrará los selectores con sus divisores correspondientes y acordeón interactivo.
---
## 3. Criterios de Aceptación y Finalización (DoD)
1. Ruta `/adm/login` operativa en Frontend BFF con vista dedicada sobria (`frontend/views/auth/admin_login.html`).
2. Endpoint `/api/v1/auth/adm-login` o validación en backend asegurando que solo usuarios con rol `ADMIN` puedan autenticarse por dicha vía.
3. Vista `/auth/login` limpia: cero textos de "Acceso de Emergencia ADMIN" ni avisos de deshabilitación local.
4. Si Moodle es el único habilitado, el formulario de Moodle aparece desplegado automáticamente sin requerir clic para abrirlo.
5. Cobertura de pruebas automatizadas con pytest en backend (`pytest tests -v`).
6. Pyright con 0 errores y 0 advertencias (`npx pyright`).
7. Bump semántico de versión a `v3.8.5`, registro en `CHANGELOG.md` y `MEMORY.md`.
8. `git push origin dev` y despliegue verificado en producción (`10.0.0.217` / `https://eduspace.oemspot.com.ar`).
+42
View File
@@ -0,0 +1,42 @@
# Tareas: 006-login-emergencia-adm - Aislamiento de Login de Emergencia Admin y Despliegue Automático por Proveedor Único
## Tareas
- [x] **T01: Endpoint Backend `/api/v1/auth/adm-login` y Auditoría**
- **Descripción**: Crear el endpoint `POST /api/v1/auth/adm-login` en `backend/routers/auth.py`. Autenticar credenciales locales y validar estrictamente que el usuario tenga rol `ADMIN` (`is_admin == True`). Emitir eventos de auditoría específicos (`ADMIN_EMERGENCY_LOGIN_FAILED`, `ADMIN_EMERGENCY_LOGIN_DENIED`, `ADMIN_EMERGENCY_LOGIN_SUCCESS`).
- **Hecho cuando**: El endpoint responda 200 con tokens a usuarios admin válidos, 401 a credenciales inválidas y 403 a usuarios no admin.
- **Estimación**: 20 min.
- [x] **T02: Pruebas Automatizadas Backend para Adm Login**
- **Descripción**: Crear archivo de test `backend/tests/test_adm_login.py` cubriendo: autenticación de admin exitosa, rechazo a credenciales erróneas, y rechazo con 403 a usuarios comunes que intenten entrar por la consola de emergencia.
- **Hecho cuando**: `pytest backend/tests/test_adm_login.py` pase al 100%.
- **Estimación**: 15 min.
- [x] **T03: Rutas BFF y Rate Limiting para `/adm/login`**
- **Descripción**: En `frontend/src/app.js` y `frontend/src/routes/auth.js`, configurar `authLimiter` para las solicitudes POST hacia `/adm/login`. Manejar GET `/adm/login` para mostrar la plantilla administrativa y POST `/adm/login` comunicándose con `/api/v1/auth/adm-login` o `/auth/login`. Agregar redirección de `GET /adm` a `/adm/login`.
- **Hecho cuando**: Acceder a `/adm` o `/adm/login` cargue la pantalla correspondiente y las peticiones POST estén protegidas por el limitador.
- **Estimación**: 20 min.
- [x] **T04: Plantilla Nunjucks `admin_login.html`**
- **Descripción**: Crear la vista `frontend/views/auth/admin_login.html` con estética institucional sobria, soporte de modo oscuro/claro, formulario de usuario/contraseña, manejo de errores y sin enlaces visibles hacia la vista pública.
- **Hecho cuando**: La vista renderice correctamente los campos y mensajes de error sin fallos de estilo.
- **Estimación**: 15 min.
- [x] **T05: Limpieza de `/auth/login` y Despliegue por Proveedor Único**
- **Descripción**: En `frontend/src/routes/auth.js` calcular si solo hay 1 proveedor activo (`is_single_provider`). En `frontend/views/auth/login.html`:
1. Eliminar el alert "El acceso con contraseña local está deshabilitado para usuarios generales".
2. Eliminar el modal `adminEmergencyModal`.
3. Si `is_single_provider` y `providers.moodle` es el único activo, agregar la clase `show` a `#moodleLoginForm` para que aparezca abierto de inmediato.
4. Ocultar divisores ("o con credenciales locales") cuando solo haya un único proveedor activo.
- **Hecho cuando**: `/auth/login` no muestre ningún rastro de acceso admin de emergencia y Moodle se despliegue abierto directamente si es el único proveedor.
- **Estimación**: 20 min.
- [x] **T06: Verificación de Código, Pyright y Suite de Pruebas**
- **Descripción**: Ejecutar `npx pyright` verificando 0 errores y correr la suite completa de pruebas `pytest tests -v` en backend.
- **Hecho cuando**: Pyright tenga 0 errores y todos los tests aprueben.
- **Estimación**: 15 min.
- [x] **T07: Bump Semántico a v3.8.5, Git Push y Despliegue en Producción**
- **Descripción**: Incrementar versión a `3.8.5` en `package.json`, `frontend/src/app.js`, `backend/__init__.py`, `backend/setup.py`, `CHANGELOG.md` y `MEMORY.md`. Hacer commit y `git push origin dev`. Desplegar en LXC `10.0.0.217` y verificar HTTP 200 en `/version`.
- **Hecho cuando**: Servidor en producción responda versión `3.8.5` tanto en backend como frontend.
- **Estimación**: 15 min.