Restricción de red de la gestión¶
Un streamer edge sirve medios a internet, pero el mismo puerto HTTP expone también la API de administración, la consola, las métricas y el diagnóstico. La restricción de red cierra el plano de gestión a las redes de confianza manteniendo la reproducción, la publicación y el tráfico propio del clúster.
La restricción es una lista de direcciones IPv4/IPv6 y CIDR en el ajuste management_allowed_ips. Mientras la lista esté definida, una ruta de gestión responde a una solicitud desde cualquier otra dirección con 403 y sin redirección. Si la lista falta o está vacía, nada queda restringido.
Qué es gestión y qué no¶
La división está fijada en el código y no se configura:
- Los medios siguen siendo públicos — HLS, DASH, fragmentos MPEG-TS/fMP4, vistas previas, VOD, rutas legacy de reproducción, publicación (MPEG-TS push, WHIP/WHEP) y la carga de VOD firmada. Siguen valiendo la autorización habitual: tokens de reproducción, sesiones de publicación, permisos de carga.
- Gestión es todo lo demás — la API de administración (v3/v4), la consola y sus recursos, métricas, diagnóstico, el relé ONVIF, el proxy inverso integrado cuando realmente ejecuta la solicitud, NMOS tanto en el puerto compartido como en el dedicado, y cualquier ruta que el servidor no reconozca. La comprobación de salud también es gestión: el balanceador que sondea el servidor debe estar en una red permitida.
La autorización no desaparece: una dirección permitida aun debe superar el inicio de sesión habitual, las claves de API y los roles. La restricción acota quién puede llamar a la puerta, no a quién se admite.
Configurar la política¶
En un clúster la política vive en la consola de central, apartado Configuración → Restricción de red de la gestión. Tres estados:
- Sin definir (heredado) — vale el valor de la capa menos prioritaria; para un streamer gestionado es su configuración local.
- Desactivada (todas las redes) — se guarda como una lista vacía
[]y desactiva explícitamente la restricción, anulando las capas inferiores. - Redes permitidas — una dirección o CIDR por línea.
El servidor guarda y devuelve la forma canónica: una dirección sin máscara se convierte en 192.0.2.10/32 o 2001:db8::10/128, y los host bits de un CIDR se enmascaran (198.51.100.77/24 se guarda como 198.51.100.0/24). El orden de las entradas se conserva. Una errata en una línea se rechaza al guardar: 422 con la ruta hasta la entrada, y el mensaje se muestra en el campo.
El formulario advierte antes de guardar una lista no vacía: asegúrese de que la red desde la que se conecta figure en ella, o la consola misma quedará inaccesible. Si ocurre, corrija el ajuste desde una máquina dentro de una red permitida (o por una vía fuera de banda, como la consola del hipervisor). No existe un mecanismo automático de «permitir mi dirección actual».
Para un streamer independiente sin central, el mismo ajuste es el campo management_allowed_ips de nivel superior de la configuración del servidor.
Capas y la tarjeta del streamer¶
La política se compone de capas, la más fuerte al final: el archivo principal, luego central y después los archivos drop-in de la máquina. En el directorio .d junto a la configuración solo se leen como drop-ins los archivos *.json y *.conf: un *.yaml ahí se ignora en silencio, así que nombre los drop-ins en consecuencia o la lista que contengan no se aplicará. En los streamers gestionados central entrega su ajuste como un valor de solo lectura; no se puede definir una política propia por máquina. Si el documento de un streamer llegara a contener su propio management_allowed_ips, el servidor rechaza la escritura con 422 sin cambiar el documento; una clave guardada obsoleta puede eliminarse escribiendo null, lo que limpia la copia entregada sin tocar la política común.
La tarjeta del streamer muestra ambas partes por separado:
- Definido en central — la política común de la página de configuración.
- Aplicado por el nodo (último informe) — la lista que la máquina realmente aplica, según su último informe, con la hora en que se recibió.
Ambas listas pueden diferir: un drop-in local en la máquina anula a central, y la tarjeta lo indica. Una lista informada vacía significa que la restricción está desactivada en la máquina; un informe ausente significa sin datos, no una restricción desactivada: la política común nunca se sustituye por un informe ausente. Si la máquina pierde la conexión, la última lista informada permanece en la tarjeta marcada como no confirmada.
Cómo se comprueba una solicitud¶
Solo se comprueba la dirección par de la conexión TCP. X-Forwarded-For, X-Real-IP y Forwarded se ignoran: los proxies de confianza del lado de la reproducción no influyen en la gestión, y una cabecera falsificada no cambia nada. Una dirección IPv4 escrita en la forma IPv4-mapped IPv6 coincide también con entradas IPv4 de la lista; una red IPv6 explícita conserva su propia correspondencia.
Permitir un proxy inverso significa confiar en todas las solicitudes desde su dirección: el streamer no puede distinguir a los clientes del proxy. Mantenga la ruta de gestión por una vía directa LAN/VPN, o aplique su propia lista de permitidos en el proxy.
Aplicación y entrega¶
El cambio de la lista se aplica de inmediato, sin reinicio y sin reasignar puertos: la reproducción no se interrumpe. Un streamer gestionado arranca desde su configuración guardada incluso sin enlace a central; cuando llega el ajuste de central, se superpone. Si la recarga de la configuración falla antes de aplicarse, sigue vigente la lista anterior; una aplicación parcial (por ejemplo, la lista nueva publicada pero con otra etapa fallida) deja la lista nueva en vigor junto con el error: la tarjeta muestra el valor y config_error por separado, sin reversión silenciosa. Un archivo drop-in defectuoso se omite con una advertencia como antes: si llevaba la lista más estricta, la política efectiva puede debilitarse, así que controle el contenido del directorio .d.
Central integrado¶
Si central está instalado en la misma máquina que el streamer (entrega integrada), acepta y guarda el ajuste y lo entrega a los streamers gestionados, pero aún no lo aplica a sus propias rutas de gestión: la tarjeta de este nodo en la lista de máquinas lo muestra directamente: «definido en central» aparece, pero «aplicado por el nodo» figura como «desactivado», con una explicación. Una lista guardada no significa que este servidor esté protegido: los streamers gestionados aplican la política con independencia de él.
Reversión y downgrade¶
Si revierte la versión del propio streamer, el ajuste desaparece solo de sus archivos de configuración local; el ajuste guardado en central y la copia local de la configuración entregada se conservan y vuelven con la próxima actualización. Revertir solo central puede entregar a los streamers un documento sin este campo, y la política común se desactivará en los streamers nuevos. Después de volver a la versión nueva de central, guarde de nuevo la lista deseada en la configuración común (aunque ya esté escrita, vuelva a guardar el mismo texto) y compruebe en las tarjetas de los streamers que se ha aplicado: ni un reinicio ni un documento intacto bastan por sí solos para restaurar la entrega.
En qué no se convierte la restricción¶
- No es un firewall: protege las rutas HTTP de gestión del servidor, no la máquina. El filtrado a nivel de sistema operativo sigue siendo suyo.
- No sustituye a la autorización: los inicios de sesión, tokens y roles funcionan como antes.
- No restringe los protocolos de medios: RTSP, RTMP, SRT y demás protocolos no HTTP quedan fuera de este mecanismo.