Módulo 5: Alertas de Segurança, Aviso de Login SSH e Sinal de Vida com n8n | Curso de Segurança para Sites

Módulo 5 · Curso de Segurança para Sites e Servidores

Alertas e monitoramento

Proteção sem aviso é uma aposta. Este módulo monta um sistema de alertas que avisa no celular cada login no servidor e cada alteração suspeita no site, mantém as credenciais dos canais fora da máquina monitorada e trata o silêncio como sintoma. Tudo com ferramentas comuns: PAM, curl e um workflow no n8n.

PAM webhook n8n WhatsApp e e-mail

Aula 17

Aviso de cada login SSH com PAM

O módulo 4 deixou a porta do servidor forte. Este módulo garante que você saiba quem passou por ela. O ponto de entrada é o PAM, a camada de autenticação que o SSH consulta em todo login. O módulo pam_exec chama um programa em cada etapa; na etapa open_session, a sessão está sendo aberta e o usuário ainda não recebeu o terminal.

# /etc/pam.d/sshd (acrescentar no fim)
session optional pam_exec.so quiet /usr/local/sbin/aviso-login-ssh

A palavra optional é a decisão de projeto mais importante da aula: se o script falhar, o login continua. Um sistema de alerta nunca pode virar um ponto de falha do acesso. O script em si é curto:

#!/bin/sh
# /usr/local/sbin/aviso-login-ssh (dono root, modo 700)
[ "$PAM_TYPE" = "open_session" ] || exit 0
. /etc/aviso-login-ssh.conf          # define URL e TOKEN (modo 600, fora do script)

# Com "ExposeAuthInfo yes" no sshd, a chave usada chega em SSH_AUTH_INFO_0.
chave="$(printf '%s' "${SSH_AUTH_INFO_0:-}" | awk '{print $2, $3}')"
digital="$(printf '%s\n' "$chave" | ssh-keygen -lf - 2>/dev/null | awk '{print $2}')"
# Traduz a impressão digital para o comentário da chave em authorized_keys (ex.: "notebook-pessoal").

( curl -fsS -m 5 -X POST "$URL" -H "X-Token: $TOKEN" -H 'Content-Type: application/json' \
    -d "{\"servidor\":\"$(hostname)\",\"usuario\":\"$PAM_USER\",\"origem\":\"$PAM_RHOST\",\"chave\":\"$digital\"}" \
    >/dev/null 2>&1 & )
exit 0

Três detalhes merecem atenção. A URL do webhook e o token ficam num arquivo de configuração legível só pelo root, e não no script, para o script poder ser publicado e copiado entre servidores. O envio vai em segundo plano com tempo limite de 5 segundos, então nem um serviço de alerta lento atrasa o login. E a impressão digital da chave transforma "root entrou" em "root entrou com a chave do notebook pessoal", o que permite perceber na hora quando a chave usada não é a esperada.

Quem já é root consegue apagar o script, mas só depois de entrar, e a entrada já foi avisada. É uma propriedade valiosa: o aviso registra o primeiro passo de qualquer invasão pelo SSH, inclusive a de quem roubou uma chave legítima.

Fontes desta aula: pam_exec(8) · sshd_config(5): ExposeAuthInfo

Aula 18

O workflow no n8n: WhatsApp, e-mail e o silêncio

Os servidores só sabem fazer uma coisa: mandar um JSON para um endereço. Todo o resto, decidir o canal, formatar a mensagem e perceber o silêncio, fica num orquestrador de fora. No curso usamos o n8n, uma plataforma de automação que pode ser hospedada por você, mas a lógica vale para qualquer ferramenta equivalente.

O caminho de um alerta

Servidores monitorados sshd + PAM a cada login Verificador "ok" ou "alerta" por hora sem credenciais de canal aqui n8n Webhook endereço + token Roteador por gravidade Agendador (a cada 15 min) último "ok" há mais de 75 min? então o silêncio vira alerta WhatsApp urgente E-mail tudo, com detalhe
Ilustração do curso. As credenciais de WhatsApp e e-mail existem só no n8n.

O workflow tem cinco peças:

  1. Webhook com caminho longo e aleatório e autenticação por cabeçalho (o X-Token do script). Requisição sem token é descartada.
  2. Roteador que lê o tipo de evento e a gravidade: login humano, login da automação, alerta de integridade, sinal de vida.
  3. Memória do último sinal de vida: cada "ok" grava o horário (nos dados estáticos do workflow ou numa planilha simples).
  4. Agendador que roda a cada 15 minutos e compara o horário do último "ok" com o atual. Passou de 75 minutos, dispara o alerta de silêncio; quando o "ok" volta, manda "voltou ao normal".
  5. Canais: WhatsApp por uma API de envio (no curso, o nó do Evolution API) e e-mail por SMTP ou Gmail.

Manter as credenciais dos canais no n8n, e não nos servidores, é uma aplicação direta do menor privilégio: se um servidor for invadido, o invasor encontra só o endereço do webhook e um token que serve para mandar alertas, não para ler mensagens nem usar a conta de WhatsApp.

Como o silêncio vira alarme

Exemplo de um dia: sinais de vida recebidos por hora (1 = recebido) e o momento em que o agendador dispara o alerta.

Exemplo ilustrativo do curso: o verificador para às 14h; como nenhum "ok" chega até 15h15, o agendador avisa.

Fontes desta aula: n8n: Webhook node · Healthchecks.io

Aula 19

Desenho de alertas: gravidade, ruído e testes

Um sistema de alertas falha de duas formas: avisando de menos ou avisando demais. A segunda é mais traiçoeira, porque o resultado é o mesmo da primeira: depois da décima mensagem irrelevante, ninguém lê a décima primeira. O livro de SRE do Google resume o critério: todo alerta que chega a uma pessoa deve exigir uma ação dela e ser compreensível sem investigação.

EventoFrequência esperadaCanal
Login SSH de pessoaRaroWhatsApp e e-mail
Login SSH da chave de deployA cada publicaçãoSó e-mail (registro)
Alerta de integridadeNunca, idealmenteWhatsApp e e-mail
Silêncio do verificadorNunca, idealmenteWhatsApp e e-mail
Sinal de vida "ok"De hora em horaNenhum (só registra o horário)

Uma boa mensagem responde às quatro perguntas de quem acabou de acordar: o quê, onde, quando e o que fazer. Por exemplo: "Login SSH em servidor-web-01: root, de 198.51.100.24 (Fortaleza, BR), chave notebook-pessoal, 15:42. Se não foi você, troque as chaves e confira o authorized_keys." A cidade vem de uma consulta de geolocalização do IP feita no próprio workflow.

Por fim, teste de ponta a ponta, canal por canal. Dispare um login, um alerta de integridade manual e interrompa o sinal de vida de propósito, sempre com a palavra "TESTE" na mensagem. Na auditoria que inspira o curso, o WhatsApp funcionou na primeira tentativa, e duas credenciais de e-mail estavam com login recusado; sem o teste, o e-mail teria falhado justamente no dia de um incidente. Repita os testes sempre que mudar credenciais ou o workflow.

Fontes desta aula: Google SRE Book: Monitoring · Julian, Practical Monitoring (2017)

Erros comuns

  • Marcar o PAM como required. Se o alerta falhar, ninguém entra. Use optional.
  • Envio síncrono e sem tempo limite. O login fica esperando o webhook responder.
  • Credenciais do canal no servidor. Quem invade o servidor leva a conta de WhatsApp junto.
  • Mesmo canal para tudo. Logins de deploy no WhatsApp ensinam a ignorar o WhatsApp.
  • Nunca testar. Credenciais expiram e canais param; o primeiro teste não pode ser o incidente real.

Aplicação prática

  1. Crie no n8n (ou na ferramenta que usar) um webhook com token e um nó que mande uma mensagem de teste para o seu WhatsApp e e-mail.
  2. Instale o script da aula 17 num servidor, com a linha optional no PAM, e faça um login novo.
  3. Faça o verificador do módulo 3 mandar "ok" e "alerta" para o mesmo workflow e monte o agendador do silêncio.
  4. Escreva a tabela de gravidade da aula 19 para os seus eventos e ajuste os canais.

Siglas usadas neste módulo

PAM:
Pluggable Authentication Modules, sistema modular de autenticação do Linux.
SSH:
Secure Shell, protocolo de acesso remoto seguro a servidores.
IP:
Internet Protocol, endereço numérico de um aparelho na rede.
HTTPS:
Hypertext Transfer Protocol Secure, HTTP com criptografia TLS.
JSON:
JavaScript Object Notation, formato de dados enviado ao webhook.
API:
Application Programming Interface, interface para programas conversarem entre si.
SMTP:
Simple Mail Transfer Protocol, protocolo de envio de e-mail.
SRE:
Site Reliability Engineering, disciplina de confiabilidade de sistemas criada no Google.

Perguntas frequentes

Como o servidor avisa cada login SSH sem atrasar ou impedir o acesso?
Pelo PAM, o sistema de autenticação do Linux. Uma linha com pam_exec no arquivo /etc/pam.d/sshd chama um script no momento em que a sessão abre. O script coleta usuário, IP de origem e qual chave foi usada, e manda os dados para um webhook em segundo plano, com tempo limite curto. A linha é marcada como optional, então, se o script falhar ou o serviço de alerta estiver fora do ar, o login entra normalmente. O aviso nunca tranca ninguém para fora.
Um invasor que entrou como root não consegue desligar o aviso de login?
Consegue desligar para os próximos logins, mas não para o dele. O aviso é disparado no momento em que a sessão abre, antes de a pessoa receber o terminal. Então a entrada em si sempre é avisada. Depois disso, quem tem root pode remover o script, e por isso o aviso de login é combinado com o sinal de vida do verificador de integridade: se os avisos periódicos pararem, o silêncio também vira alarme.
Por que usar o n8n em vez de mandar o alerta direto do servidor para o WhatsApp?
Por três motivos. Primeiro, as credenciais do WhatsApp e do e-mail ficam no n8n, fora do servidor monitorado; se o servidor for invadido, o invasor não leva essas chaves. Segundo, o n8n centraliza a lógica: o mesmo workflow atende vários servidores, decide o canal por gravidade e guarda o horário do último sinal de vida. Terceiro, trocar de canal ou de destinatário vira uma edição no workflow, sem mexer em cada servidor.
Como evitar que os alertas virem ruído e sejam ignorados?
Separando por gravidade e removendo o que é esperado. Logins da automação de deploy, por exemplo, acontecem a cada publicação e podem ir só por e-mail, enquanto qualquer outro login vai por WhatsApp e e-mail. Alertas de integridade só disparam depois de uma segunda conferência, para não acusar o próprio deploy. E todo alerta precisa dizer o que aconteceu, onde, quando e o que fazer, para que a pessoa decida em segundos.
Como testar se o sistema de alertas realmente funciona?
Disparando eventos de teste de ponta a ponta, identificados como teste: um login SSH novo, um POST manual de alerta de integridade e a interrupção proposital do sinal de vida por mais de uma hora. Cada canal deve ser conferido separadamente, porque é comum um funcionar e outro não; na auditoria que inspira o curso, o WhatsApp funcionou de primeira e a credencial de e-mail estava com login recusado. Repita os testes depois de qualquer mudança de credencial.