Security Notifications para Emby — guía

Instalación

Necesitas Emby Server 4.10.1 o posterior.

1. Inicia sesión en tu cuenta de MediaLab Works, abre Licenses y descarga el DLL del plugin (disponible con una suscripción activa, con una licencia de por vida dentro de su período de actualizaciones o durante la prueba gratuita de 30 días).
2. Copia el DLL en la carpeta de plugins de Emby y reinicia Emby Server:
   • Linux (paquete): /var/lib/emby/plugins/
   • Docker: la carpeta plugins dentro del volumen de configuración de Emby
   • Windows: %AppData%\Emby-Server\programdata\plugins\
3. Abre Security Notifications en el menú del panel de Emby y haz clic en Open License page. Pega tu clave de licencia y actívala, o escribe tu correo para empezar la prueba gratuita de 30 días o comprar una licencia. El plugin contacta con el servidor de licencias, vincula la clave a este servidor de Emby y muestra la licencia como Active.

La licencia se comprueba una vez al día (y en cada arranque de Emby). Sin internet, el plugin sigue funcionando 7 días después de la última comprobación correcta; después se detiene hasta que pueda comprobarla de nuevo.

Licencia

Sin una licencia válida, el plugin se detiene: no se comprueba ninguna regla ni se envía ninguna alerta, y solo sigue funcionando la página License (desde ella puedes empezar la prueba, comprar, introducir la clave o actualizar). Tus ajustes y el historial de alertas se conservan. No se borra nada: todo se reanuda en cuanto la licencia vuelve a ser válida.

Con una licencia válida, esa misma página puede instalar una actualización o volver a la versión anterior si una actualización causa problemas. Reinicia Emby después de cualquiera de las dos.

Configuración

Abre Security Notifications en el panel de Emby. La página tiene cinco pestañas: Overview, History, Rules, Channels y Settings.

1. Channels: activa los canales que quieras y define la gravedad mínima de cada uno; después, usa Send a test.
   • Telegram: introduce el token del bot, envía /start al bot (o añádelo a un grupo) y haz clic después en Find para rellenar el chat.
   • E-mail: los destinatarios y tu servidor SMTP. Se recomienda el puerto 587 con STARTTLS (el puerto 465 con TLS implícito no está soportado). Si tienes instalado Registration, puedes reutilizar su servidor SMTP.
   • Webhook: elige Discord, Slack, ntfy, Gotify o JSON y pega la dirección. La dirección contiene el token y se guarda separada de los ajustes. Para Gotify, añade ?token=… a la dirección /message.
   • Registro de actividad de Emby: las alertas también aparecen en la lista de actividad del panel.
2. No spam (misma pestaña): cada cuánto puede repetirse la misma alerta, las horas de silencio (solo salen enseguida las alertas críticas; el resto llega en un resumen cuando terminan) y el resumen diario opcional para alertas medias e informativas.
3. Rules: cada una de las 20 reglas tiene un interruptor, una gravedad y, cuando procede, umbrales (por ejemplo, cuántas contraseñas incorrectas en cuántos minutos, la velocidad para el viaje imposible o las horas habituales del administrador).
4. Settings:
   • Location: DB-IP Lite (gratis, sin cuenta), MaxMind GeoLite2 (el id de tu cuenta y la clave de licencia) o desactivado. Sin ubicación no funcionan las reglas de país nuevo, viaje imposible y red nueva.
   • Network: redes de confianza (CIDR) tratadas como locales, como tu propia VPN. Las redes privadas se incluyen automáticamente. Activa The server is behind its own proxy si Emby está detrás de nginx, Caddy, Traefik o similar, para que se esperen las cabeceras reenviadas; Cloudflare se reconoce por sí solo.
   • Bad IP lists: salidas de Tor (actualizadas cada hora) y Spamhaus DROP (a diario).

Uso diario

• Overview muestra las alertas recientes y el estado del plugin.
• History enumera cada alerta con cuenta, dirección, ubicación, dispositivo y los canales a los que se envió; filtra por gravedad, regla y período, o exporta a CSV.
• Cada alerta indica por qué es sospechosa y qué comprobar. Si fuiste tú (un móvil nuevo, un viaje al extranjero), no hay que hacer nada.

Resolución de problemas

• Todas las alertas muestran la misma dirección (tu proxy o Cloudflare): configura tu proxy inverso para que Emby reciba la dirección real del visitante y activa The server is behind its own proxy en Settings.
• No llegan mensajes de Telegram: envía de nuevo /start al bot y haz clic en Find; comprueba la gravedad mínima del canal.
• Sin ubicación: comprueba la fuente de Location en Settings; con MaxMind, comprueba el id de la cuenta y la clave.