Security Notifications pour Emby — guide

Installation

Vous avez besoin d’Emby Server 4.10.1 ou plus récent.

1. Connectez-vous à votre compte MediaLab Works, ouvrez Licences et téléchargez le DLL du plugin (disponible avec un abonnement actif, une licence à vie dans sa période de mises à jour, ou pendant l’essai gratuit de 30 jours).
2. Copiez le DLL dans le dossier des plugins Emby et redémarrez Emby Server :
   • Linux (paquet) : /var/lib/emby/plugins/
   • Docker : le dossier plugins de votre volume de configuration Emby
   • Windows : %AppData%\Emby-Server\programdata\plugins\
3. Ouvrez Security Notifications dans le menu du tableau de bord Emby et cliquez sur Ouvrir la page Licence. Collez votre clé de licence et activez-la, ou saisissez votre e-mail pour démarrer l’essai gratuit de 30 jours ou acheter une licence. Le plugin contacte le serveur de licences, lie la clé à ce serveur Emby et affiche la licence comme Active.

La licence est vérifiée une fois par jour (et à chaque démarrage d’Emby). Sans internet, le plugin continue de fonctionner 7 jours après la dernière vérification réussie ; ensuite, il est arrêté jusqu’à pouvoir vérifier à nouveau.

Licence

Sans licence valide, le plugin est arrêté : aucune règle n’est vérifiée et aucune alerte n’est envoyée, et seule la page Licence continue de fonctionner (vous pouvez y démarrer l’essai, acheter, saisir la clé ou mettre à jour). Vos paramètres et l’historique des alertes sont conservés. Rien n’est supprimé : tout reprend dès que la licence est de nouveau valide.

Avec une licence valide, la même page peut installer une mise à jour ou revenir à la version précédente si une mise à jour pose problème. Redémarrez Emby après l’une ou l’autre.

Configuration

Ouvrez Security Notifications dans le tableau de bord Emby. La page comporte cinq onglets : Aperçu, Historique, Règles, Canaux et Paramètres.

1. Canaux : activez les canaux voulus et définissez la gravité minimale pour chacun, puis utilisez Envoyer un test.
   • Telegram : saisissez le jeton du bot, envoyez /start au bot (ou ajoutez-le à un groupe), puis cliquez sur Rechercher pour remplir le chat.
   • E-mail : les destinataires et votre serveur SMTP. Le port 587 avec STARTTLS est recommandé (le port 465 avec TLS implicite n’est pas pris en charge). Si Registration est installé, vous pouvez réutiliser son serveur SMTP.
   • Webhook : choisissez Discord, Slack, ntfy, Gotify ou JSON et collez l’adresse. L’adresse contient le jeton et est stockée séparément des paramètres. Pour Gotify, ajoutez ?token=… à l’adresse /message.
   • Journal d’activité Emby : les alertes apparaissent aussi dans la liste d’activité du tableau de bord.
2. Pas de spam (même onglet) : la fréquence à laquelle la même alerte peut se répéter, les heures de silence (seules les alertes critiques partent immédiatement, le reste arrive dans un résumé à leur fin) et le résumé quotidien facultatif pour les alertes moyennes et informatives.
3. Règles : chacune des 20 règles a un interrupteur, une gravité et, le cas échéant, des seuils (par exemple combien de mots de passe erronés en combien de minutes, la vitesse pour le voyage impossible ou les horaires habituels de l’administrateur).
4. Paramètres :
   • Localisation : DB-IP Lite (gratuit, sans compte), MaxMind GeoLite2 (votre identifiant de compte et clé de licence) ou désactivé. Sans localisation, les règles de nouveau pays, de voyage impossible et de nouveau réseau ne fonctionnent pas.
   • Réseau : les réseaux de confiance (CIDR) traités comme locaux, comme votre propre VPN. Les réseaux privés sont inclus automatiquement. Activez Le serveur est derrière son propre proxy si Emby est derrière nginx, Caddy, Traefik ou similaire, pour que les en-têtes transférés soient attendus ; Cloudflare est reconnu de lui-même.
   • Listes d’IP malveillantes : les sorties Tor (actualisées toutes les heures) et Spamhaus DROP (quotidien).

Utilisation quotidienne

• Aperçu affiche les alertes récentes et l’état du plugin.
• Historique liste chaque alerte avec le compte, l’adresse, la localisation, l’appareil et les canaux auxquels elle a été envoyée ; filtrez par gravité, règle et période, ou exportez en CSV.
• Chaque alerte indique pourquoi elle est suspecte et quoi vérifier. Si c’était vous (un nouveau téléphone, un voyage à l’étranger), il n’y a rien à faire.

Dépannage

• Chaque alerte affiche la même adresse (votre proxy ou Cloudflare) : configurez votre reverse proxy pour qu’Emby reçoive l’adresse réelle du visiteur, et activez Le serveur est derrière son propre proxy dans Paramètres.
• Aucun message Telegram : envoyez à nouveau /start au bot et cliquez sur Rechercher ; vérifiez la gravité minimale du canal.
• Aucune localisation : vérifiez la source de localisation dans Paramètres ; avec MaxMind, vérifiez l’identifiant de compte et la clé.