# Seguridad

> Resumen público del modelo de amenazas de Messajo, cómo se guarda cada dato sensible y cómo reportar una vulnerabilidad.

Esta página resume la revisión de seguridad de la `1.0.0`: las fronteras del sistema, los controles de cada una y cómo se guardan los datos sensibles. La revisión sigue el [OWASP API Security Top 10 (2023)](https://owasp.org/API-Security/editions/2023/en/0x11-t10/) y un análisis STRIDE por frontera.

## Fronteras y controles

| Frontera | Controles |
|---|---|
| Meta → webhooks de entrada | firma `X-Hub-Signature-256` verificada en tiempo constante sobre el cuerpo crudo; cuerpo de hasta 5 MiB; deduplicación del cuerpo crudo; canal sin credenciales responde `503` |
| Meta → endpoint de Flows → tu handler | firma de Meta, límite de fallos por IP y de intercambios por Flow, descifrado con la clave de la cuenta; el handler recibe el pedido firmado con `Messajo-Signature`, solo en `https` público |
| Tu aplicación → `/v1` y WebSocket | clave de API con permisos y alcance de conexiones; límite por clave y por organización; tope de cuerpo por ruta; campo desconocido rechazado; toda lectura filtra por la organización de la clave |
| Navegador → panel y páginas públicas | sesión con cookie `HttpOnly`, 2FA obligatorio para dueño y admin, verificación de `Origin` en las escrituras, CSP y encabezados de seguridad; páginas públicas (enlaces de conexión, invitaciones, eliminación de datos) con límite por IP |
| Messajo → tus destinos | firma HMAC-SHA256 en cada envío; anti-SSRF que resuelve el DNS, rechaza IP privada y conecta a la IP verificada |
| Messajo → Graph de Meta | origen fijo; tokens cifrados en la base; respuesta validada antes de usarla |
| Operador | super-admin, colas y `/metrics` detrás de autenticación propia; logs con redacción automática de secretos |
| Cadena de suministro | versiones fijas, `bun audit` y escaneo de secretos en la CI; la imagen corre sin `root` |

Cada ruta del servidor tiene una política declarada (autenticación, límite y cuerpo máximo); una prueba hace fallar la CI si aparece una ruta sin política.

## Datos sensibles

| Dato | Cómo queda |
|---|---|
| Tokens de Meta, PIN del número, clave privada de Flow | cifrados (AES-256-GCM) en la base; la API muestra como máximo los 4 últimos caracteres |
| Secretos de destino y del handler de Flow | cifrados; aparecen solo en la respuesta que los genera |
| Claves de API, tokens de enlace de conexión | solo el hash |
| Credencial SIP | no queda: se pasa a Meta y se muestra una vez |
| Código OTP | no se guarda; mensaje, eventos y logs llevan el código enmascarado ([Plantillas de autenticación](/es/guides/authentication-templates/)) |
| SDP de las llamadas (IP del contacto) | se borra 1 h después del fin de la llamada; la API solo muestra `has_sdp` |
| Datos escritos en un Flow con endpoint | no se guardan; Messajo guarda solo los metadatos del intercambio, por 7 días |
| Mensajes, contactos y medios | retención de la organización (90 días por defecto), exportación y borrado en [Datos y privacidad](/es/operate/data-privacy/) |

## Reportar una vulnerabilidad

**No abras un issue público.** Escribe a `security@messajo.com`, con la descripción, la versión, los pasos para reproducir y cómo quieres que te acrediten.

| Etapa | Plazo |
|---|---|
| Confirmación de recepción | hasta 72 horas hábiles |
| Evaluación inicial | hasta 7 días |
| Divulgación pública | hasta 90 días después del reporte, o antes si la corrección ya salió |

La política completa está en el `SECURITY.md` del repositorio.
