# Ogni evento di sicurezza sul tuo telefono.

> Ricevi una notifica push per accessi SSH, uso di sudo e ban di fail2ban. Un singolo curl da uno script di login invia utente, IP di origine e regola al tuo telefono in meno di un secondo.

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

Ultimo aggiornamento: 2026-08-11

Quando qualcosa tocca il tuo server — un login SSH, un ban di fail2ban, una regola di CrowdSec o auditd — utente, IP di origine e regola arrivano sul tuo telefono in meno di un secondo. Sappi chi ha effettuato l'accesso prima che finisca di digitare.

## Tre passaggi per gli avvisi di login

1. **Ottieni una chiave API** — Crea una chiave API e un'applicazione per ogni host, poi conserva la chiave in una variabile d'ambiente sulla macchina.
2. **Collega l'evento** — Aggiungi un curl allo script di login, all'azione di fail2ban o alla regola IDS che invia utente e IP di origine.
3. **Tieni d'occhio i tuoi server** — Login e ban arrivano sul tuo telefono entro un secondo. Metti l'evento nel titolo così un login root da un nuovo IP si distingue chiaramente da un deploy di routine.

## Dal login alla notifica push

Collega qualsiasi evento di login, ban o regola a un singolo curl e l'evento arriva al tuo telefono come notifica push.

- **Notifica push per login SSH** — Uno script di login in /etc/profile.d o uno sshrc esegue curl verso Pocket Alert con utente e IP di origine a ogni sessione interattiva.
- **Ban di fail2ban** — fail2ban esegue un curl nella sua actionban, così ogni IP bannato compare sul tuo telefono con la jail che lo ha intercettato.
- **Accessi sudo e amministratore** — Un hook PAM o un trigger di sudo si attiva quando qualcuno ottiene privilegi elevati, e un nuovo login da amministratore arriva allo stesso modo.
- **Trigger IDS e di audit** — CrowdSec, Wazuh, OSSEC e auditd eseguono curl alla corrispondenza di una regola.
- **Mappatura dei campi** — La mappatura dei campi GJSON estrae utente, IP di origine e regola da un payload SIEM nel titolo e nel messaggio.
- **Consegna in meno di un secondo** — Le notifiche arrivano in meno di un secondo, abbastanza veloci da intercettare una sessione mentre è ancora aperta.

## Avviso per ogni login

### 1. Ottieni una chiave API

Crea un'applicazione in Pocket Alert e copia la tua chiave API. Inviala nell'header `Token`. Assegna a ogni host la propria applicazione, così le macchine prod, bastion e personali restano su canali separati.

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

Inserisci uno script in `/etc/profile.d` così ogni login interattivo esegue curl verso l'API dei messaggi con utente e IP di origine da `$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. Ban fail2ban (azione personalizzata)

Aggiungi un'azione in `/etc/fail2ban/action.d/pocketalert.conf` e richiamala da una jail. fail2ban sostituisce `<ip>` e `<name>` a ogni ban:

```
[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)

Per un SIEM o un IDS che emette JSON (Wazuh, CrowdSec), crea un webhook con un template `message` GJSON che mappa il payload, poi indica allo strumento l'URL di ricezione:

```
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"}'
```

Ottieni `https://p4a.me/wh/1234abcd` da incollare nelle impostazioni di integrazione dello strumento.

Consulta la [documentazione delle impostazioni webhook](https://info.pocketalert.app/api/webhooks/settings.html) per l'API dei messaggi e la mappatura dei campi GJSON.

## FAQ

### Come ricevo un avviso per ogni login SSH?

Inserisci un piccolo script in /etc/profile.d che esegue curl verso Pocket Alert con $USER e l'IP da $SSH_CONNECTION. Ogni login interattivo invierà poi una notifica push al tuo telefono.

### fail2ban può inviarmi una notifica push?

fail2ban esegue un curl nella sua actionban. Inserisci l'IP bannato e la jail nel corpo del messaggio e vedrai ogni ban nel momento in cui accade.

### Come distinguo i login urgenti da quelli di routine?

Metti l'evento nel titolo così si legge a colpo d'occhio: un login root da un nuovo IP e un login ordinario dell'utente deploy arrivano come avvisi chiaramente diversi. Assegna alle macchine sensibili un'applicazione dedicata per tenerle separate.

### Funziona con CrowdSec, Wazuh o auditd?

Sì. CrowdSec, Wazuh, OSSEC e auditd possono tutti eseguire curl quando si attiva una regola. La mappatura dei campi GJSON estrae utente, IP di origine e regola nel titolo e nel messaggio.

### Come separo gli avvisi per server?

Assegna a ogni host la propria applicazione: prod, bastion, personale. I canali per applicazione tengono separati gli avvisi, così sai quale macchina ha generato l'allarme. Pocket Alert inoltra l'evento; non è un IDS.

### Un login root può superare la modalità silenziosa alle 3 di notte?

Sì. Aggiungi "level":"critical" al curl e su Android il messaggio arriva su un canale di notifica dedicato che ignora Non disturbare: concedi l'accesso a Non disturbare una sola volta. Su iPhone, le notifiche high e critical arrivano come notifiche time-sensitive che superano le modalità Full immersion. Per i login ordinari dell'utente deploy usa invece il livello silent: nessun suono o vibrazione, ma restano nella cronologia quando ti serve il registro di audit. Con il piano gratuito, critical viene consegnato come high: resta istantaneo, ma senza il superamento di Non disturbare.
