Connectez-vous sur la TV sans taper de mot de passe : l’écran affiche un code et un code QR et vous approuvez sur votre téléphone. Plus des codes à usage unique pour les applications Emby.

Quick Connect permet à vos utilisateurs de se connecter sur une TV ou tout autre écran sans taper leur mot de passe avec une télécommande. L’écran affiche un code à 6 chiffres et un code QR ; l’utilisateur le scanne avec son téléphone, approuve, et l’écran se connecte à Emby Web. Emby n’a pas de connexion par code propre ; ce plugin l’ajoute.

Ce qu’il fait

Connexion avec votre téléphone : sur un navigateur de TV, un ordinateur ou MediaLab TV, l’écran affiche un code à 6 chiffres et un code QR. Sur le téléphone, l’utilisateur approuve en un geste si Emby y est déjà connecté, ou avec nom d’utilisateur + mot de passe (cette seconde voie peut être désactivée). L’écran entre ensuite tout seul dans Emby Web.
Bouton « Sign in with your phone » sur l’écran de connexion Emby Web. Le plugin l’ajoute à la page web d’Emby et le remet automatiquement après les mises à jour d’Emby.
Code à usage unique pour les applications Emby officielles (TV, consoles, téléphones) : un utilisateur qui l’active demande un code à 6 chiffres sur le téléphone et le tape dans le champ du mot de passe de l’application Emby. Le code est valable 5 minutes et fonctionne une fois. Il est activé par utilisateur (opt-in), et le mot de passe normal continue de fonctionner. Si le plugin est retiré ou que sa licence prend fin, Emby revient à vérifier lui-même le mot de passe normal.
Nouveau compte depuis le téléphone : avec Registration installé, la page téléphone renvoie vers la page d’inscription.
Panneau d’administration dans le tableau de bord Emby : paramètres, bouton de l’écran de connexion, utilisateurs avec codes d’application et connexions récentes. En anglais et en roumain.

Sécurité

Les codes d’écran sont aléatoires, valables 5 minutes par défaut (1 à 15, au choix) et utilisés une fois ; seul l’écran qui a demandé le code reçoit la session. Une adresse peut avoir au plus 5 codes en attente à la fois.
10 tentatives erronées (codes ou mots de passe incorrects) depuis une adresse en 10 minutes la bloquent pendant 10 minutes. Un code à usage unique est annulé après 5 essais erronés.
Les comptes désactivés sont refusés, ainsi que les comptes sans accès distant quand l’écran est hors de votre réseau local. En option, les comptes administrateurs ne peuvent pas se connecter par code du tout.
Les codes à usage unique ne sont stockés que sous forme de haché, en mémoire : redémarrer Emby annule chaque code encore en attente.
Chaque connexion par code est journalisée avec l’utilisateur, l’appareil, l’application et qui a approuvé.

Prérequis

Emby Server 4.10.1 ou plus récent (Linux, Windows ou Docker).
Pour le bouton sur l’écran de connexion : accès en écriture à la page web d’Emby (dashboard-ui/index.html). Quand Emby tourne sans lui, le plugin affiche la seule commande à exécuter sur le serveur. Les pages téléphone et écran fonctionnent sans le bouton.

Questions fréquentes

Mes utilisateurs peuvent-ils se connecter sur une TV sans taper leur mot de passe ? Oui. Dans Emby Web (navigateur de TV, ordinateur, MediaLab TV), ils approuvent le code affiché à l’écran depuis leur téléphone ; dans les applications Emby officielles, ils tapent un code à usage unique provenant du téléphone à la place du mot de passe. Voir le guide.

Le code à usage unique remplace-t-il le mot de passe ? Non. C’est une voie d’accès supplémentaire, activée par utilisateur. Le mot de passe normal continue de fonctionner, et sans le plugin Emby revient à ne vérifier que le mot de passe normal.

Ce qu’il envoie et où

Aucun service externe en dehors du client de licence. Les codes QR sont générés sur le serveur ; les pages écran et téléphone ne chargent que les fichiers du plugin.
Après la connexion, la TV/le navigateur est envoyé vers l’adresse définie par l’administrateur (par défaut : l’interface web du serveur). Le jeton de session est écrit dans le stockage du navigateur avant la redirection, jamais mis dans l’URL. Les adresses locales/externes sont en HTTPS uniquement.
Le bouton de l’écran de connexion est ajouté à dashboard-ui/index.html (activé par défaut ; écriture directe, puis sudo -n, sinon la commande est affichée). S’il ne peut pas être restauré après une mise à jour d’Emby, le journal n’est envoyé qu’avec l’envoi automatique des journaux activé (une fois par version d’Emby).
Plus le client de licence, le même dans chaque plugin : voir Licences et confidentialité dans nos plugins.

Stocké localement :

Codes en attente et codes à usage unique (6 chiffres, 5 min, usage unique) — mémoire uniquement.
state/connections.json : les 500 dernières connexions (heure, utilisateur, appareil, application, IP, méthode).
La liste des utilisateurs qui ont activé les codes à usage unique (configuration du plugin).

Jamais envoyé : mots de passe, jetons — rien ne va vers des tiers.

Compatibilité avec les clients

Écran + téléphone (QR, approbation depuis le téléphone) : navigateurs — Emby Web sur TV, bureau, MediaLab TV. ✅ émulé (Chrome avec un User-Agent Philips NETTV ; 40/40) ; ❔ non testé sur des TV physiques.
Bouton de l’écran de connexion : Emby Web uniquement.
Applications Emby officielles (Android, iOS, Android TV, Samsung, LG, Roku, Apple TV) : le code à usage unique est tapé à la place du mot de passe. Option par utilisateur (désactivée par défaut) : bascule le fournisseur d’authentification de l’utilisateur vers le plugin ; le mot de passe normal fonctionne toujours ; sans le plugin/licence, Emby revient au fournisseur par défaut. ✅ simulé via API (client « Emby for Android TV ») ; ❔ non testé dans les applications réelles.
Connexion automatique après nouveau compte + paiement : avec Registration (1.10.5+) et Cashier ; désactivée par défaut.

Légende : ✅ vérifié (test de bout en bout ou sur appareil réel) · 🟢 côté serveur, fonctionne avec tout client (par conception, sans test spécifique par client) · ➖ sans objet · ❔ non testé.

Licence

Une licence par serveur Emby. Mensuelle, annuelle ou à vie, ou incluse dans l’Emby bundle. Essai gratuit de 30 jours. Le plugin est sous notre CLUF.

Notre propre code, écrit par MediaLab Works. Code tiers : le générateur de codes QR est basé sur la bibliothèque QR Code generator de Project Nayuki (licence MIT).

Quick Connect — connexion par téléphone pour Emby