Operación
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) y un análisis STRIDE por frontera.
Fronteras y controles
Sección titulada «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
Sección titulada «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) |
| 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 |
Reportar una vulnerabilidad
Sección titulada «Reportar una vulnerabilidad»No abras un issue público. Escribe a [email protected], 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.