Metadata-Version: 2.4
Name: sk-datafort
Version: 0.1.0
Summary: Escudo de seguridad para aplicaciones con datos masivos frente a filtraciones y accesos anómalos.
Author-email: Santiago <santiago@tuemail.com>
Project-URL: Homepage, https://github.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Security
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: cryptography>=42.0.0

# SK DataFort 🛡️

**SK DataFort** es una librería de Python de alta seguridad diseñada específicamente para aplicaciones que manejan miles o millones de registros (plataformas educativas, hospitales, universidades, comercios y servicios de IA). 

Su objetivo no es solo evitar accesos no autorizados en la entrada, sino actuar como un escudo interno para impedir que errores de programación o fugas de credenciales expongan bases de datos masivas.

## 🚀 Funciones Principales

*   **Detección de Contexto Anómalo:** Monitoreo en tiempo real de direcciones IP y dispositivos (*User-Agent*) para bloquear accesos sospechosos y mitigar secuestros de sesión.
*   **Control de Políticas de Datos:** Restricción estricta de exportaciones masivas (*Anti-scraping*) y validación de límites de consumo por consulta.
*   **Cifrado de Campos Sensibles:** Encriptación robusta a nivel de base de datos para proteger registros críticos.
*   **Logs de Auditoría Automáticos:** Registro indestructible de anomalías e intentos de hackeo en archivos de seguridad local.

## 📦 Instalación (Modo Desarrollo)

Para clonar e instalar este escudo de seguridad de forma local en tus proyectos, ejecuta en tu terminal:

```bash
cd libreria
pip install -e .
```

## 💻 Ejemplo de Uso Rápido

Así de fácil es proteger tus endpoints contra cambios drásticos de dispositivo o IP:

```python
from sk_datafort import AnomalyDetector

detector = AnomalyDetector()

# Validar el ingreso del usuario legítimo
autorizado, mensaje = detector.verify_context(
    user_id="user_123", 
    current_ip="192.168.1.50", 
    current_device="iPhone 15 Pro"
)

# Si un atacante intenta usar las credenciales desde otra IP/Dispositivo
bloqueado, mensaje = detector.verify_context(
    user_id="user_123", 
    current_ip="185.45.22.10", 
    current_device="Windows Chrome"
)
# Retorna: False | Genera una alerta automática en 'seguridad_alertas.log'
```

## 📄 Licencia

Este proyecto está bajo la Licencia MIT.
