Si vous gérez un serveur Emby pour votre famille et vos amis, vous connaissez la routine : quelqu’un demande l’accès, vous ouvrez le tableau de bord, inventez un nom d’utilisateur, définissez un mot de passe, choisissez les bibliothèques, vérifiez les paramètres parentaux, puis vous recommencez la semaine suivante. Cela ne passe pas à l’échelle, et chaque compte créé à la main est une occasion d’oublier une politique ou d’accorder trop de droits.
Registration est un plugin Emby qui ajoute une page d’inscription publique sur votre propre adresse Emby. Les personnes créent leur compte avec un code d’accès que vous leur donnez, et vous gardez le contrôle grâce à l’approbation, aux codes famille, à la protection anti-robots et à un utilisateur modèle qui définit ce qu’un nouveau compte peut voir. Ce tutoriel décrit une configuration pratique : codes, approbation, modèles et bases de l’anti-bots.
Une précision avant de commencer : tout cela concerne des médias légaux, auto-hébergés, que vous possédez ou que vous êtes autorisé à utiliser. Invitez des personnes de confiance et gardez les règles du serveur claires.
Prérequis
- Emby Server 4.10.1 ou version ultérieure.
- Votre serveur Emby doit être joignable par les personnes qui s’inscriront, directement ou via un proxy inverse.
- Un compte MediaLab Works avec une licence pour ce serveur (mensuelle, annuelle, à vie, ou incluse dans le pack Emby). Un essai gratuit de 30 jours est disponible si vous voulez tester d’abord. Une licence par serveur Emby.
- L’accès au tableau de bord Emby. La page d’administration du plugin s’ouvre depuis un navigateur, car l’application Emby bloque les pages de plugin.
Étape 1 — Installer le plugin et activer la licence
- Connectez-vous à votre compte MediaLab Works, ouvrez Licenses et téléchargez la DLL du plugin. Le téléchargement est disponible avec un abonnement actif, une licence à vie dans sa fenêtre de mises à jour, ou pendant l’essai.
- Copiez la DLL dans le dossier des plugins Emby et redémarrez Emby Server :
- Linux (paquet) :
/var/lib/emby/plugins/ - Docker : le dossier
pluginsdans votre volume de configuration Emby - Windows :
%AppData%\Emby-Server\programdata\plugins\
- Linux (paquet) :
- Ouvrez Emby Dashboard → Plugins, cliquez sur le plugin, collez votre clé de licence et enregistrez. 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 pendant 7 jours après la dernière vérification réussie. Sans licence valide, le plugin est arrêté : les tâches automatiques ne s’exécutent pas et la page d’inscription publique affiche « unavailable », mais les comptes, codes et réglages existants restent intacts.
Étape 2 — Configurer les bases
Ouvrez Dashboard → Plugins → Registration. La page de configuration contient une courte liste de réglages :
| Réglage | Ce qu’il fait |
|---|---|
| Utilisateur modèle | Les nouveaux comptes copient les bibliothèques et les politiques de cet utilisateur. |
| Approbation requise | Les comptes sont désactivés jusqu’à ce que vous les approuviez dans la page du plugin. |
| Codes d’accès | Créez des codes : utilisations restantes, expiration, code famille (facultatif). |
| Anti-bots | Activé par défaut ; limite aussi les tentatives par IP. |
| URL publique | L’adresse où le formulaire est servi, par ex. https://emby.example.com/registration. |
Définissez d’abord l’URL publique. C’est l’adresse que les gens ouvriront, elle doit donc correspondre à ce que votre proxy inverse sert réellement. Si vous êtes derrière un proxy, assurez-vous que le chemin d’inscription y est autorisé — un formulaire inaccessible vient presque toujours d’une règle de proxy, pas du plugin.
Étape 3 — Créer un utilisateur modèle
C’est l’étape qui vous fera gagner le plus de temps par la suite. Un utilisateur modèle est un compte Emby normal dont les bibliothèques, les paramètres parentaux et les politiques sont copiés vers chaque nouveau compte créé via la page d’inscription.
Créez dans Emby un compte qui représente « un nouvel utilisateur sur ce serveur » : les bibliothèques qu’il doit voir, les paramètres parentaux que vous voulez par défaut, et rien de plus. Sélectionnez-le ensuite comme utilisateur modèle dans les réglages du plugin.
Comme la copie a lieu à la création du compte, modifier le modèle plus tard ne réécrit pas les comptes existants — cela n’affecte que les nouveaux. Gardez-le en tête si l’organisation de vos bibliothèques change.
Étape 4 — Choisir entre mode d’approbation et comptes immédiats
Approbation requise maintient chaque nouveau compte désactivé jusqu’à ce que vous l’approuviez dans la page du plugin. La personne peut remplir le formulaire, mais personne n’entre tant que vous n’avez pas dit oui. Pour un serveur ouvert à un cercle plus large, c’est le choix par défaut le plus sûr : vous voyez la demande, vous décidez.
Avec l’approbation désactivée, le compte est créé et utilisable immédiatement. C’est pratique pour un petit groupe de personnes que vous connaissez déjà, mais cela confie au code d’accès la décision de qui entre.
Dans les deux cas, le compte est créé désactivé au moment de la demande et le mot de passe est géré par Emby ; le plugin ne stocke pas les mots de passe.
Étape 5 — Distribuer les codes d’accès
Les codes d’accès sont la porte d’entrée. Dans les réglages du plugin, vous créez des codes avec :
- Utilisations restantes — un code à usage unique pour une personne, ou un code multi-usage pour un groupe.
- Expiration — le code cesse de fonctionner passé ce délai.
- Code famille (facultatif) — regroupe les comptes liés pour que vous puissiez les voir et les gérer ensemble.
Un schéma pratique : un code à usage unique par personne pour les invitations individuelles, et un code famille pour un foyer afin que les comptes restent liés dans votre vue d’ensemble. Si un code est refusé, vérifiez d’abord les utilisations restantes et l’expiration sur la page du plugin — ce sont les deux causes habituelles.
Une fois le code créé, envoyez le lien d’inscription avec le code. La personne choisit un nom d’utilisateur et un mot de passe sur le formulaire public, personnalisé avec le nom de votre serveur.
Étape 6 — Tenir les robots à l’écart
Le défi anti-robots est activé par défaut, et le plugin limite aussi les tentatives par IP. Laissez-le activé. Si vous voulez le défi plus fort, vous pouvez saisir vos propres clés Cloudflare Turnstile ; cette option est désactivée par défaut et n’est active que lorsque vous fournissez des clés. Lorsqu’elle est activée, le navigateur du visiteur charge le widget Turnstile et votre serveur vérifie la réponse en envoyant la clé secrète, le jeton et l’adresse IP du visiteur à challenges.cloudflare.com.
Un détail de confidentialité à connaître : à l’envoi du formulaire, le plugin vérifie le mot de passe auprès de Have I Been Pwned – Pwned Passwords en n’envoyant que les 5 premiers caractères du hachage SHA-1 du mot de passe (k-anonymity, avec remplissage). Le mot de passe et le hachage complet ne quittent jamais votre serveur. Vous pouvez désactiver cette vérification, et si le service est indisponible, l’inscription se poursuit.
Étape 7 — Mettre le lien sous les yeux des gens
La page d’inscription publique fonctionne dans n’importe quel navigateur, sur ordinateur et sur téléphone. Sur l’écran de connexion, le bouton « Create account » est réservé à Emby Web : le plugin ajoute un script à dashboard-ui/index.html, et il est réappliqué après les mises à jour d’Emby. Les applications Emby natives (Android, iOS, Android TV, Samsung, LG, Roku, Apple TV) ne peuvent pas afficher ce bouton, envoyez donc le lien directement à ces personnes.
Pour les téléviseurs, la page détecte les navigateurs de TV et affiche un QR code pour le téléphone. Les QR codes sont générés sur le serveur.
Usage quotidien
- Créez un code d’accès et envoyez le lien d’inscription avec le code.
- La personne choisit un nom d’utilisateur et un mot de passe ; avec l’approbation activée, vous confirmez le compte dans la page du plugin.
- Les codes famille vous permettent de voir et de gérer ensemble les comptes liés.
Conseils et dépannage
- Le formulaire est inaccessible. Vérifiez que le chemin est autorisé par votre proxy inverse et que l’URL publique correspond.
- Un code est refusé. Vérifiez les utilisations restantes et l’expiration sur la page du plugin.
- Le bouton de l’écran de connexion a disparu. Il est réappliqué après les mises à jour d’Emby ; s’il ne peut pas être restauré, le journal n’est envoyé que si l’envoi automatique des journaux est activé.
- E-mail. Rien n’est envoyé tant que vous n’avez pas configuré SMTP. Ensuite, les candidats reçoivent une confirmation et la décision (approuvée ou refusée) ainsi que le message d’accès que vous rédigez, qui peut contenir un mot de passe généré. Les notifications administrateur sont désactivées par défaut. STARTTLS est la valeur par défaut.
- Notifications Telegram : facultatives et désactivées par défaut. Si elles sont activées, les messages administrateur incluent les données de la demande (nom, nom d’utilisateur, e-mail, téléphone, IP, pays Cloudflare).
- Données sur disque. Les demandes sont stockées dans
data/registrations.json(mode 600). Les demandes refusées, expirées ou supprimées sont purgées après 30 jours ; les demandes en attente expirent après 7 jours et le compte désactivé est supprimé. Lorsqu’un utilisateur est supprimé, ses données personnelles dans le plugin sont effacées immédiatement. Les données ne sont pas supprimées à la désinstallation, sauf si vous cochez cette option. - Secrets. Le mot de passe SMTP, le jeton Telegram, le secret Turnstile et la clé HMAC du formulaire sont chiffrés au repos dans
secrets.enc.json(AES-256-GCM) et ne sont jamais envoyés au navigateur.
Conclusion
Une page d’inscription publique avec des codes d’accès transforme une corvée d’administration récurrente en une configuration unique : un utilisateur modèle définit les valeurs par défaut, le mode d’approbation vous garde dans la boucle, et les codes plus le défi anti-robots décident qui peut faire la demande. Si vous voulez aller plus loin, le plugin fonctionne aussi avec le plugin Cashier pour les offres payantes et avec Quick Connect pour la connexion depuis un téléphone.
La référence complète se trouve dans le guide utilisateur, et vous pouvez retrouver le plugin sur la page produit Registration. D’autres ressources d’auto-hébergement sont disponibles dans notre base de connaissances et notre FAQ ; si quelque chose ne correspond pas à votre configuration, contactez-nous.