GuardianUnivalle-Benito-Yucra 0.1.66__py3-none-any.whl → 0.1.67__py3-none-any.whl

{guardianunivalle_benito_yucra-0.1.66.dist-info → guardianunivalle_benito_yucra-0.1.67.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: GuardianUnivalle-Benito-Yucra
-Version: 0.1.66
+Version: 0.1.67
 Summary: Middleware y detectores de seguridad (SQLi, XSS, CSRF, DoS) para Django/Flask
 Author-email: Andres Benito Calle Yucra <benitoandrescalle035@gmail.com>
 License: MIT
@@ -23,6 +23,8 @@ Dynamic: license-file
 
 <!-- Información de la librería -->
 
+![Guardian Univalle – Benito & Junkrat](![Guardian Univalle – Benito & Junkrat](https://raw.githubusercontent.com/Andyyupy/guardianunivalle-benito-yucra/main/docs/logo_guardian.png))
+
 🛡️ Guardian Univalle – Benito & Junkrat
 
 Framework de detección y defensa de amenazas web para Django
@@ -35,15 +37,11 @@ Cada módulo opera mediante middleware independientes que analizan el tráfico H
 Guardian Univalle está diseñado bajo una arquitectura modular y extensible, donde cada tipo de amenaza se gestiona mediante un middleware especializado.
 Cada middleware:
 
-Se ejecuta en la fase inicial del request (process_request).
-
-Analiza cabeceras, cuerpo y metadatos de la petición.
-
-Evalúa indicadores de ataque según patrones heurísticos y reglas configurables.
-
-Calcula una puntuación de riesgo (score) para cada evento.
-
-Anexa la información al objeto request (por ejemplo, request.xss_attack_info) para que otros módulos (como el de auditoría) la procesen.
+- Se ejecuta en la fase inicial del request (process_request).
+- Analiza cabeceras, cuerpo y metadatos de la petición.
+- Evalúa indicadores de ataque según patrones heurísticos y reglas configurables.
+- Calcula una puntuación de riesgo (score) para cada evento.
+- Anexa la información al objeto request (por ejemplo, request.xss_attack_info) para que otros módulos (como el de auditoría) la procesen.
 
 🧩 Módulos de defensa incluidos
 
@@ -53,15 +51,11 @@ Defensa contra Cross-Site Request Forgery (CSRF).
 
 Este módulo detecta intentos de falsificación de peticiones mediante:
 
-Verificación de cabeceras Origin y Referer contra el host real.
-
-Validación de tokens CSRF en cookies, cabeceras o formularios.
-
-Análisis del tipo de contenido (Content-Type) y parámetros sensibles.
-
-Detección de peticiones JSON o formularios enviados desde dominios externos.
-
-Asignación de un score de riesgo proporcional al número y severidad de señales encontradas.
+- Verificación de cabeceras Origin y Referer contra el host real.
+- Validación de tokens CSRF en cookies, cabeceras o formularios.
+- Análisis del tipo de contenido (Content-Type) y parámetros sensibles.
+- Detección de peticiones JSON o formularios enviados desde dominios externos.
+- Asignación de un score de riesgo proporcional al número y severidad de señales encontradas.
 
 Algoritmos utilizados:
 Heurísticas basadas en cabeceras HTTP, validación semántica de origen, y detección de anomalías en métodos POST, PUT, DELETE y PATCH.
@@ -72,15 +66,11 @@ Defensa contra Cross-Site Scripting (XSS).
 
 Analiza en profundidad los datos enviados en el cuerpo y querystring, detectando vectores de inyección HTML/JS mediante:
 
-Patrones de alto riesgo (<script>, javascript:, onload=, eval()).
-
-Ofuscaciones con entidades (&#x3C;, %3Cscript).
-
-Detección de atributos de eventos (onmouseover, onfocus, etc.).
-
-Análisis de URIs maliciosas (data:text/html, vbscript:).
-
-Scoring ponderado por severidad (de 0.3 a 0.95).
+- Patrones de alto riesgo (<script>, javascript:, onload=, eval()).
+- Ofuscaciones con entidades (&#x3C;, %3Cscript).
+- Detección de atributos de eventos (onmouseover, onfocus, etc.).
+- Análisis de URIs maliciosas (data:text/html, vbscript:).
+- Scoring ponderado por severidad (de 0.3 a 0.95).
 
 Algoritmos utilizados:
 Detección basada en expresiones regulares avanzadas con pesos heurísticos y uso opcional de la librería Bleach para sanitización comparativa.
@@ -94,13 +84,10 @@ Defensa contra Inyección SQL (SQLi).
 
 Identifica intentos de inyección SQL en los parámetros enviados a través de:
 
-Palabras clave peligrosas (UNION, SELECT, DROP, INSERT, UPDATE).
-
-Uso de comentarios (--, #, /_ ... _/).
-
-Concatenaciones o subconsultas sospechosas.
-
-Comportamientos anómalos en parámetros GET, POST o JSON.
+- Palabras clave peligrosas (UNION, SELECT, DROP, INSERT, UPDATE).
+- Uso de comentarios (--, #, /_ ... _/).
+- Concatenaciones o subconsultas sospechosas.
+- Comportamientos anómalos en parámetros GET, POST o JSON.
 
 Algoritmos utilizados:
 Heurísticas sintácticas + patrones combinados con contextos.
@@ -115,13 +102,10 @@ Detección de ataques de Denegación de Servicio (DoS).
 
 Monitorea la frecuencia de peticiones por IP y calcula una métrica adaptativa de comportamiento:
 
-Detecta exceso de solicitudes en intervalos cortos.
-
-Analiza User-Agent, patrones repetitivos y tamaño de payloads.
-
-Aplica límites configurables (MAX_REQUESTS_PER_WINDOW).
-
-Marca IPs sospechosas para registro y bloqueo temporal.
+- Detecta exceso de solicitudes en intervalos cortos.
+- Analiza User-Agent, patrones repetitivos y tamaño de payloads.
+- Aplica límites configurables (MAX_REQUESTS_PER_WINDOW).
+- Marca IPs sospechosas para registro y bloqueo temporal.
 
 Algoritmos utilizados:
 Sliding Window con conteo adaptativo en memoria, controlado por señales de frecuencia e intensidad.
@@ -132,13 +116,10 @@ Detección de scraping y bots automatizados.
 
 Evalúa características típicas de scraping:
 
-User-Agent anómalo o ausente.
-
-Patrón de navegación repetitivo o excesivamente rápido.
-
-Ausencia de cabeceras humanas (como Accept-Language o Referer).
-
-Combinación con heurísticas de DoS para detectar scrapers agresivos.
+- User-Agent anómalo o ausente.
+- Patrón de navegación repetitivo o excesivamente rápido.
+- Ausencia de cabeceras humanas (como Accept-Language o Referer).
+- Combinación con heurísticas de DoS para detectar scrapers agresivos.
 
 Algoritmos utilizados:
 Análisis estadístico de cabeceras + patrones de comportamiento a corto plazo.

{guardianunivalle_benito_yucra-0.1.66.dist-info → guardianunivalle_benito_yucra-0.1.67.dist-info}/RECORD

@@ -12,8 +12,8 @@ GuardianUnivalle_Benito_Yucra/middleware_web/middleware_web.py,sha256=23pLLYqliU
 GuardianUnivalle_Benito_Yucra/mitigacion/limitador_peticion.py,sha256=ipMOebYhql-6mSyHs0ddYXOcXq9w8P_IXLlpiIqGncw,246
 GuardianUnivalle_Benito_Yucra/mitigacion/lista_bloqueo.py,sha256=6AYWII4mrmwCLHCvGTyoBxR4Oasr4raSHpFbVjqn7d8,193
 GuardianUnivalle_Benito_Yucra/puntuacion/puntuacion_amenaza.py,sha256=Wx5XfcII4oweLvZsTBEJ7kUc9pMpP5-36RfI5C5KJXo,561
-guardianunivalle_benito_yucra-0.1.66.dist-info/licenses/LICENSE,sha256=5e4IdL542v1E8Ft0A24GZjrxZeTsVK7XrS3mZEUhPtM,37
-guardianunivalle_benito_yucra-0.1.66.dist-info/METADATA,sha256=3YZF8Q9oZhikUrxQmhEK6wNeJM0shLzE9XUlwueaRds,7512
-guardianunivalle_benito_yucra-0.1.66.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-guardianunivalle_benito_yucra-0.1.66.dist-info/top_level.txt,sha256=HTWfZM64WAV_QYr5cnXnLuabQt92dvlxqlR3pCwpbDQ,30
-guardianunivalle_benito_yucra-0.1.66.dist-info/RECORD,,
+guardianunivalle_benito_yucra-0.1.67.dist-info/licenses/LICENSE,sha256=5e4IdL542v1E8Ft0A24GZjrxZeTsVK7XrS3mZEUhPtM,37
+guardianunivalle_benito_yucra-0.1.67.dist-info/METADATA,sha256=ULHeOjATiTpxu8T2Qoh_4YhIXsZGEQS97a3mFiMar7I,7714
+guardianunivalle_benito_yucra-0.1.67.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+guardianunivalle_benito_yucra-0.1.67.dist-info/top_level.txt,sha256=HTWfZM64WAV_QYr5cnXnLuabQt92dvlxqlR3pCwpbDQ,30
+guardianunivalle_benito_yucra-0.1.67.dist-info/RECORD,,