GuardianUnivalle-Benito-Yucra 0.1.12__py3-none-any.whl → 0.1.13__py3-none-any.whl

GuardianUnivalle_Benito_Yucra/detectores/detector_sql.py

@@ -1,20 +1,55 @@
 # detector_sql.py
+# =====================================================
+# Importaciones de librerías
+# =====================================================
+
+# Módulo para trabajar con expresiones regulares (regex)
+# Permite buscar patrones de texto dentro de cadenas.
 import re
+
+# Módulo para trabajar con datos en formato JSON
+# Permite convertir cadenas JSON a objetos Python y viceversa.
 import json
+
+# Módulo para manejo de logs (registro de eventos)
+# Permite registrar alertas, información o errores en la consola o en archivos.
 import logging
+
+# Tipado estático
+# Permite indicar tipos de datos de variables o valores de retorno en funciones.
 from typing import Tuple
+
+# Clase de Django para enviar respuestas HTTP en formato JSON
+# Se usa para devolver mensajes al cliente en caso de error o detección de ataques.
 from django.http import JsonResponse
+
+# Clase base para crear middlewares en Django (compatible con versiones antiguas)
+# Permite definir métodos como process_request o process_response para interceptar solicitudes y respuestas.
 from django.utils.deprecation import MiddlewareMixin
 
-logger = logging.getLogger("sqlidefense")
+# Permite acceder a las configuraciones de Django (settings.py)
+# Se usa para obtener rutas excluidas u otras configuraciones personalizadas.
+from django.conf import settings
+
+
+# ==============================
+# CONFIGURACIÓN DEL LOG
+# ==============================
+logger = logging.getLogger(
+    "sqlidefense"
+)  # logger para registrar eventos de SQL Injection
 logger.setLevel(logging.INFO)
 if not logger.handlers:
+    # Si no tiene manejadores, agregar uno por defecto a consola
     handler = logging.StreamHandler()
     formatter = logging.Formatter("%(asctime)s - %(levelname)s - %(message)s")
     handler.setFormatter(formatter)
     logger.addHandler(handler)
 
-# ---------- Patrones de ataques SQL ----------
+# ==============================
+# PATRONES DE ATAQUE SQL
+# ==============================
+# Cada tupla contiene (expresión regular, descripción del ataque)
 PATTERNS = [
     (re.compile(r"\bunion\b\s+(all\s+)?\bselect\b", re.I), "UNION SELECT"),
     (
@@ -30,27 +65,53 @@ PATTERNS = [
     (re.compile(r"exec\s*\(", re.I), "Ejecución de procedimiento"),
 ]
 
+# ==============================
+# FUNCIONES AUXILIARES
+# ==============================
+
 
-# ---------- Helpers ----------
 def extract_payload_text(request) -> str:
+    """
+    Extrae texto de la solicitud que será analizado por patrones SQL Injection.
+    Se considera:
+        - Cuerpo de la solicitud (JSON o texto plano)
+        - Query String (parámetros GET)
+        - User-Agent
+        - Referer
+    """
     parts = []
     content_type = request.META.get("CONTENT_TYPE", "")
+
     try:
+        # Si es JSON, decodificarlo
         if "application/json" in content_type:
             body_json = json.loads(request.body.decode("utf-8") or "{}")
             parts.append(json.dumps(body_json))
         else:
             parts.append(request.body.decode("utf-8", errors="ignore"))
     except Exception:
+        # Ignorar errores al decodificar
         pass
+
+    # Agregar Query String
     if request.META.get("QUERY_STRING"):
         parts.append(request.META.get("QUERY_STRING"))
+
+    # Agregar User-Agent y Referer
     parts.append(request.META.get("HTTP_USER_AGENT", ""))
     parts.append(request.META.get("HTTP_REFERER", ""))
+
+    # Retornar todo el texto concatenado
     return " ".join([p for p in parts if p])
 
 
 def detect_sqli_text(text: str) -> Tuple[bool, list]:
+    """
+    Detecta si un texto contiene patrones de SQL Injection.
+    Retorna:
+        - flagged (bool): True si se detecta algún patrón
+        - matches (list): lista de descripciones de patrones detectados
+    """
     matches = []
     for patt, message in PATTERNS:
         if patt.search(text):
@@ -58,18 +119,51 @@ def detect_sqli_text(text: str) -> Tuple[bool, list]:
     return (len(matches) > 0, matches)
 
 
-# ---------- Middleware ----------
+# ==============================
+# MIDDLEWARE
+# ==============================
+
+
 class SQLIDefenseMiddleware(MiddlewareMixin):
+    """
+    Middleware para proteger la aplicación contra ataques de SQL Injection.
+    Analiza cada solicitud entrante y bloquea si detecta patrones maliciosos,
+    excepto en rutas definidas como confiables en settings.SQLI_DEFENSE_EXCLUDED_PATHS.
+    """
+
     def process_request(self, request):
+        # Obtener rutas excluidas desde settings
+        excluded_paths = getattr(settings, "SQLI_DEFENSE_EXCLUDED_PATHS", [])
+
+        # Saltar verificación si la ruta está excluida
+        if any(request.path.startswith(p) for p in excluded_paths):
+            return None
+
+        # Extraer texto de la solicitud
         text = extract_payload_text(request)
         if not text:
             return None
 
+        # Detectar patrones SQL Injection
         flagged, matches = detect_sqli_text(text)
         if flagged:
+            # Registrar evento en log
             logger.warning(f"Ataque detectado: {matches}, payload: {text}")
+
+            # Bloquear la solicitud y devolver mensaje
             return JsonResponse(
                 {"mensaje": "Ataque detectado", "tipos": matches}, status=403
             )
 
         return None
+
+
+"""
+Notas adicionales:
+- Se puede aplicar cifrado AES-256 para guardar consultas auditadas.
+- Se puede usar hash SHA-256 para verificar integridad de registros.
+- Índice de amenaza:
+    S_sql = w_sql * detecciones_sql
+    donde w_sql es el peso asignado a SQL Injection
+          detecciones_sql es la cantidad de patrones detectados
+"""

{guardianunivalle_benito_yucra-0.1.12.dist-info → guardianunivalle_benito_yucra-0.1.13.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: GuardianUnivalle-Benito-Yucra
-Version: 0.1.12
+Version: 0.1.13
 Summary: Middleware y detectores de seguridad (SQLi, XSS, CSRF, DoS, Keylogger) para Django/Flask
 Author-email: Andres Benito Calle Yucra <benitoandrescalle035@gmail.com>
 License: MIT

{guardianunivalle_benito_yucra-0.1.12.dist-info → guardianunivalle_benito_yucra-0.1.13.dist-info}/RECORD

@@ -7,14 +7,14 @@ GuardianUnivalle_Benito_Yucra/criptografia/kdf.py,sha256=_sbepEY1qHEKga0ExrX2WRg
 GuardianUnivalle_Benito_Yucra/detectores/detector_csrf.py,sha256=EAYfLkHuxGC5rXSu4mZJ4yZDCbwBpTX8xZWGKz7i5wA,692
 GuardianUnivalle_Benito_Yucra/detectores/detector_dos.py,sha256=lMWmCw6nccCEnek53nVjpoBCeiBqLdrSXxqRuI7VP2I,696
 GuardianUnivalle_Benito_Yucra/detectores/detector_keylogger.py,sha256=rEDG-Q_R56OsG2ypfHVBK7erolYjdvATnAxB3yvPXts,729
-GuardianUnivalle_Benito_Yucra/detectores/detector_sql.py,sha256=Sr2gGAKPgOA8FUwyrMDU2q7h91lY5KWs0Xwhm0B3RKg,2536
+GuardianUnivalle_Benito_Yucra/detectores/detector_sql.py,sha256=6fUm0ecbfaYnv_3PKyAPRf88jodqpBQ7glDAjIo17F0,5888
 GuardianUnivalle_Benito_Yucra/detectores/detector_xss.py,sha256=66V_xuxNOZEwluvWOT4-6pk5MJ3zWE1IwcVkBl7MZSg,719
 GuardianUnivalle_Benito_Yucra/middleware_web/middleware_web.py,sha256=23pLLYqliUoMrIC6ZEwz3hKXeDjWfHSm9vYPWGmDDik,495
 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.12.dist-info/licenses/LICENSE,sha256=5e4IdL542v1E8Ft0A24GZjrxZeTsVK7XrS3mZEUhPtM,37
-guardianunivalle_benito_yucra-0.1.12.dist-info/METADATA,sha256=wUUpR44XgfP7gLoBeBQoSxZ72f_gJuZ1EGDT6NJriRs,1893
-guardianunivalle_benito_yucra-0.1.12.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-guardianunivalle_benito_yucra-0.1.12.dist-info/top_level.txt,sha256=HTWfZM64WAV_QYr5cnXnLuabQt92dvlxqlR3pCwpbDQ,30
-guardianunivalle_benito_yucra-0.1.12.dist-info/RECORD,,
+guardianunivalle_benito_yucra-0.1.13.dist-info/licenses/LICENSE,sha256=5e4IdL542v1E8Ft0A24GZjrxZeTsVK7XrS3mZEUhPtM,37
+guardianunivalle_benito_yucra-0.1.13.dist-info/METADATA,sha256=tiFV5DaY10YDhl93panqR-ZXQ9XNCVsN6ckOGavSZm0,1893
+guardianunivalle_benito_yucra-0.1.13.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+guardianunivalle_benito_yucra-0.1.13.dist-info/top_level.txt,sha256=HTWfZM64WAV_QYr5cnXnLuabQt92dvlxqlR3pCwpbDQ,30
+guardianunivalle_benito_yucra-0.1.13.dist-info/RECORD,,