# 🛡️ Escudo Anti-Filtración de Contraseñas Corporativas (HaveIBeenPwned API)

> **Resumen para No Técnicos**: Permite que tu Inteligencia Artificial audite de forma segura y ética los correos electrónicos corporativos de tu empresa (ej: `gerencia@tuempresa.com`, `ventas@tuempresa.com`) para saber si sus contraseñas han sido robadas en filtraciones masivas de internet, alertándote para cambiarlas antes de que criminales hackeen tus cuentas bancarias o redes sociales.

| Metadato | Detalle |
|---|---|
| **Tipo** | API REST Oficial de Ciberseguridad y Fuga de Credenciales |
| **Área Empresarial** | 07. Legal, Ciberseguridad y Protección de Activos |
| **Nivel de Dificultad** | 🟢 Fácil |
| **Modelo de Costo** | Consulta individual gratuita / API Key de dominio corporativo desde $3.50 USD al mes |
| **Enlace Oficial** | [Have I Been Pwned API](https://haveibeenpwned.com/API/v3) |

---

## 💡 ¿Para qué le sirve a tu empresa? (Valor Real)

El 80% de los hackeos a pequeñas empresas en Latinoamérica no ocurren por virus sofisticados, sino porque **un empleado usó la misma contraseña del correo de la empresa en una página de compras o juego que fue hackeada hace 2 años**.

Los ciberdelincuentes compran esas listas de contraseñas filtradas en la *Dark Web* y prueban acceder a los correos, portales bancarios y redes sociales de tu empresa.

Con **HaveIBeenPwned API**:
- La IA corre una auditoría preventiva de los correos de tu dominio.
- Te indica qué correos están comprometidos y en qué filtración aparecieron (ejemplo: *"El correo de contabilidad apareció en la filtración de Canva 2019 con contraseña expuesta"*).
- Genera una alerta inmediata para forzar el cambio de contraseña y activar la verificación en dos pasos (2FA).

---

## 🎁 ¿Qué valor aporta frente a soluciones tradicionales?

- **Auditoría Preventiva**: Te enteras del riesgo antes de que te secuestren una cuenta.
- **Protección de Cuentas Bancarias**: Evita accesos no autorizados a pasarelas de pago y portales de banca en línea.
- **Cero Revelación de Contraseñas**: Utiliza un protocolo matemático seguro (*k-Anonymity*) donde nunca envías tu contraseña real a internet para verificarla.

---

## 🔑 ¿Qué necesitas para activarlo?

1. Una cuenta de suscriptor de API en [haveibeenpwned.com](https://haveibeenpwned.com/API/Key).
2. Tu `HIBP_API_KEY`.

---

## ⚙️ Configuración Paso a Paso

Variables de entorno para tus scripts de auditoría periódica:

```env
# Variables de entorno (.env)
HIBP_API_KEY=1234567890abcdef1234567890abcdef
DOMINIO_EMPRESA=tuempresa.com
```

---

## 🤖 Consultor Interactivo (Prompt Guiado para tu IA)

Copia y pega este prompt en tu chat con la IA:

```markdown
Actúa como mi Oficial de Ciberseguridad y Auditor de Riesgos Digitales.
Vamos a auditar las cuentas de correo corporativas de la empresa para detectar credenciales vulneradas.

Por favor, pregúntame:
1. ¿Cuál es el dominio corporativo o lista de correos que deseas auditar hoy?
2. ¿Cuándo fue la última vez que el equipo realizó un cambio general de contraseñas?

Con los resultados de la consulta a HaveIBeenPwned, estructuraré:
- Semáforo de riesgo por cada cuenta auditada (Limpia 🟢 o Comprometida 🔴).
- Detalle de incidentes históricos donde apareció cada correo comprometido.
- Protocolo de acción inmediata de 3 pasos para el personal afectado (Cambio de clave + Activación de 2FA + Revisión de dispositivos conectados).
```

---

## 🌎 Caso de Uso Real en América Latina

**Empresa**: "Constructora e Inmobiliaria Los Sauces" (Edificación residencial en Guadalajara, México).
- **Problema**: Hackearon la cuenta de correo de la asistente de pagos y enviaron una cuenta bancaria falsa a un cliente que iba a pagar un enganche de $15,000 USD.
- **Resultado con la API**: Implementaron auditorías quincenales de seguridad. Detectaron que 3 correos de compras tenían contraseñas viejas expuestas en internet. Las cambiaron de inmediato y activaron 2FA obligatorio, cerrando la puerta a nuevos fraudes.

---

## 🛡️ Reglas de Oro de Ciberseguridad

1. **Activa siempre la Verificación en Dos Pasos (2FA / MFA)** en Google Workspace, Microsoft 365, bancos y redes sociales usando aplicaciones como Google Authenticator o Microsoft Authenticator (evita 2FA por SMS si es posible).
2. **Nunca reutilices la misma contraseña**: Usa un gestor de contraseñas seguro como Bitwarden o 1Password para tu equipo.