# Jedes Sicherheitsereignis auf dein Handy.

> Erhalte eine Push-Benachrichtigung bei SSH-Logins, sudo-Nutzung und fail2ban-Sperren. Ein curl aus dem Login-Skript sendet Benutzer, Quell-IP und Regel in unter einer Sekunde auf dein Handy.

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

Zuletzt aktualisiert: 2026-08-11

Wenn etwas an deinen Server geht – ein SSH-Login, ein fail2ban-Bann, eine CrowdSec- oder auditd-Regel – landen Benutzer, Quell-IP und Regel in weniger als einer Sekunde auf deinem Handy. Wisse, wer sich angemeldet hat, bevor er fertig getippt hat.

## Drei Schritte zu Login-Alarmen

1. **API-Schlüssel holen** — Erstelle einen API-Schlüssel und eine Anwendung pro Host, und bewahre den Schlüssel dann in einer Umgebungsvariable auf dem Server auf.
2. **Ereignis anbinden** — Füg deinem Login-Skript, deiner fail2ban-Aktion oder deiner IDS-Regel ein curl hinzu, das Benutzer und Quell-IP sendet.
3. **Server im Blick behalten** — Logins und Banns erreichen dein Handy innerhalb einer Sekunde. Schreib das Ereignis in den Titel, damit sich ein Root-Login von einer neuen IP klar von einem routinemäßigen Deploy unterscheidet.

## Vom Login zur Push-Nachricht

Verbinde jeden Login-, Bann- oder Regel-Auslöser mit einem einzigen curl, dann erreicht das Ereignis dein Handy als Push-Benachrichtigung.

- **Push bei SSH-Login** — Ein Login-Skript in /etc/profile.d oder ein sshrc ruft bei jeder interaktiven Sitzung per curl Pocket Alert mit Benutzer und Quell-IP auf.
- **fail2ban-Banns** — fail2ban führt in seiner actionban ein curl aus, sodass jede gebannte IP mit dem Jail, der sie erwischt hat, auf deinem Handy erscheint.
- **sudo und Admin-Logins** — Ein PAM-Hook oder ein sudo-Auslöser feuert, wenn jemand Rechte erhöht, und ein neuer Admin-Login kommt genauso an.
- **IDS- und Audit-Auslöser** — CrowdSec, Wazuh, OSSEC und auditd rufen bei einem Regeltreffer per curl auf.
- **Feldzuordnung** — Über GJSON-Feldzuordnung übernimmst du Benutzer, Quell-IP und Regel aus einer SIEM-Nutzlast in Titel und Nachricht.
- **Zustellung in unter einer Sekunde** — Pushes kommen in deutlich unter einer Sekunde an, schnell genug, um eine Sitzung abzufangen, solange sie noch offen ist.

## Alarm bei jedem Login

### 1. API-Schlüssel holen

Lege in Pocket Alert eine Anwendung an und kopiere deinen API-Schlüssel. Sende ihn im `Token`-Header. Gib jedem Host eine eigene Anwendung, damit Produktions-, Bastion- und private Server auf getrennten Kanälen bleiben.

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

Leg ein Skript in `/etc/profile.d` ab, damit jeder interaktive Login die Messages-API mit Benutzer und Quell-IP aus `$SSH_CONNECTION` per curl aufruft:

```
# /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. fail2ban-Bann (eigene Aktion)

Lege eine Aktion in `/etc/fail2ban/action.d/pocketalert.conf` an und referenziere sie aus einem Jail. fail2ban ersetzt bei jedem Bann `<ip>` und `<name>`:

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

Für ein SIEM oder IDS, das JSON ausgibt (Wazuh, CrowdSec), erstelle einen Webhook mit einer GJSON-`message`-Vorlage, die dessen Nutzlast zuordnet, und trage dann die Empfangs-URL im Tool ein:

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

Du erhältst `https://p4a.me/wh/1234abcd`, die du in die Integrationseinstellungen des Tools einfügst.

Die [Webhook-Einstellungen in der Dokumentation](https://info.pocketalert.app/api/webhooks/settings.html) erklären die Messages-API und die GJSON-Feldzuordnung.

## FAQ

### Wie bekomme ich bei jedem SSH-Login einen Alarm?

Leg ein kleines Skript in /etc/profile.d ab, das mit $USER und der IP aus $SSH_CONNECTION per curl an Pocket Alert sendet. Jeder interaktive Login löst dann eine Push-Benachrichtigung auf deinem Handy aus.

### Kann fail2ban mir eine Push-Nachricht schicken?

fail2ban führt in seiner actionban ein curl aus. Übernimm die gebannte IP und den Jail in den Nachrichtentext, dann siehst du jeden Bann in dem Moment, in dem er passiert.

### Wie unterscheide ich dringende Logins von routinemäßigen?

Schreib das Ereignis in den Titel, dann liest man es auf einen Blick: Ein Root-Login von einer neuen IP und ein routinemäßiger Login des Deploy-Users kommen als klar unterschiedliche Alarme an. Für sensible Hosts kannst du eine eigene Anwendung anlegen, damit sie getrennt bleiben.

### Funktioniert das mit CrowdSec, Wazuh oder auditd?

Ja. CrowdSec, Wazuh, OSSEC und auditd können bei einem Auslöser alle curl aufrufen. Über GJSON-Feldzuordnung übernimmst du Benutzer, Quell-IP und Regel in Titel und Nachricht.

### Wie trenne ich Alarme pro Server?

Gib jedem Host eine eigene Anwendung: prod, bastion, privat. Kanäle pro Anwendung halten die Alarme getrennt, sodass du weißt, welcher Server Alarm geschlagen hat. Pocket Alert leitet das Ereignis nur weiter; es ist kein IDS.

### Kann ein Root-Login den lautlosen Modus um 3 Uhr nachts durchbrechen?

Ja. Füg "level":"critical" zum curl hinzu, dann landet die Nachricht auf Android in einem eigenen Benachrichtigungskanal, der Nicht stören umgeht – den DND-Zugriff erteilst du einmalig. Auf dem iPhone kommen high und critical als zeitkritische Benachrichtigungen an, die sich über Fokus-Modi hinwegsetzen. Routinemäßige Logins des Deploy-Users setzt du stattdessen auf level silent: kein Ton und keine Vibration, aber weiterhin im Verlauf, wenn du das Audit-Protokoll brauchst. Im kostenlosen Tarif wird critical als high zugestellt – weiterhin sofort, nur ohne die Umgehung von Nicht stören.
