Guía Oficial de Operación

MetaProxy v2
Manual de Usuario y Administración

Guía Paso a Paso para Investigadores, Estudiantes y Administradores de Biblioteca
Versión:2.0.0 (MVP)
Organización:Metabiblioteca
Fecha de Emisión:Octubre 2026
Audiencia:Usuarios Finales y Administradores de Biblioteca

PARTE 1: Guía para el Estudiante e Investigador

[ Diagrama de Flujo: Navegación del Usuario Final ]
+---------------------------------------------------------------------------------------+ | FLUJO DE NAVEGACION PARA INVESTIGADORES Y ESTUDIANTES | | | | [ INICIO ] | | │ | | ▼ | | 1. Acceso al Portal Institucional: https://temp-proxy07.metaproxy.org/login | | │ | | ▼ | | 2. Autenticación con Usuario y Contraseña Institucional (Validado con Argon2id) | | │ | | ▼ | | 3. Catálogo de Recursos Autorizados (ScienceDirect, EBSCOhost, Springer, etc.) | | │ | | ▼ | | 4. Clic en Recurso -> Salto Transparente a Subdominio Codificado: | | https://www-sciencedirect-com.temp-proxy07.metaproxy.org/ | | │ | | ▼ | | 5. Navegación Protegida dentro de la Editorial (Reconocido como miembro autorizado) | | │ | | ▼ | | 6. Búsqueda de Artículos y Descarga Directa de PDFs a Máxima Velocidad | | │ | | ▼ | | 7. Cierre de Sesión Seguro en /logout (Destruye sesión y cookies en Valkey) | | │ | | [ FIN ] | +---------------------------------------------------------------------------------------+
1 Acceso al Portal de la Biblioteca
Abra su navegador web e ingrese a la dirección asignada a su institución:
2 Inicio de Sesión Seguro
Ingrese con su usuario institucional y contraseña registrada en la universidad. Al validar sus datos, el portal le redirigirá al catálogo general de bases de datos científicas autorizadas.
3 Consulta y Navegación de Recursos
Haga clic en la base de datos de su interés (por ejemplo ScienceDirect o EBSCOhost). Su navegador navegará bajo la dirección protegida https://www-sciencedirect-com.temp-proxy07.metaproxy.org/....
La editorial reconocerá su conexión como proveniente del campus universitario y habilitará la lectura y descarga inmediata de artículos y libros electrónicos.
4 Cierre de Sesión
Al culminar sus labores de investigación, presione "Cerrar Sesión" para revocar de inmediato las credenciales en equipos públicos o compartidos.

PARTE 2: Guía del Administrador de Biblioteca (Panel Web)

El panel administrativo permite a los bibliotecólogos y personal de TI gestionar recursos y supervisar el uso institucional en tiempo real sin requerir conocimientos avanzados de servidores.

1. Ingreso al Panel Administrativo

Acceda a https://temp-proxy07.metaproxy.org:9443/ desde la red de gestión o VPN autorizada.

[ Arquitectura de la Interfaz Administrativa Web SPA (:9443) ]
+---------------------------------------------------------------------------------------+ | ARQUITECTURA DE LA INTERFAZ ADMINISTRATIVA WEB SPA (PUERTO :9443) | | | | +-----------------------------------------------------------------------------------+ | | | HEADER: MetaProxy v2 | Badge tmpproxy-04 ONLINE | Botón Refrescar en Vivo | | | +-----------------------------------------------------------------------------------+ | | | BARRA LATERAL (NAV) | CONTENIDO DINAMICO SEGUN LA PESTAÑA SELECCIONADA | | | | | | | | | [1] Tablero (KPIs) | -> Métricas en Vivo: Tenants, Perfiles, Sesiones Activas | | | | [2] Tenants & Egress| -> Tabla de Instituciones, Interfaces (eth0/eth1) e IPs | | | | [3] Perfiles | -> Catálogo de Bases de Datos (ScienceDirect, EBSCO, etc.) | | | | [4] Probador Rutas | -> Simulador de resolución: URL + Método -> PROXY / BLOCK | | | | [5] Editor YAML | -> Editor interactivo con "Validar YAML" y "Guardar Perfil" | | | | [6] Sesiones | -> Tabla de usuarios conectados con botón "Revocar Sesión" | | | | [7] Analítica | -> Clasificación MuseProxy TipoAccion (0-13) y Top Editoras | | | | [8] Diagnóstico Red | -> Monitoreo Interfaces, Resolución Wildcard DNS y Egress | | | | [9] Documentación | -> Enlaces de descarga directa de Manuales (.docx, .html) | | | +-----------------------------------------------------------------------------------+ | +---------------------------------------------------------------------------------------+

2. Módulos del Panel de Control

MóduloFuncionalidad Clave
Visión GeneralTablero de control con métricas en vivo (tenants, perfiles, sesiones, volumen de peticiones y log de eventos).
Tenants & EgressGestión de universidades, dominios asignados e IPs públicas de salida (54.36.18.254 / 54.36.18.253).
Perfiles AcadémicosCatálogo de bases de datos configuradas (EBSCO, ScienceDirect, Springer, JSTOR, ProQuest, etc.).
Probador de RutasHerramienta interactiva para simular cómo el proxy enrutará cualquier URL antes de compartirla con los docentes.
Editor & ValidadorEditor web de especificaciones YAML con compilación en caliente y verificación de pruebas unitarias embebidas.
Sesiones ActivasTabla de usuarios conectados en tiempo real con posibilidad de revocar sesiones sospechosas en 1 clic.
Analítica & MetabaseReportes de uso clasificados por TipoAccion (Entrada, Búsqueda, Metadatos, Descarga de PDF).
Diagnóstico & RedPruebas de conectividad de interfaces físicas eth0/eth1 y resolución DNS de comodines.

3. Cómo Probar una URL en el Probador de Rutas

  1. Haga clic en la pestaña "Probador de Rutas" en el menú lateral.
  2. Pegue el enlace del artículo o revista en el campo de texto (ej. https://search.ebscohost.com/login.aspx).
  3. Presione el botón "Evaluar Resolución".
  4. El sistema le confirmará de inmediato si el recurso está autorizado (PROXY), qué base de datos lo respalda y cuál será la dirección web final que verá el estudiante.
[ Flujo de Evaluación en Tiempo Real del Probador de Rutas ]
+---------------------------------------------------------------------------------------+ | FLUJO DE EVALUACION EN TIEMPO REAL DEL PROBADOR DE RUTAS (ROUTE MATCHER) | | | | [Administrador Web] [Control Plane API :9443] | | │ │ | | 1. │── Ingresa URL: https://search.ebscohost.com/login ─>│ | | │ Selecciona Método: GET │ | | │ Presiona: "Evaluar Resolución" │ | | 2. │ │── Normalizar URL | | │ │ Host: ebscohost.com | | 3. │ │── Buscar en RuleSet | | │ │ Perfil: "ebsco" | | │ │ Regla: "login-dir" | | 4. │ │── Codificar Host: | | │ │ search-ebscohost-com| | │ │ .temp-proxy07... | | 5. │ │── Asignar Egress IP: | | │ │ 54.36.18.254 (eth0) | | 6. │ │── Tipo de Acción: | | │ │ ID 0 · Entrada | | 7. │<── Respuesta JSON con Resultado Completo ───────────│ | | 8. │── Renderiza Tarjetas y Badges de Decisión PROXY ──┐ │ | | │<──────────────────────────────────────────────────┘ │ | +---------------------------------------------------------------------------------------+

4. Interpretación de Estadísticas de Uso

MetaProxy clasifica automáticamente el tráfico conforme a las categorías estándar de la biblioteca: