Files
ssh-login-notifier/docs/configuration.md
Patrick Asmus 6c2a6dc12b Initial Commit
2026-04-26 21:05:42 +02:00

97 lines
2.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Konfiguration
Die Konfigurationsdatei befindet sich unter:
```
/opt/ssh-login-notifier/config.conf
```
Nach der Installation kann sie jederzeit bearbeitet werden:
```bash
sudo nano /opt/ssh-login-notifier/config.conf
```
Änderungen werden **sofort** beim nächsten SSH-Login wirksam — kein Neustart nötig.
## Benachrichtigungsmethoden
| Schlüssel | Werte | Beschreibung |
|---|---|---|
| `NOTIFICATION_METHODS` | `email`, `ntfy`, `email,ntfy` | Kommasepariert für mehrere Methoden |
## E-Mail Einstellungen
| Schlüssel | Beschreibung | Beispiel |
|---|---|---|
| `EMAIL_RECIPIENT` | Empfänger-Adresse | `admin@example.com` |
| `EMAIL_FROM` | Absender-Adresse | `noreply@example.com` |
| `EMAIL_SUBJECT_PREFIX` | Betreff-Prefix (Hostname wird angehängt) | `SSH Login` |
> Voraussetzung: Ein funktionierender Mail-Versand auf dem System (siehe [Voraussetzungen](prerequisites.md)).
## ntfy Einstellungen
| Schlüssel | Beschreibung | Beispiel |
|---|---|---|
| `NTFY_SERVER` | Server-URL (ohne `/` am Ende) | `https://ntfy.example.com` |
| `NTFY_TOPIC` | Topic-Name | `ssh-login` |
| `NTFY_PRIORITY` | Priorität (15) | `3` |
| `NTFY_TAGS` | Emoji-Tags, kommasepariert | `warning,computer` |
| `NTFY_AUTH_TOKEN` | Bearer-Token (leer = keine Auth) | `tk_abc123` |
### ntfy Prioritäten
| Wert | Bedeutung |
|---|---|
| `1` | Minimum |
| `2` | Niedrig |
| `3` | Standard |
| `4` | Hoch |
| `5` | Maximum (dringend) |
## Erweiterte Einstellungen
| Schlüssel | Werte | Beschreibung |
|---|---|---|
| `GEO_LOOKUP` | `true` / `false` | IP-Standort über ip-api.com abfragen |
## Beispielkonfigurationen
### Nur ntfy (einfachste Variante)
```conf
NOTIFICATION_METHODS=ntfy
NTFY_SERVER=https://ntfy.example.com
NTFY_TOPIC=ssh-alerts
NTFY_PRIORITY=4
NTFY_TAGS=warning,skull
NTFY_AUTH_TOKEN=tk_dein_token
GEO_LOOKUP=true
```
### Nur E-Mail
```conf
NOTIFICATION_METHODS=email
EMAIL_RECIPIENT=admin@example.com
EMAIL_FROM=server@example.com
EMAIL_SUBJECT_PREFIX=SSH Login
GEO_LOOKUP=true
```
### Beides kombiniert
```conf
NOTIFICATION_METHODS=email,ntfy
EMAIL_RECIPIENT=admin@example.com
EMAIL_FROM=server@example.com
EMAIL_SUBJECT_PREFIX=SSH Login
NTFY_SERVER=https://ntfy.example.com
NTFY_TOPIC=ssh-alerts
NTFY_PRIORITY=3
NTFY_TAGS=warning,computer
NTFY_AUTH_TOKEN=
GEO_LOOKUP=false
```