Access Log — historique des connexions Emby, IP et localisation

Access Log conserve l’historique des connexions de votre serveur Emby : il enregistre chaque authentification et l’affiche dans un tableau clair : utilisateur, heure, adresse IP, appareil et application, ainsi que la localisation approximative issue de la base GeoLite2.

Ce qu’il fait

• Chaque connexion et chaque échec, avec utilisateur, IP, application cliente, nom et version de l’appareil.
• Localisation (pays, ville) issue d’une base GeoLite2 locale — aucune donnée ne quitte votre serveur.
• Filtres par utilisateur, période, pays et appareil ; export en CSV.
• Réglage de rétention pour conserver le journal aussi longtemps que nécessaire.

Prérequis

• Emby Server 4.10.1 ou plus récent.
• Optionnel : un compte MaxMind gratuit, pour les bases GeoLite2 City et ASN (localisations) ; sans lui, aucune base n’est téléchargée.

Questions fréquentes

Comment savoir qui s’est connecté à mon serveur Emby, et d’où ? Installez Access Log et ajoutez la base GeoLite2 City gratuite. Chaque connexion et chaque échec apparaît alors sur la page du plugin avec utilisateur, IP, appareil, application, pays et ville ; filtrez par utilisateur, période, pays ou appareil, ou exportez en CSV. Voir le guide.

Des données sont-elles envoyées hors de mon serveur pour la localisation ? Non. La localisation provient de la base GeoLite2 stockée sur votre serveur.

Ce qu’il envoie et où

• MaxMind GeoLite2 (download.maxmind.com) — optionnel, désactivé par défaut : seulement si vous saisissez votre propre compte MaxMind gratuit (Account ID + License Key) le plugin télécharge les bases GeoLite2 City et ASN (authentifié avec votre compte ; aucune adresse IP ni donnée d’utilisateur n’est envoyée). Actualisé quand il a plus de 7 jours (configurable).
• La géolocalisation des IP se fait localement, dans la base téléchargée ; les adresses IP ne sont jamais envoyées à un service externe. Les adresses privées/locales ne sont pas recherchées.
• Les alertes (nouvel appareil, nouveau pays, vagues d’échecs de connexion) vont uniquement au journal d’activité local du serveur.
• Aucun script CDN ni police externe dans les pages.
• Plus le client de licence, identique dans chaque plugin : voir Licences et confidentialité dans nos plugins.

Stocké localement (dossier de données du plugin) :

• events/events-YYYY-MM.jsonl : chaque connexion / échec / lecture / changement d’adresse — heure, utilisateur, IP, localisation (pays, région, ville, coordonnées approximatives, ASN/ISP), chemin d’accès (direct ou via Cloudflare, Host, User-Agent, chaîne X-Forwarded-For), application, version, appareil, session. Le mot de passe tenté n’est jamais stocké.
• events/known.json : appareils et pays connus par utilisateur (sans expiration).
• geoip/*.mmdb : les bases MaxMind. L’account id MaxMind se trouve dans la configuration du plugin ; la clé de licence MaxMind est chiffrée au repos dans secrets.enc.json dans le dossier de données du plugin (AES-256-GCM, clé aléatoire issue de secrets.key liée à l’id du serveur, les deux fichiers en mode 600) et n’est jamais envoyée au navigateur (la page affiche seulement « set ✓ ») (à partir de la version 0.1.6 ; les versions antérieures la conservent en clair dans la configuration).
• Rétention : 365 jours par défaut (configurable) ; des fichiers mensuels entiers sont supprimés, donc jusqu’à ~un mois supplémentaire peut rester sur le disque. L’export CSV est lancé par l’administrateur.
• Le plugin lit le journal local embyserver.txt pour les en-têtes de requête.

Compatibilité des clients

La capture se fait côté serveur (les événements de connexion/de session du serveur), donc elle fonctionne avec n’importe quel client ; l’interface se limite à la page d’administration.

• Emby Web : ✅ (pages vérifiées dans Chrome ; capture testée sur le serveur).
• Applications Emby natives (Android, iOS, Android TV, Samsung, LG, Roku, Apple TV), navigateurs de TV : 🟢 la capture ne dépend pas du client ; ❔ non testées individuellement. Le nom d’application/d’appareil affiché est celui que le client déclare.
• La détection « via Cloudflare / direct » dépend des lignes qu’Emby écrit dans embyserver.txt ; Emby accepte X-Forwarded-For de n’importe qui — le plugin signale les en-têtes falsifiés.

Légende : ✅ vérifié (test de bout en bout ou sur l’appareil) · 🟢 côté serveur, fonctionne avec n’importe quel client (par conception, sans test par client) · ➖ sans objet · ❔ non testé.

Licence

Une licence par serveur Emby. Mensuelle, annuelle ou à vie, ou incluse dans le pack Emby. Essai gratuit de 30 jours.