Quick Connect — Anmeldung per Handy für Emby

Quick Connect lässt deine Benutzer sich am TV oder an jedem anderen Bildschirm anmelden, ohne mit einer Fernbedienung ihr Passwort einzutippen. Der Bildschirm zeigt einen 6-stelligen Code und einen QR-Code; der Benutzer scannt ihn mit dem Handy, stimmt zu, und der Bildschirm meldet sich in Emby Web an. Emby hat keine eigene Code-Anmeldung; dieses Plugin fügt sie hinzu.

Was es macht

• Mit dem Handy anmelden: Im TV-Browser, am Computer oder auf MediaLab TV zeigt der Bildschirm einen 6-stelligen Code und einen QR-Code. Auf dem Handy stimmt der Benutzer mit einem Fingertipp zu, wenn dort bereits Emby angemeldet ist, oder mit Benutzername + Passwort (dieser zweite Weg lässt sich abschalten). Der Bildschirm öffnet dann von selbst Emby Web.
• Button „Sign in with your phone“ auf dem Emby-Web-Anmeldebildschirm. Das Plugin fügt ihn zur Webseite von Emby hinzu und setzt ihn nach Emby-Updates automatisch wieder ein.
• Einmal-Code für die offiziellen Emby-Apps (TVs, Konsolen, Smartphones): Ein Benutzer, der ihn aktiviert hat, lässt sich auf dem Handy einen 6-stelligen Code geben und tippt ihn in das Passwortfeld der Emby-App. Der Code ist 5 Minuten gültig und funktioniert einmal. Er ist pro Benutzer opt-in, und das normale Passwort funktioniert weiter. Wenn das Plugin entfernt wird oder seine Lizenz endet, prüft Emby wieder selbst das normale Passwort.
• Neues Konto vom Handy aus: Mit installiertem Registration verlinkt die Handyseite auf die Registrierungsseite.
• Admin-Panel im Emby-Dashboard: Einstellungen, der Button auf dem Anmeldebildschirm, die Benutzer mit App-Codes und die letzten Anmeldungen. Auf Englisch und Rumänisch.

Sicherheit

• Bildschirmcodes sind zufällig, standardmäßig 5 Minuten gültig (1 bis 15, nach Wahl) und werden einmal benutzt; nur der Bildschirm, der den Code angefragt hat, erhält die Sitzung. Eine Adresse kann höchstens 5 wartende Codes gleichzeitig haben.
• 10 falsche Versuche (falsche Codes oder falsche Passwörter) von einer Adresse innerhalb von 10 Minuten sperren sie für 10 Minuten. Ein Einmal-App-Code wird nach 5 falschen Versuchen ungültig.
• Deaktivierte Konten werden abgelehnt, ebenso Konten ohne Remote-Zugriff, wenn der Bildschirm außerhalb deines lokalen Netzwerks ist. Optional können Administratorkonten sich gar nicht per Code anmelden.
• Einmal-App-Codes werden nur als Hash im Speicher aufbewahrt: Ein Neustart von Emby ungültigt jeden noch wartenden Code.
• Jede Code-Anmeldung wird mit Benutzer, Gerät, App und wer zugestimmt hat protokolliert.

Voraussetzungen

• Emby Server 4.10.1 oder neuer (Linux, Windows oder Docker).
• Für den Button auf dem Anmeldebildschirm: Schreibzugriff auf Embys Webseite (dashboard-ui/index.html). Wenn Emby ohne ihn läuft, zeigt das Plugin den einen Befehl, den du auf dem Server ausführen musst. Die Handy- und Bildschirmseiten funktionieren auch ohne den Button.

Häufige Fragen

Können sich meine Benutzer am TV anmelden, ohne ihr Passwort einzutippen? Ja. In Emby Web (TV-Browser, Computer, MediaLab TV) bestätigen sie den Code auf dem Bildschirm von ihrem Handy aus; in den offiziellen Emby-Apps tippen sie statt des Passworts einen Einmal-Code vom Handy ein. Siehe die Anleitung.

Ersetzt der Einmal-Code das Passwort? Nein. Er ist ein zusätzlicher Weg hinein, pro Benutzer aktiviert. Das normale Passwort funktioniert weiter, und ohne das Plugin prüft Emby wieder nur das normale Passwort.

Was es wohin sendet

• Kein externer Dienst außer dem Lizenzierungs-Client. QR-Codes werden auf dem Server erzeugt; die Bildschirm- und Handyseiten laden nur die Dateien des Plugins.
• Nach der Anmeldung wird der TV/Browser an die vom Administrator gesetzte Adresse geschickt (Standard: die Web-Oberfläche des Servers). Das Sitzungs-Token wird vor der Weiterleitung in den Browser-Speicher geschrieben, nie in die URL. Lokale/externe Adressen sind nur per HTTPS.
• Der Button auf dem Anmeldebildschirm wird in dashboard-ui/index.html geschrieben (standardmäßig an; direktes Schreiben, dann sudo -n, sonst wird der Befehl angezeigt). Wenn er nach einem Emby-Update nicht wiederhergestellt werden kann, wird das Protokoll nur bei aktiviertem automatischem Protokollversand gesendet (einmal pro Emby-Version).
• Plus dem Lizenzierungs-Client, wie in jedem Plugin: Siehe Lizenzierung und Datenschutz in unseren Plugins.

Lokal gespeichert:

• Wartende Codes und Einmal-Codes (6 Ziffern, 5 Min., einmalig) — nur im Speicher.
• state/connections.json: die letzten 500 Anmeldungen (Zeit, Benutzer, Gerät, App, IP, Methode).
• Die Liste der Benutzer, die Einmal-Codes aktiviert haben (Plugin-Konfiguration).

Nie gesendet: Passwörter, Tokens — nichts geht an Dritte.

Kompatibilität mit Clients

• Bildschirm + Handy (QR, Zustimmung vom Handy): Browser — Emby Web am TV, am Desktop, MediaLab TV. ✅ emuliert (Chrome mit einem Philips-NETTV-User-Agent; 40/40); ❔ auf physischen TVs nicht getestet.
• Button auf dem Anmeldebildschirm: Nur Emby Web.
• Offizielle Emby-Apps (Android, iOS, Android TV, Samsung, LG, Roku, Apple TV): Der Einmal-Code wird statt des Passworts eingetippt. Option pro Benutzer (standardmäßig aus): wechselt den Authentifizierungsanbieter des Benutzers zum Plugin; das normale Passwort funktioniert weiter; ohne Plugin/Lizenz fällt Emby auf den Standardanbieter zurück. ✅ per API simuliert (Client „Emby for Android TV“); ❔ in den echten Apps nicht getestet.
• Automatische Anmeldung nach neuem Konto + Zahlung: mit Registration (1.10.5+) und Cashier; standardmäßig aus.

Legende: ✅ verifiziert (Ende-zu-Ende- oder Gerätetest) · 🟢 serverseitig, funktioniert mit jedem Client (by design, kein client-spezifischer Test) · ➖ nicht anwendbar · ❔ nicht getestet.

Lizenzierung

Eine Lizenz pro Emby-Server. Monatlich, jährlich oder als Lifetime-Lizenz, oder enthalten im Emby-Paket. 30 Tage kostenlos testen. Das Plugin wird unter unserer EULA lizenziert.

Unser eigener Code, geschrieben von MediaLab Works. Fremdcode: Der QR-Code-Generator basiert auf der QR-Code-Generator-Bibliothek von Project Nayuki (MIT-Lizenz).