Security Notifications für Emby — Anleitung

Installation

Du brauchst Emby Server 4.10.1 oder neuer.

1. Melde dich in deinem MediaLab Works-Konto an, öffne Licenses und lade die Plugin-DLL herunter (verfügbar mit einem aktiven Abonnement, einer Lifetime-Lizenz innerhalb ihres Update-Zeitraums oder während des kostenlosen 30-tägigen Testzeitraums).
2. Kopiere die DLL in den Emby-Plugin-Ordner und starte den Emby-Server neu:
   • Linux (Paket): /var/lib/emby/plugins/
   • Docker: der Ordner plugins in deinem Emby-Konfigurations-Volume
   • Windows: %AppData%\Emby-Server\programdata\plugins\
3. Öffne Security Notifications im Emby-Dashboard-Menü und klicke auf Open License page. Füge deinen Lizenzschlüssel ein und aktiviere ihn, oder gib deine E-Mail-Adresse ein, um den kostenlosen 30-tägigen Test zu starten oder eine Lizenz zu kaufen. Das Plugin kontaktiert den Lizenzserver, bindet den Schlüssel an diesen Emby-Server und zeigt die Lizenz als Active an.

Die Lizenz wird einmal täglich geprüft (und bei jedem Start von Emby). Ohne Internet läuft das Plugin nach der letzten erfolgreichen Prüfung noch 7 Tage; danach wird es gestoppt, bis es wieder prüfen kann.

Lizenz

Ohne gültige Lizenz wird das Plugin gestoppt: Es wird keine Regel geprüft und keine Warnung gesendet, und nur die Seite License funktioniert weiter (dort kannst du den Test starten, kaufen, den Schlüssel eingeben oder aktualisieren). Deine Einstellungen und der Verlauf der Warnungen bleiben erhalten. Nichts wird gelöscht: Sobald die Lizenz wieder gültig ist, läuft alles weiter.

Mit gültiger Lizenz kann dieselbe Seite ein Update installieren oder bei Problemen ein Rollback auf die vorherige Version ausführen. Starte Emby danach neu.

Konfiguration

Öffne Security Notifications im Emby-Dashboard. Die Seite hat fünf Tabs: Overview, History, Rules, Channels und Settings.

1. Channels: Aktiviere die gewünschten Kanäle und lege für jeden die minimale Schwere fest, dann nutze Send a test.
   • Telegram: Gib das Bot-Token ein, sende /start an den Bot (oder füge ihn einer Gruppe hinzu) und klicke dann auf Find, um den Chat auszufüllen.
   • E-Mail: Empfänger und dein SMTP-Server. Port 587 mit STARTTLS wird empfohlen (Port 465 mit implizitem TLS wird nicht unterstützt). Wenn Registration installiert ist, kannst du dessen SMTP-Server wiederverwenden.
   • Webhook: Wähle Discord, Slack, ntfy, Gotify oder JSON und füge die Adresse ein. Die Adresse enthält das Token und wird getrennt von den Einstellungen gespeichert. Für Gotify füge ?token=… an die /message-Adresse an.
   • Emby-Aktivitätsprotokoll: Warnungen erscheinen auch in der Aktivitätsliste des Dashboards.
2. No spam (gleicher Tab): Wie oft dieselbe Warnung wiederholt werden darf, die Ruhezeiten (nur kritische Warnungen gehen sofort raus, der Rest kommt als Zusammenfassung, wenn sie enden) und der optionale tägliche Digest für Warnungen mittlerer und informativer Schwere.
3. Rules: Jede der 20 Regeln hat einen Schalter, eine Schwere und, wo zutreffend, Schwellenwerte (etwa wie viele falsche Passwörter in wie vielen Minuten, die Geschwindigkeit für „unmögliche Reisen“ oder die üblichen Zeiten des Administrators).
4. Settings:
   • Location: DB-IP Lite (kostenlos, kein Konto), MaxMind GeoLite2 (deine Account-ID und dein Lizenzschlüssel) oder deaktiviert. Ohne Ort funktionieren die Regeln für neues Land, unmögliche Reisen und neues Netzwerk nicht.
   • Network: Vertrauenswürdige Netzwerke (CIDR), die als lokal behandelt werden, etwa dein eigenes VPN. Private Netzwerke werden automatisch einbezogen. Aktiviere The server is behind its own proxy, wenn Emby hinter nginx, Caddy, Traefik oder Ähnlichem steht, damit weitergeleitete Header erwartet werden; Cloudflare wird von selbst erkannt.
   • Bad IP lists: Tor-Exits (stündlich aktualisiert) und Spamhaus DROP (täglich).

Tägliche Nutzung

• Overview zeigt die letzten Warnungen und den Status des Plugins.
• History listet jede Warnung mit Konto, Adresse, Ort, Gerät und den Kanälen, an die sie gesendet wurde; filtere nach Schwere, Regel und Zeitraum oder exportiere als CSV.
• Jede Warnung sagt, warum sie verdächtig ist und was du prüfen solltest. Warst du es selbst (ein neues Telefon, eine Reise ins Ausland), musst du nichts unternehmen.

Fehlerbehebung

• Jede Warnung zeigt dieselbe Adresse (dein Proxy oder Cloudflare): Richte deinen Reverse Proxy so ein, dass Emby die echte Adresse des Besuchers erhält, und aktiviere The server is behind its own proxy in Settings.
• Keine Telegram-Nachrichten: Sende /start erneut an den Bot und klicke auf Find; prüfe die minimale Schwere des Kanals.
• Kein Ort: Prüfe die Location-Quelle in Settings; bei MaxMind prüfe Account-ID und Schlüssel.