Registration — Benutzerregistrierung und Registrierungsseite für Emby

Registration fügt deinem Emby-Server eine öffentliche Registrierungsseite hinzu: Du lädst Benutzer ein, statt jedes Konto selbst anzulegen. Eingeladene Personen erstellen ihr eigenes Konto mit einem Zugangscode; die Kontrolle behältst du durch Freigabe, Familiencodes und Anti-Bot-Schutz.

Was es macht

• Öffentliches Registrierungsformular auf deiner Emby-Adresse, mit dem Namen deines Servers.
• Zugangscodes (einmalig oder mehrfach nutzbar, mit Ablauf) und Familiencodes, die Konten gruppieren.
• Anti-Bot-Abfrage und Ratenbegrenzung für das Formular.
• Freigabe-Modus: Neue Konten warten auf deine Freigabe, bevor sie sich anmelden können.
• Vorlagen: Neue Benutzer erhalten Bibliotheken, Jugendschutzeinstellungen und Richtlinien von einem Vorlagenbenutzer kopiert.
• Updates werden über dein MediaLab Works-Konto geliefert.

Voraussetzungen

• Emby Server 4.10.1 oder neuer.
• Der Emby-Server muss von den Personen erreichbar sein, die sich registrieren (direkt oder über einen Reverse Proxy).

Häufige Fragen

Wie lasse ich Benutzer auf meinem Emby-Server registrieren? Installiere Registration, erstelle in Dashboard → Plugins → Registration einen Zugangscode und sende den Registrierungslink mit dem Code. Die Person wählt Benutzernamen und Passwort; bei aktivierter Freigabe bestätigst du das Konto zuerst. Siehe die Anleitung.

Worauf haben neue Benutzer Zugriff? Neue Konten übernehmen Bibliotheken, Jugendschutzeinstellungen und Richtlinien von einem Vorlagenbenutzer deiner Wahl.

Was es wohin sendet

• Have I Been Pwned – Pwned Passwords (api.pwnedpasswords.com), standardmäßig aktiv: Beim Absenden des Formulars werden nur die ersten 5 Zeichen des SHA-1-Hashs des Passworts gesendet (k-Anonymität, mit Padding); Passwort und vollständiger Hash verlassen den Server nie. Kann deaktiviert werden. Ist der Dienst nicht erreichbar, läuft die Registrierung trotzdem.
• Cloudflare Turnstile (challenges.cloudflare.com) — optional, standardmäßig deaktiviert (nur wenn du eigene Schlüssel eingibst): Der Browser des Besuchers lädt das Turnstile-Widget; der Server verifiziert die Antwort, indem er den Secret Key, das Token und die IP-Adresse des Besuchers sendet.
• E-Mail über deinen SMTP-Server (nichts, bis du SMTP konfigurierst; standardmäßig STARTTLS): an den Antragsteller — Bestätigung, Entscheidung (genehmigt/abgelehnt), die vom Admin verfasste Zugangsnachricht (kann ein generiertes Passwort enthalten); an den Admin — Benachrichtigungen (standardmäßig deaktiviert). Die Plugins Cashier und Security Notifications können über diesen SMTP E-Mails senden.
• Telegram (api.telegram.org) — optional, standardmäßig deaktiviert: Admin-Benachrichtigungen mit den Anfragedaten (Vor-/Nachname, Benutzername, E-Mail, Telefon, IP, Cloudflare-Land). Derselbe Inhalt geht an die Admin-E-Mail, falls aktiviert.
• Keine Online-Geo-/ASN-Abfragen: Das Land stammt aus dem CF-IPCountry-Header (wenn der Server hinter Cloudflare steht); der Netzwerktyp (Datenzentrum/Tor) stammt aus einer lokalen ASN-Datenbank (etwa der, die Access Log herunterlädt), ohne Netzwerkanfrage.
• Die öffentliche Registrierungsseite lädt nur die eigenen Dateien des Plugins (plus Turnstile, falls aktiviert); QR-Codes werden auf dem Server erzeugt. Die WhatsApp-/Telegram-Teilen-Schaltflächen auf der Admin-Seite sind normale Links, die der Admin öffnet.
• Verschwindet die Schaltfläche am Anmeldebildschirm (index.html-Patch) nach einem Emby-Update und kann nicht wiederhergestellt werden, wird das Log nur gesendet, wenn das automatische Log-Senden aktiv ist.
• Dazu der Lizenz-Client, in jedem Plugin gleich: siehe Lizenzierung und Datenschutz in unseren Plugins.

Lokal gespeichert:

• data/registrations.json (Modus 600): pro Anfrage — Benutzername, Vor-/Nachname, E-Mail, Telefon, Einladungscode, IP, Cloudflare-Land, User-Agent, Sprache, Zeitpunkt der Einwilligung, Hash des E-Mail-Tokens (nicht das Token), Subnetz, gehashte Geräte-ID, Browser-Fingerprint, ISP (ASN), Flags; dazu Einladungs-/Zugangscodes, Sperren und tägliche Statistiken.
• Passwörter werden vom Plugin nicht gespeichert: Das Emby-Konto wird (deaktiviert) zum Zeitpunkt der Anfrage erstellt, das Passwort behandelt der Server. Ausnahme: Die TV-Übergabe hält das Passwort nur im Arbeitsspeicher, bis es übergeben wurde oder maximal 24 h.
• SMTP-Passwort, Telegram-Token, Turnstile-Secret und HMAC-Schlüssel des Formulars: verschlüsselt gespeichert in secrets.enc.json im Plugin-Datenordner (AES-256-GCM, Zufallsschlüssel aus secrets.key, gebunden an die Server-ID, beide Dateien Modus 600) und nie an den Browser gesendet (die Seite zeigt nur „set ✓“) (ab Version 1.10.7; frühere Versionen halten sie im Klartext in der Plugin-Konfiguration).
• Im Browser des Besuchers: eine signierte Geräte-ID (Cookie + localStorage).
• Aufbewahrung: Abgelehnte/abgelaufene/gelöschte Anfragen werden nach 30 Tagen gelöscht; ausstehende Anfragen laufen nach 7 Tagen ab (das deaktivierte Konto wird gelöscht); wenn ein Benutzer gelöscht wird, werden seine personenbezogenen Daten im Plugin sofort entfernt; genehmigte Anfragen werden aufbewahrt, solange das Konto existiert. Daten werden bei der Deinstallation nicht gelöscht, es sei denn, du aktivierst diese Option.

Kompatibilität mit Clients

• Kontoerstellung, Freigabe, Regeln und der Cashier-Link laufen serverseitig: 🟢 Das erstellte Konto funktioniert in jeder App.
• Öffentliche Registrierungsseite: jeder Browser — ✅ Desktop und Telefon (automatisierte Tests in Chrome).
• Schaltfläche „Create account“ am Anmeldebildschirm: nur Emby Web (Skript, das zu dashboard-ui/index.html hinzugefügt wird; gehört die Datei root, wird der Befehl angezeigt; wird nach Emby-Updates erneut angewendet). Native Emby-Apps (Android, iOS, Android TV, Samsung, LG, Roku, Apple TV) können die Schaltfläche nicht anzeigen — sende ihnen den Link oder QR-Code.
• Fernseher: Die Seite erkennt TV-Browser und zeigt einen QR-Code für das Telefon ✅ (emulierter Philips NETTV; ❔ nicht auf echten Fernsehern getestet).
• Admin-Seite: aus einem Browser (die Emby-App blockiert Plugin-Seiten).

Legende: ✅ verifiziert (End-to-End- oder Test auf dem Gerät) · 🟢 serverseitig, funktioniert mit jedem Client (konstruktionsbedingt, kein clientspezifischer Test) · ➖ nicht zutreffend · ❔ nicht getestet.

Lizenzierung

Eine Lizenz pro Emby-Server. Monatlich, jährlich oder als Lifetime-Lizenz, oder im Emby-Paket enthalten. 30 Tage kostenlos testen.