117 lines
2.4 KiB
Markdown
117 lines
2.4 KiB
Markdown
# Webhook-Benachrichtigungen
|
||
|
||
Das Tool kann beim Starten und Stoppen des Services sowie bei Sperren und Entsperrungen Benachrichtigungen an verschiedene Dienste senden.
|
||
|
||
## Aktivierung
|
||
|
||
In der Konfiguration (`adguard-shield.conf`):
|
||
|
||
```bash
|
||
NOTIFY_ENABLED=true
|
||
NOTIFY_TYPE="<typ>"
|
||
NOTIFY_WEBHOOK_URL="<url>"
|
||
```
|
||
|
||
## Ntfy
|
||
|
||
```bash
|
||
NOTIFY_ENABLED=true
|
||
NOTIFY_TYPE="ntfy"
|
||
NTFY_SERVER_URL="https://ntfy.sh"
|
||
NTFY_TOPIC="adguard-shield"
|
||
NTFY_TOKEN=""
|
||
NTFY_PRIORITY="4"
|
||
```
|
||
|
||
> **Hinweis:** Bei Ntfy wird `NOTIFY_WEBHOOK_URL` nicht benötigt – Server-URL und Topic werden separat konfiguriert.
|
||
|
||
**Eigene Ntfy-Instanz:**
|
||
```bash
|
||
NTFY_SERVER_URL="https://ntfy.mein-server.de"
|
||
NTFY_TOPIC="dns-security"
|
||
NTFY_TOKEN="tk_mein_geheimer_token"
|
||
```
|
||
|
||
**Prioritäten:**
|
||
| Wert | Bedeutung |
|
||
|------|-----------|
|
||
| 1 | Minimum |
|
||
| 2 | Niedrig |
|
||
| 3 | Standard |
|
||
| 4 | Hoch |
|
||
| 5 | Maximum |
|
||
|
||
**Token erstellen (Self-hosted):**
|
||
1. Ntfy Web-UI → Benutzer/Tokens
|
||
2. Token kopieren und in `NTFY_TOKEN` eintragen
|
||
3. Bei ntfy.sh: Account erstellen → Access Token generieren
|
||
|
||
## Discord
|
||
|
||
```bash
|
||
NOTIFY_ENABLED=true
|
||
NOTIFY_TYPE="discord"
|
||
NOTIFY_WEBHOOK_URL="https://discord.com/api/webhooks/xxx/yyy"
|
||
```
|
||
|
||
**Webhook erstellen:**
|
||
1. Discord Server → Servereinstellungen → Integrationen → Webhooks
|
||
2. Neuer Webhook → URL kopieren
|
||
|
||
## Gotify
|
||
|
||
```bash
|
||
NOTIFY_ENABLED=true
|
||
NOTIFY_TYPE="gotify"
|
||
NOTIFY_WEBHOOK_URL="https://gotify.example.com/message?token=xxx"
|
||
```
|
||
|
||
**Token erstellen:**
|
||
1. Gotify Web-UI → Apps → App erstellen
|
||
2. Token kopieren und in die URL einfügen
|
||
|
||
## Slack
|
||
|
||
```bash
|
||
NOTIFY_ENABLED=true
|
||
NOTIFY_TYPE="slack"
|
||
NOTIFY_WEBHOOK_URL="https://hooks.slack.com/services/xxx/yyy/zzz"
|
||
```
|
||
|
||
**Webhook erstellen:**
|
||
1. Slack App → Incoming Webhooks aktivieren
|
||
2. Webhook-URL kopieren
|
||
|
||
## Generic (eigener Endpoint)
|
||
|
||
```bash
|
||
NOTIFY_ENABLED=true
|
||
NOTIFY_TYPE="generic"
|
||
NOTIFY_WEBHOOK_URL="https://your-server.com/webhook"
|
||
```
|
||
|
||
Sendet einen POST mit JSON-Body:
|
||
|
||
```json
|
||
{
|
||
"message": "🚫 AdGuard Shield: Client 192.168.1.50 gesperrt ...",
|
||
"action": "ban",
|
||
"client": "192.168.1.50",
|
||
"domain": "microsoft.com"
|
||
}
|
||
```
|
||
|
||
## Beispiel-Nachrichten
|
||
|
||
**Service gestartet:**
|
||
> 🟢 AdGuard Shield v0.4.0 wurde gestartet.
|
||
|
||
**Service gestoppt:**
|
||
> 🔴 AdGuard Shield v0.4.0 wurde gestoppt.
|
||
|
||
**Sperre:**
|
||
> 🚫 AdGuard Shield: Client **192.168.1.50** gesperrt (45x microsoft.com in 60s). Sperre für 3600s.
|
||
|
||
**Entsperrung:**
|
||
> ✅ AdGuard Shield: Client **192.168.1.50** wurde entsperrt.
|