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

GuardianUnivalle_Benito_Yucra/detectores/detector_sql.py

@@ -1,93 +1,117 @@
 # 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
-import time
+
+# 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
+
+# Permite acceder a las configuraciones de Django (settings.py)
+# Se usa para obtener rutas excluidas u otras configuraciones personalizadas.
 from django.conf import settings
-from django.core.signing import TimestampSigner, BadSignature, SignatureExpired
 
-# ---------- Configuración de logging ----------
-logger = logging.getLogger("sqlidefense")
+
+# ==============================
+# CONFIGURACIÓN DEL LOG
+# ==============================
+logger = logging.getLogger(
+    "sqlidefense"
+)  # logger para registrar eventos de SQL Injection
 logger.setLevel(logging.INFO)
 if not logger.handlers:
-    handler = logging.StreamHandler()  # en prod usa FileHandler/RotatingFileHandler
+    # 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),
-        "Intento de UNION SELECT detectado",
-    ),
+    (re.compile(r"\bunion\b\s+(all\s+)?\bselect\b", re.I), "UNION SELECT"),
     (
         re.compile(r"\bselect\b.*\bfrom\b.*\bwhere\b.*\b(or|and)\b.*=", re.I),
-        "Intento de SELECT con OR/AND detectado",
-    ),
-    (
-        re.compile(r"\b(or|and)\s+\d+\s*=\s*\d+", re.I),
-        "Intento de OR/AND 1=1 detectado",
+        "SELECT con OR/AND",
     ),
+    (re.compile(r"\b(or|and)\s+\d+\s*=\s*\d+", re.I), "OR/AND 1=1"),
     (
         re.compile(r"\b(drop|truncate|delete|insert|update)\b", re.I),
-        "Intento de manipulación de tabla detectado",
+        "Manipulación de tabla",
     ),
-    (
-        re.compile(r"(--|#|;)", re.I),
-        "Comentario o terminador de sentencia sospechoso detectado",
-    ),
-    (re.compile(r"exec\s*\(", re.I), "Intento de ejecución de procedimiento detectado"),
+    (re.compile(r"(--|#|;)", re.I), "Comentario o terminador sospechoso"),
+    (re.compile(r"exec\s*\(", re.I), "Ejecución de procedimiento"),
 ]
 
-# ---------- Bloqueo temporal por IP ----------
-TEMP_BLOCK = {}  # {ip: timestamp}
-BLOCK_DURATION = getattr(settings, "SQL_DEFENSE_BLOCK_TTL", 30)  # segundos
-
-# ---------- Excepciones y bypass ----------
-EXEMPT_PATHS = getattr(settings, "SQLI_EXEMPT_PATHS", ["/api/login/"])
-BYPASS_HEADER = "HTTP_X_SQLI_BYPASS"
-BYPASS_MAX_AGE = getattr(settings, "SQLI_BYPASS_MAX_AGE", 30)  # segundos (muy corto)
+# ==============================
+# FUNCIONES AUXILIARES
+# ==============================
 
-# JWT support (optional)
-try:
-    from rest_framework_simplejwt.backends import TokenBackend
 
-    SIMPLEJWT_AVAILABLE = True
-except Exception:
-    SIMPLEJWT_AVAILABLE = False
-
-
-# ---------- 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 "{}")
-            # 🔒 quitar campos sensibles antes de loguear/analizar
-            for key in getattr(settings, "SQL_DEFENSE_SENSITIVE_KEYS", []):
-                if key in body_json:
-                    body_json[key] = "***"
             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):
@@ -95,89 +119,51 @@ def detect_sqli_text(text: str) -> Tuple[bool, list]:
     return (len(matches) > 0, matches)
 
 
-def get_client_ip(request):
-    xff = request.META.get("HTTP_X_FORWARDED_FOR")
-    if xff:
-        return xff.split(",")[0].strip()
-    return request.META.get("REMOTE_ADDR", "0.0.0.0")
+# ==============================
+# MIDDLEWARE
+# ==============================
 
 
-def is_valid_jwt(request) -> bool:
-    if not SIMPLEJWT_AVAILABLE:
-        return False
-    auth = request.META.get("HTTP_AUTHORIZATION", "")
-    if not auth or not auth.startswith("Bearer "):
-        return False
-    token = auth.split(" ", 1)[1].strip()
-    try:
-        tb = TokenBackend(
-            algorithm=getattr(settings, "SIMPLE_JWT", {}).get("ALGORITHM", "HS256"),
-            signing_key=getattr(settings, "SIMPLE_JWT", {}).get(
-                "SIGNING_KEY", settings.SECRET_KEY
-            ),
-        )
-        tb.decode(token, verify=True)
-        return True
-    except Exception:
-        return False
-
+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 is_valid_signed_bypass(request) -> bool:
-    signed = request.META.get(BYPASS_HEADER, "")
-    if not signed:
-        return False
-    signer = TimestampSigner(settings.SECRET_KEY)
-    try:
-        signer.unsign(signed, max_age=BYPASS_MAX_AGE)
-        return True
-    except SignatureExpired:
-        logger.info("Bypass token expirado")
-        return False
-    except BadSignature:
-        logger.info("Bypass token inválido")
-        return False
-
-
-# ---------- Middleware ----------
-class SQLIDefenseStrongMiddleware(MiddlewareMixin):
     def process_request(self, request):
-        path = request.path or ""
-        client_ip = get_client_ip(request)
-
-        # 1) Rutas exentas
-        EXEMPT_PATHS = getattr(settings, "SQLI_EXEMPT_PATHS", [])
-        for p in EXEMPT_PATHS:
-            if path.startswith(p):
-                return None
-
-        # 2) IP bloqueada temporalmente
-        if client_ip in TEMP_BLOCK:
-            if time.time() - TEMP_BLOCK[client_ip] < BLOCK_DURATION:
-                logger.warning(f"IP bloqueada temporalmente: {client_ip}")
-                return JsonResponse(
-                    {"detail": "Acceso temporalmente bloqueado"}, status=403
-                )
-            else:
-                del TEMP_BLOCK[client_ip]
-
-        # 3) Extraer payload
+        # 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
 
-        # 4) Detectar SQLi
+        # Detectar patrones SQL Injection
         flagged, matches = detect_sqli_text(text)
         if flagged:
-            TEMP_BLOCK[client_ip] = time.time()
-            logger.warning(
-                f"Intento de ataque detectado desde IP: {client_ip}, detalles: {matches}, payload: {text}"
-            )
+            # Registrar evento en log
+            logger.warning(f"Ataque detectado: {matches}, payload: {text}")
+
+            # Bloquear la solicitud y devolver mensaje
             return JsonResponse(
-                {
-                    "detail": "Request bloqueado: posible inyección SQL",
-                    "alerts": matches,
-                },
-                status=403,
+                {"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.11.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.11
+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.11.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=jyFZYi_VjEF6jvDuUmDOGo5D5IgTzDtprfyaAO-jypU,6095
+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.11.dist-info/licenses/LICENSE,sha256=5e4IdL542v1E8Ft0A24GZjrxZeTsVK7XrS3mZEUhPtM,37
-guardianunivalle_benito_yucra-0.1.11.dist-info/METADATA,sha256=yvOtVZ2eIA8Ztxo2_FjVU97mGetiT8KEr1QQ1iDHExA,1893
-guardianunivalle_benito_yucra-0.1.11.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-guardianunivalle_benito_yucra-0.1.11.dist-info/top_level.txt,sha256=HTWfZM64WAV_QYr5cnXnLuabQt92dvlxqlR3pCwpbDQ,30
-guardianunivalle_benito_yucra-0.1.11.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,,