Operação
Segurança
Resumo público do modelo de ameaças do Messajo, como cada dado sensível é guardado e como reportar uma vulnerabilidade.
Esta página resume a revisão de segurança do 1.0.0: as fronteiras do sistema, os controles de cada uma e como os dados sensíveis são guardados. A revisão segue o OWASP API Security Top 10 (2023) e uma análise STRIDE por fronteira.
Fronteiras e controles
Seção intitulada “Fronteiras e controles”| Fronteira | Controles |
|---|---|
| Meta → webhooks de entrada | assinatura X-Hub-Signature-256 conferida em tempo constante sobre o corpo cru; corpo até 5 MiB; deduplicação do corpo bruto; canal sem credencial responde 503 |
| Meta → endpoint de Flows → seu handler | assinatura da Meta, limite de falhas por IP e de trocas por Flow, decifragem com a chave da conta; o handler recebe o pedido assinado com Messajo-Signature, só em https público |
Sua aplicação → /v1 e WebSocket |
chave de API com permissões e escopo de conexões; limite por chave e por organização; corpo com teto por rota; campo desconhecido recusado; toda leitura filtra pela organização da chave |
| Navegador → painel e páginas públicas | sessão com cookie HttpOnly, 2FA obrigatório para dono e admin, conferência de Origin nas escritas, CSP e cabeçalhos de segurança; páginas públicas (links de conexão, convites, exclusão de dados) com limite por IP |
| Messajo → seus destinos | assinatura HMAC-SHA256 em todo envio; anti-SSRF que resolve o DNS, recusa IP privado e conecta no IP conferido |
| Messajo → Graph da Meta | origem fixa; tokens cifrados no banco; resposta validada antes de usar |
| Operador | super-admin, filas e /metrics atrás de autenticação própria; logs com redação automática de segredos |
| Cadeia de fornecimento | versões fixas, bun audit e varredura de segredos na CI; imagem roda sem root |
Toda rota do servidor tem uma política declarada (autenticação, limite e corpo máximo); um teste falha a CI se aparecer rota sem política.
Dados sensíveis
Seção intitulada “Dados sensíveis”| Dado | Como fica |
|---|---|
| Tokens da Meta, PIN do número, chave privada de Flow | cifrados (AES-256-GCM) no banco; a API mostra no máximo os 4 últimos caracteres |
| Segredos de destino e do handler de Flow | cifrados; aparecem só na resposta que os gera |
| Chaves de API, tokens de link de conexão | só o hash |
| Credencial SIP | não fica: repassada à Meta e mostrada uma vez |
| Código OTP | não gravado; mensagem, eventos e logs levam o código mascarado (Templates de autenticação) |
| SDP das ligações (IP do contato) | apagado 1 h depois do fim da ligação; a API mostra só has_sdp |
| Dados digitados num Flow com endpoint | não gravados; o Messajo guarda só os metadados da troca, por 7 dias |
| Mensagens, contatos e mídia | retenção da organização (padrão 90 dias), exportação e apagamento em Dados e privacidade |
Reportar uma vulnerabilidade
Seção intitulada “Reportar uma vulnerabilidade”Não abra issue pública. Escreva para [email protected], com a descrição, a versão, o passo a passo para reproduzir e como quer ser creditado.
| Etapa | Prazo |
|---|---|
| Confirmação do recebimento | até 72 horas úteis |
| Avaliação inicial | até 7 dias |
| Divulgação pública | até 90 dias depois do reporte, ou antes se a correção já saiu |
A política completa está no SECURITY.md do repositório.