Conectare rapidă — Emby cu telefonul

Conectare rapidă le permite utilizatorilor tăi să intre pe televizor sau pe orice alt ecran fără să-și tasteze parola cu telecomanda. Ecranul arată un cod de 6 cifre și un cod QR; utilizatorul îl scanează cu telefonul, aprobă, iar ecranul intră în Emby Web. Emby nu are conectare cu cod; plugin-ul o adaugă.

Ce face

• Conectare cu telefonul: în browserul televizorului, pe un calculator sau în MediaLab TV, ecranul arată un cod de 6 cifre și un cod QR. Pe telefon utilizatorul aprobă cu un clic dacă e deja conectat acolo în Emby, sau cu utilizator + parolă (a doua variantă se poate opri). Ecranul intră apoi singur în Emby Web.
• Butonul „Conectare cu telefonul” pe ecranul de conectare Emby Web. Plugin-ul îl adaugă în pagina web a Emby și îl pune la loc automat după actualizările Emby.
• Cod de unică folosință în aplicațiile oficiale Emby (televizoare, console, telefoane): utilizatorul care îl activează cere de pe telefon un cod de 6 cifre și îl scrie la parolă în aplicația Emby. Codul e valabil 5 minute și merge o singură dată. Se activează per utilizator, iar parola obișnuită merge în continuare. Dacă plugin-ul e scos sau licența expiră, Emby revine singur la verificarea parolei obișnuite.
• Cont nou de pe telefon: cu Registration instalat, pagina telefonului trimite la pagina de înregistrare.
• Panou de administrare în tabloul de bord Emby: setări, butonul de pe ecranul de conectare, utilizatorii cu coduri pentru aplicații și conectările recente. În română și engleză.

Securitate

• Codurile de pe ecran sunt aleatorii, valabile implicit 5 minute (între 1 și 15, cum alegi) și se folosesc o singură dată; doar ecranul care a cerut codul primește sesiunea. O adresă poate avea cel mult 5 coduri în așteptare.
• 10 încercări greșite (coduri sau parole greșite) de la aceeași adresă în 10 minute o blochează 10 minute. Un cod de unică folosință pentru aplicații se anulează după 5 încercări greșite.
• Conturile dezactivate sunt refuzate, la fel și conturile fără acces de la distanță când ecranul e în afara rețelei tale locale. Opțional, conturile de administrator nu se pot conecta deloc prin cod.
• Codurile de unică folosință se păstrează doar ca hash, în memorie: repornirea Emby anulează toate codurile aflate în așteptare.
• Fiecare conectare prin cod se înregistrează cu utilizatorul, dispozitivul, aplicația și cine a aprobat-o.

Cerințe

• Emby Server 4.10.1 sau mai nou (Linux, Windows sau Docker).
• Pentru butonul de pe ecranul de conectare: drept de scriere pe pagina web a Emby (dashboard-ui/index.html). Când Emby rulează fără el, plugin-ul arată comanda de rulat pe server. Paginile telefonului și ecranului merg și fără buton.

Întrebări frecvente

Se pot conecta utilizatorii pe televizor fără să-și tasteze parola? Da. În Emby Web (browserul televizorului, calculator, MediaLab TV) aprobă de pe telefon codul de pe ecran; în aplicațiile oficiale Emby scriu la parolă un cod de unică folosință cerut de pe telefon. Vezi ghidul.

Codul de unică folosință înlocuiește parola? Nu. E o cale în plus, activată per utilizator. Parola obișnuită merge în continuare, iar fără plugin Emby verifică din nou doar parola obișnuită.

Ce trimite și unde

• Niciun serviciu extern în afara clientului de licență. Codurile QR sunt generate pe server; paginile ecranului și telefonului încarcă doar fișierele plugin-ului.
• După conectare, televizorul/browserul e trimis la adresa setată de admin (implicit interfața web a serverului). Tokenul de sesiune e scris în memoria browserului înainte de redirecționare, nu e pus în URL. Adresele locală/externă sunt doar HTTPS.
• Butonul de pe ecranul de conectare se adaugă în dashboard-ui/index.html (pornit implicit; scriere directă, apoi sudo -n, altfel comanda e afișată). Dacă nu poate fi refăcut după o actualizare Emby, jurnalul pleacă doar cu trimiterea automată a jurnalului pornită (o dată pe versiune Emby).
• Plus clientul de licență, același în toate plugin-urile: vezi Licențierea și confidențialitatea în plugin-urile noastre.

Stocat local:

• Codurile în așteptare și codurile de unică folosință (6 cifre, 5 min, o singură utilizare) — doar în memorie.
• state/connections.json: ultimele 500 de conectări (ora, utilizatorul, dispozitivul, aplicația, IP-ul, metoda).
• Lista utilizatorilor care au activat codul de unică folosință (în configurația plugin-ului).

Nu se trimite niciodată: parole, tokenuri — nimic nu pleacă spre terți.

Compatibilitate cu clienții

• Ecran + telefon (QR, aprobare din telefon): browsere — Emby Web pe TV, desktop, MediaLab TV. ✅ emulat (Chrome cu User-Agent Philips NETTV; 40/40); ❔ netestat pe televizoare fizice.
• Butonul de pe ecranul de conectare: doar Emby Web.
• Aplicațiile oficiale Emby (Android, iOS, Android TV, Samsung, LG, Roku, Apple TV): codul de unică folosință se tastează în locul parolei. Opțiune per utilizator (oprită implicit): schimbă furnizorul de autentificare al utilizatorului către plugin; parola normală merge în continuare; fără plugin/licență, Emby revine la furnizorul implicit. ✅ simulat prin API (client „Emby for Android TV”); ❔ netestat în aplicațiile reale.
• Conectare automată după cont nou + plată: cu Registration (1.10.5+) și Cashier; implicit oprită.

Legendă: ✅ verificat (test cap-coadă sau pe dispozitiv) · 🟢 funcționează prin server, independent de client (prin design, fără test pe fiecare client) · ➖ nu se aplică · ❔ netestat.

Licențiere

O licență per server Emby. Lunar, anual sau lifetime, sau inclus în Pachetul Emby. 30 de zile de probă gratuită. Plugin-ul este licențiat conform EULA.

Cod propriu, scris de MediaLab Works. Cod de la terți: generatorul de coduri QR se bazează pe biblioteca QR Code generator a Project Nayuki (licență MIT).