# Chaque événement de sécurité sur votre téléphone.

> Recevez une notification push à chaque connexion SSH, usage de sudo ou bannissement fail2ban. Un simple curl depuis un script de connexion envoie l’utilisateur, l’IP source et la règle sur votre téléphone en moins d’une seconde.

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

Dernière mise à jour : 2026-08-11

Lorsqu’un événement touche votre serveur (une connexion SSH, un bannissement fail2ban, une règle CrowdSec ou auditd), l’utilisateur, l’IP source et la règle arrivent sur votre téléphone en moins d’une seconde. Sachez qui s’est connecté avant qu’il ait fini de taper.

## Trois étapes pour les alertes de connexion

1. **Obtenir une clé API** — Créez une clé API et une application par hôte, puis conservez la clé dans une variable d’environnement sur le serveur.
2. **Brancher l’événement** — Ajoutez un curl à votre script de connexion, à votre action fail2ban ou à votre règle IDS, qui envoie l’utilisateur et l’IP source.
3. **Surveiller vos serveurs** — Les connexions et les bannissements arrivent sur votre téléphone en moins d’une seconde. Placez l’événement dans le titre pour qu’une connexion root depuis une nouvelle IP se distingue clairement d’un déploiement routinier.

## De la connexion à la notification push

Reliez n’importe quel déclencheur de connexion, de bannissement ou de règle à un seul curl, et l’événement arrive sur votre téléphone sous forme de notification push.

- **Notification push à la connexion SSH** — Un script de connexion dans /etc/profile.d ou sshrc appelle curl vers Pocket Alert avec l’utilisateur et l’IP source à chaque session interactive.
- **Bannissements fail2ban** — fail2ban exécute un curl dans son actionban : chaque IP bannie apparaît sur votre téléphone avec la jail qui l’a détectée.
- **sudo et connexions administrateur** — Un hook PAM ou un déclencheur sudo se lance lorsqu’une élévation de privilèges a lieu, et une nouvelle connexion administrateur arrive de la même façon.
- **Déclencheurs IDS et audit** — CrowdSec, Wazuh, OSSEC et auditd appellent curl lorsqu’une règle correspond.
- **Mappage de champs** — Le mappage de champs GJSON extrait l’utilisateur, l’IP source et la règle d’une charge utile SIEM vers le titre et le message.
- **Livraison en moins d’une seconde** — Les notifications arrivent en nettement moins d’une seconde, assez vite pour repérer une session pendant qu’elle est encore ouverte.

## Alerte à chaque connexion

### 1. Obtenir une clé API

Créez une application dans Pocket Alert et copiez votre clé API. Envoyez-la dans l’en-tête `Token`. Donnez à chaque hôte sa propre application afin que les serveurs de production, bastion et personnels restent sur des canaux séparés.

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

Déposez un script dans `/etc/profile.d` pour que chaque connexion interactive appelle curl vers l’API des messages avec l’utilisateur et l’IP source issus 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. Bannissement fail2ban (action personnalisée)

Ajoutez une action dans `/etc/fail2ban/action.d/pocketalert.conf` et référencez-la depuis une jail. fail2ban remplace `<ip>` et `<name>` à chaque bannissement :

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

Pour un SIEM ou un IDS qui émet du JSON (Wazuh, CrowdSec), créez un webhook avec un modèle de `message` GJSON qui mappe sa charge utile, puis indiquez l’URL de réception à l’outil :

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

Vous obtenez `https://p4a.me/wh/1234abcd` à coller dans les paramètres d’intégration de l’outil.

Consultez la [documentation des paramètres des webhooks](https://info.pocketalert.app/api/webhooks/settings.html) pour l’API des messages et le mappage de champs GJSON.

## FAQ

### Comment recevoir une alerte à chaque connexion SSH ?

Déposez un petit script dans /etc/profile.d qui appelle curl vers Pocket Alert avec $USER et l’IP de $SSH_CONNECTION. Chaque connexion interactive enverra alors une notification push sur votre téléphone.

### fail2ban peut-il m’envoyer une notification push ?

fail2ban exécute un curl dans son actionban. Intégrez l’IP bannie et la jail dans le corps du message, et vous verrez chaque bannissement au moment où il se produit.

### Comment distinguer les connexions urgentes des connexions routinières ?

Placez l’événement dans le titre pour le lire d’un coup d’œil : une connexion root depuis une nouvelle IP et une connexion routinière de l’utilisateur de déploiement apparaissent comme deux alertes clairement différentes. Donnez aux hôtes sensibles leur propre application pour les séparer.

### Cela fonctionne-t-il avec CrowdSec, Wazuh ou auditd ?

Oui. CrowdSec, Wazuh, OSSEC et auditd peuvent tous appeler curl lors d’un déclenchement. Le mappage de champs GJSON extrait l’utilisateur, l’IP source et la règle dans le titre et le message.

### Comment séparer les alertes par serveur ?

Donnez à chaque hôte sa propre application : prod, bastion, personnel. Les canaux propres à chaque application gardent les alertes séparées, et vous savez quel serveur a levé l’alerte. Pocket Alert relaie l’événement ; ce n’est pas un IDS.

### Une connexion root peut-elle passer le mode silencieux à 3 h du matin ?

Oui. Ajoutez "level":"critical" à la requête curl et, sur Android, la notification est envoyée dans un canal de notification dédié qui contourne le mode Ne pas déranger ; vous n’accordez l’accès à ce mode qu’une seule fois. Sur iPhone, les notifications high et critical arrivent comme notifications time-sensitive, qui traversent les modes Concentration. Pour les connexions routinières de l’utilisateur de déploiement, utilisez plutôt le niveau silent : pas de son ni de vibration, mais l’événement reste dans l’historique lorsque vous voulez consulter la piste d’audit. Sur l’offre gratuite, critical est envoyé comme high : toujours instantané, mais sans le contournement du mode Ne pas déranger.
