# Cada evento de segurança no seu celular.

> Receba uma notificação push em logins SSH, uso de sudo e bans do fail2ban. Um curl a partir de um script de login envia o usuário, o IP de origem e a regra para o seu celular em menos de um segundo.

<!-- source: https://pocketalert.app/pt/use-cases/security-alerts -->

Última atualização: 2026-08-11

Quando algo acessa seu servidor — um login SSH, um bloqueio do fail2ban, uma regra do CrowdSec ou do auditd — o usuário, o IP de origem e a regra chegam ao seu celular em menos de um segundo. Saiba quem entrou antes que termine de digitar.

## Três passos para alertas de login

1. **Obtenha uma chave de API** — Crie uma chave de API e um aplicativo por servidor, depois guarde a chave em uma variável de ambiente na máquina.
2. **Conecte o evento** — Adicione um curl ao seu script de login, à ação do fail2ban ou à regra do IDS que envie o usuário e o IP de origem.
3. **Acompanhe suas máquinas** — Logins e bloqueios chegam ao seu celular em um segundo. Coloque o evento no título para que um login de root de um IP novo se destaque de um deploy rotineiro.

## Do login à notificação push

Conecte qualquer gatilho de login, bloqueio ou regra a um único curl, e o evento chega ao seu celular como notificação push.

- **Notificação push de login SSH** — Um script de login em /etc/profile.d ou um sshrc faz curl para o Pocket Alert com o usuário e o IP de origem a cada sessão interativa.
- **Bloqueios do fail2ban** — O fail2ban executa um curl na sua actionban, então cada IP bloqueado aparece no seu celular junto com a jail que o pegou.
- **sudo e logins de administrador** — Um hook PAM ou um gatilho do sudo dispara quando alguém eleva privilégios, e um novo login de administrador chega da mesma forma.
- **Gatilhos de IDS e auditoria** — CrowdSec, Wazuh, OSSEC e auditd executam curl quando uma regra é acionada.
- **Mapeamento de campos** — O mapeamento de campos com GJSON extrai o usuário, o IP de origem e a regra de um payload de SIEM para o título e a mensagem.
- **Entrega em menos de um segundo** — As notificações chegam em bem menos de um segundo, rápido o bastante para pegar uma sessão enquanto ela ainda está aberta.

## Alerta em cada login

### 1. Obtenha uma chave de API

Crie um aplicativo no Pocket Alert e copie sua chave de API. Envie-a no cabeçalho `Token`. Dê a cada servidor o próprio aplicativo, para que as máquinas de prod, bastion e pessoais fiquem em canais separados.

### 2. Login SSH (sshrc ou /etc/profile.d)

Coloque um script em `/etc/profile.d` para que cada login interativo faça curl para a API de mensagens com o usuário e o IP de origem de `$SSH_CONNECTION`:

```
# /etc/profile.d/pocketalert-login.sh
[ -n "$SSH_CONNECTION" ] && curl -s -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"title\":\"SSH login\",\"message\":\"$USER from ${SSH_CONNECTION%% *} on $(hostname)\"}"
```

### 3. Bloqueio do fail2ban (ação personalizada)

Adicione uma ação em `/etc/fail2ban/action.d/pocketalert.conf` e referencie-a em uma jail. O fail2ban substitui `<ip>` e `<name>` em cada bloqueio:

```
[Definition]
actionban = curl -s -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"fail2ban: banned <ip>","level":"critical","message":"jail <name> banned <ip>"}'
```

### 4. SIEM (webhook)

Para um SIEM ou IDS que emite JSON (Wazuh, CrowdSec), crie um webhook com um template de `message` em GJSON que mapeie o payload e, em seguida, aponte a ferramenta para a URL de recebimento:

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Wazuh alerts","message":"%rule.description% from %data.srcip%","application_id":"qm47b9pzxzxg"}'
```

Você recebe `https://p4a.me/wh/1234abcd` para colar nas configurações de integração da ferramenta.

Veja a [documentação das configurações de webhook](https://info.pocketalert.app/api/webhooks/settings.html) para a API de mensagens e o mapeamento de campos GJSON.

## Perguntas frequentes

### Como receber um alerta a cada login SSH?

Coloque um pequeno script em /etc/profile.d que faça curl para o Pocket Alert com $USER e o IP de $SSH_CONNECTION. Assim, cada login interativo envia uma notificação push ao seu celular.

### O fail2ban pode me enviar uma notificação push?

O fail2ban executa um curl na sua actionban. Inclua o IP bloqueado e a jail no corpo da mensagem, e você verá cada bloqueio no momento em que acontece.

### Como diferenciar logins urgentes dos rotineiros?

Coloque o evento no título para que dê para entender de relance: um login de root de um IP novo e um login rotineiro do usuário de deploy aparecem como alertas claramente diferentes. Dê a servidores sensíveis o próprio aplicativo para mantê-los separados.

### Funciona com CrowdSec, Wazuh ou auditd?

Sim. CrowdSec, Wazuh, OSSEC e auditd podem executar curl em um gatilho. O mapeamento de campos com GJSON extrai o usuário, o IP de origem e a regra para o título e a mensagem.

### Como separar os alertas por servidor?

Dê a cada servidor o próprio aplicativo: prod, bastion, pessoal. Canais separados por aplicativo mantêm os alertas isolados, para você saber qual máquina gerou o aviso. O Pocket Alert apenas repassa o evento; ele não é um IDS.

### Um login de root pode furar o modo silencioso às 3h da manhã?

Sim. Adicione "level":"critical" ao curl e, no Android, a notificação vai para um canal dedicado que ignora o Não perturbe — você concede o acesso ao modo Não perturbe uma única vez. No iPhone, as prioridades high e critical chegam como notificações urgentes que furam os modos de Foco. Para logins rotineiros do usuário de deploy, use level silent: sem som ou vibração, mas ainda no histórico quando você quiser o registro de auditoria. No plano gratuito, critical é entregue como high — continua instantâneo, só sem a substituição do Não perturbe.
