Quick Connect para Emby

Quick Connect permite que tus usuarios inicien sesión en un televisor o en cualquier otra pantalla sin escribir la contraseña con un mando a distancia. La pantalla muestra un código de 6 dígitos y un código QR; el usuario lo escanea con el móvil, aprueba y la pantalla inicia sesión en Emby Web. Emby no tiene un inicio de sesión por código propio; este plugin lo añade.

Qué hace

• Inicio de sesión con el móvil: en un navegador del televisor, un ordenador o MediaLab TV, la pantalla muestra un código de 6 dígitos y un código QR. En el móvil, el usuario aprueba con un toque si Emby ya tiene la sesión iniciada allí, o con nombre de usuario + contraseña (esta segunda forma se puede desactivar). La pantalla entra entonces sola en Emby Web.
• Botón «Sign in with your phone» en la pantalla de inicio de sesión de Emby Web. El plugin lo añade a la página web de Emby y lo vuelve a poner automáticamente tras las actualizaciones de Emby.
• Código de un solo uso para las apps oficiales de Emby (televisores, consolas, móviles): un usuario que lo activa pide un código de 6 dígitos en el móvil y lo escribe en el campo de la contraseña de la app de Emby. El código es válido durante 5 minutos y funciona una sola vez. Es optativo por usuario y la contraseña habitual sigue funcionando. Si se quita el plugin o su licencia termina, Emby vuelve a comprobar la contraseña habitual por sí mismo.
• Cuenta nueva desde el móvil: con Registration instalado, la página del móvil enlaza a la página de registro.
• Panel de administración en el panel de Emby: ajustes, el botón de la pantalla de inicio de sesión, los usuarios con códigos para apps y los inicios de sesión recientes. En inglés y rumano.

Seguridad

• Los códigos de pantalla son aleatorios, válidos durante 5 minutos por defecto (de 1 a 15, a tu elección) y se usan una sola vez; solo la pantalla que pidió el código recibe la sesión. Una dirección puede tener como máximo 5 códigos pendientes a la vez.
• 10 intentos fallidos (códigos o contraseñas incorrectos) desde una dirección en 10 minutos la bloquean durante 10 minutos. Un código de un solo uso para apps se anula tras 5 intentos fallidos.
• Las cuentas desactivadas se rechazan, y también las cuentas sin acceso remoto cuando la pantalla está fuera de tu red local. Opcionalmente, las cuentas de administrador no pueden iniciar sesión por código en absoluto.
• Los códigos de un solo uso para apps se guardan solo como hash, en memoria: reiniciar Emby anula todos los códigos que sigan pendientes.
• Cada inicio de sesión por código se registra con usuario, dispositivo, app y quién lo aprobó.

Requisitos

• Emby Server 4.10.1 o posterior (Linux, Windows o Docker).
• Para el botón en la pantalla de inicio de sesión: acceso de escritura a la página web de Emby (dashboard-ui/index.html). Cuando Emby se ejecuta sin él, el plugin muestra el único comando que hay que ejecutar en el servidor. Las páginas del móvil y de la pantalla funcionan sin el botón.

Preguntas frecuentes

¿Pueden mis usuarios iniciar sesión en un televisor sin escribir su contraseña? Sí. En Emby Web (navegador del televisor, ordenador, MediaLab TV) aprueban el código de la pantalla desde su móvil; en las apps oficiales de Emby escriben un código de un solo uso del móvil en lugar de la contraseña. Consulta la guía.

¿El código de un solo uso sustituye a la contraseña? No. Es una forma extra de entrar, activada por usuario. La contraseña habitual sigue funcionando y, sin el plugin, Emby vuelve a comprobar solo la contraseña habitual.

Qué envía y adónde

• Ningún servicio externo aparte del cliente de licencias. Los códigos QR se generan en el servidor; las páginas de la pantalla y del móvil solo cargan los archivos del plugin.
• Después del inicio de sesión, el televisor/navegador se envía a la dirección definida por el administrador (por defecto: la interfaz web del servidor). El token de sesión se escribe en el almacenamiento del navegador antes de la redirección; nunca se pone en la URL. Las direcciones locales y externas son solo HTTPS.
• El botón de la pantalla de inicio de sesión se añade a dashboard-ui/index.html (activado por defecto; escritura directa, después sudo -n; si no, se muestra el comando). Si no puede restaurarse tras una actualización de Emby, el registro se envía solo con el envío automático de registros activado (una vez por versión de Emby).
• Además, el cliente de licencias, el mismo en cada plugin: consulta Licencias y privacidad en nuestros plugins.

Guardado localmente:

• Códigos pendientes y códigos de un solo uso (6 dígitos, 5 min, un solo uso) — solo en memoria.
• state/connections.json: los últimos 500 inicios de sesión (hora, usuario, dispositivo, app, IP, método).
• La lista de usuarios que activaron los códigos de un solo uso (configuración del plugin).

Nunca se envían: contraseñas, tokens — nada va a terceros.

Compatibilidad con clientes

• Pantalla + móvil (QR, aprobar desde el móvil): navegadores — Emby Web en un televisor, escritorio, MediaLab TV. ✅ emulado (Chrome con un User-Agent de Philips NETTV; 40/40); ❔ no probado en televisores físicos.
• Botón de la pantalla de inicio de sesión: solo Emby Web.
• Apps oficiales de Emby (Android, iOS, Android TV, Samsung, LG, Roku, Apple TV): el código de un solo uso se escribe en lugar de la contraseña. Opción por usuario (desactivada por defecto): cambia el proveedor de autenticación del usuario al plugin; la contraseña habitual sigue funcionando; sin el plugin o la licencia, Emby vuelve al proveedor predeterminado. ✅ simulado mediante la API (cliente «Emby for Android TV»); ❔ no probado en las apps reales.
• Inicio de sesión automático tras cuenta nueva y pago: con Registration (1.10.5+) y Cashier; desactivado por defecto.

Leyenda: ✅ verificado (prueba de extremo a extremo o en el dispositivo) · 🟢 en el servidor, funciona con cualquier cliente (por diseño, sin prueba específica para cada cliente) · ➖ no aplicable · ❔ no probado.

Licencia

Una licencia por servidor de Emby. Mensual, anual o de por vida, o incluida en el paquete para Emby. 30 días de prueba gratis. El plugin se distribuye bajo nuestro EULA.

Código propio, escrito por MediaLab Works. Código de terceros: el generador de códigos QR se basa en la biblioteca QR Code generator de Project Nayuki (licencia MIT).