Alertas
Envie os alertas do InfraFence por e-mail, Slack, Discord, Telegram ou webhook assinado - filtros de gravidade e categoria, agrupamento, limites, o payload do webhook e como verificar a assinatura.
Última atualização:
Os canais de alerta ficam em Configurações › Alertas (proprietários e administradores). O e-mail está incluído em todos os planos; Slack, Discord, Telegram e webhooks fazem parte do Basic e superiores.
Adicionar um canal
Adicionar canal, depois:
- Canal: e-mail, Slack, Discord, Telegram ou webhook;
- Nome: para você, por exemplo "Equipe de operações";
- Gravidade mínima: crítica por padrão;
- Categorias: deixe todas desmarcadas para receber todas as categorias.
| Canal | O que você informa |
|---|---|
| Endereço de e-mail | |
| Slack | URL do webhook do Slack (hooks.slack.com): Slack › Apps › Incoming Webhooks, adicione a um canal, copie a URL. |
| Discord | URL do webhook do Discord: canal › Editar › Integrações › Webhooks › Novo webhook › Copiar URL. |
| Telegram | Chat ID do Telegram e Token do bot: crie um bot com o @BotFather, adicione-o ao chat, cole o chat ID e o token. |
| Webhook | URL do webhook (https) e um Segredo de assinatura opcional. |
Enviar teste verifica o canal. Cada canal mostra quando enviou pela última vez e seu último erro.
Os webhooks devem apontar para um endereço HTTPS público: endereços privados e locais são recusados.
O que é enviado
Novos eventos com gravidade igual ou superior à do canal, nas categorias escolhidas. Eventos operacionais (varreduras, atualizações, autorreparo do firewall) nunca geram alertas. Os pedidos de aprovação do AutoMode também vão para os canais.
Os eventos são agrupados: no máximo uma mensagem a cada 20 segundos por canal e servidor, listando até 15 eventos. Um canal envia no máximo 100 mensagens por dia.
Payload do webhook
Um POST JSON:
{
"source": "infrafence",
"type": "alert",
"org": "Acme",
"server": { "id": 42, "name": "web-01" },
"link": "https://infrafence.com/…",
"title": "…",
"events": [
{
"type": "brute_force",
"severity": "critical",
"source_ip": "203.0.113.7",
"occurred_at": "2026-10-23T08:15:00Z",
"details": {}
}
]
}Toda requisição traz X-InfraFence-Timestamp (segundos Unix). Com um segredo de assinatura, traz também X-InfraFence-Signature: sha256=<hex>, o HMAC-SHA256 de <timestamp>.<body> com o seu segredo. Recalcule-o sobre o corpo bruto, compare em tempo constante e rejeite timestamps antigos para bloquear replays:
printf '%s.%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$SECRET"Resumo semanal
Resumo semanal por e-mail: toda segunda-feira, proprietários e administradores recebem um resumo dos últimos 7 dias, no idioma em que usam o painel.
E-mails que o InfraFence envia
Além dos alertas, o InfraFence envia por e-mail:
- os alertas de segurança e os pedidos de aprovação para os canais de e-mail acima;
- o resumo semanal (às segundas) e o relatório mensal (no dia 1º, planos pagos) para proprietários e admins;
- três avisos de proteção para os proprietários quando o dashboard recusa os agentes: 12 horas antes de desativarem a proteção, quando a desativam e quando o acesso volta (veja Quando o dashboard está inacessível);
- os e-mails do teste gratuito para os proprietários: 7, 3 e 1 dia antes do fim e quando ele termina (veja Planos e cobrança);
- os e-mails da conta: confirmar o cadastro, redefinir a senha, link de acesso, convite e confirmação de um novo endereço de e-mail (para o novo endereço e, como verificação, para o atual).
Eles chegam no idioma em que você usa o dashboard, em versão HTML e texto simples. Os links abrem só o InfraFence (ou, para o suporte, um e-mail para info@infrafence.com); um e-mail de aprovação só abre o pedido, nunca aprova nada.
Quando o servidor de e-mail de um endereço o recusa de vez (caixa inexistente, ou um domínio sem servidor de e-mail), o InfraFence para de escrever para ele por 7 dias e depois tenta de novo. Enquanto isso, o dashboard mostra Não conseguimos entregar e-mails para … aos proprietários da organização (e a esse admin), e um canal de alerta por e-mail com esse endereço mostra recipient_rejected e depois recipient_undeliverable até a semana acabar. Um Enviar teste tenta o endereço mesmo assim. Veja Solução de problemas.