Alta detrás de nginx (X-Forwarded-For)
Cuando nginx u otro proxy inverso está delante de Alta, todas las peticiones llegan a Alta desde la dirección del proxy. El proxy pasa la dirección del espectador en la cabecera X-Forwarded-For. Este artículo muestra cómo configurar nginx y Alta para que las sesiones y la autorización usen la dirección del espectador.
Este artículo describe Alta 261020 y versiones posteriores.
Cómo funciona
Sección titulada «Cómo funciona»- Un espectador pide
http://tv.example.com/news/index.m3u8. - nginx reenvía la petición a Alta y añade la cabecera
X-Forwarded-For: <dirección del espectador>. - Alta comprueba que la petición llega desde una dirección de la lista X-Forwarded-For IP del servidor OTT.
- Si es así, Alta usa la dirección de la cabecera como dirección del espectador: en la página Sesiones y en los autorizadores.
Alta lee la cabecera una vez, cuando el espectador abre la lista de reproducción del canal: index.m3u8 o un enlace de archivo de Formato de URL. Las listas de medios y los segmentos no comprueban la dirección. Las peticiones WebRTC (WHEP) no usan la cabecera: los autorizadores ven la dirección del proxy.
Configurar nginx
Sección titulada «Configurar nginx»server { listen 80; server_name tv.example.com;
location / { proxy_pass http://127.0.0.1:8102; proxy_set_header Host $http_host; proxy_set_header X-Forwarded-For $remote_addr; proxy_set_header X-Forwarded-Proto $scheme; }}8102: el puerto del servidor OTT de Alta.X-Forwarded-For $remote_addr: Alta acepta exactamente una dirección en la cabecera. No uses$proxy_add_x_forwarded_for: si la petición ya trae la cabecera, nginx forma una lista como203.0.113.7, 198.51.100.20. Alta ignora una lista, y la sesión recibe la dirección de nginx.Host: Alta escribe enlaces completos en las listas de reproducción y los construye a partir de la cabeceraHost, por ejemplohttp://tv.example.com/news/.... Sin esta línea los enlaces apuntan a127.0.0.1:8102y los reproductores no pueden abrirlos.X-Forwarded-Proto: necesaria cuando nginx acepta HTTPS. Así Alta escribe enlaceshttps://en las listas de reproducción.
Una CDN delante de nginx
Sección titulada «Una CDN delante de nginx»Si delante de nginx hay una CDN u otro proxy, $remote_addr contiene la dirección de la CDN. Deja que el módulo realip de nginx tome la dirección del espectador de la cabecera de la CDN:
set_real_ip_from 192.0.2.0/24; # direcciones de la CDNreal_ip_header X-Forwarded-For;real_ip_recursive on;Después $remote_addr contiene la dirección del espectador, y la configuración de arriba la pasa a Alta.
Configurar Alta
Sección titulada «Configurar Alta»- Abre Settings → HTTP Servers y edita el OTT Server.
- En X-Forwarded-For IP, pulsa Add IP e introduce la dirección desde la que nginx se conecta a Alta. Si nginx está en el mismo servidor, introduce
127.0.0.1. También se acepta una red, por ejemplo10.0.0.0/24. - Si nginx está en el mismo servidor, elige
localhosten Default Interface. Así los espectadores no pueden llegar al puerto de Alta directamente, sin pasar por nginx. - Guarda la configuración.
El API Server tiene su propia lista X-Forwarded-For IP. Allí solo cambia la dirección del cliente en el registro de peticiones de la API.
Peticiones desde otras direcciones
Sección titulada «Peticiones desde otras direcciones»Con las direcciones de los proxies en la lista, una petición con una sola dirección en X-Forwarded-For que llega desde una dirección fuera de la lista se trata así:
- el canal tiene autorizador: Alta ignora la cabecera y comprueba la dirección de la conexión;
- el canal no tiene autorizador: Alta responde
403 Forbiddeny escribe en el registro del servicio:Real IP check failed for path ... from IP ..., X-Forwarded-For: ....
Autorización detrás de un proxy
Sección titulada «Autorización detrás de un proxy»Una petición de un proxy de confianza lleva dos direcciones: la de la conexión (nginx) y la del espectador de la cabecera.
- IP: una regla se aplica si coincide con cualquiera de las dos. Una regla para la dirección de nginx, por ejemplo
allow 127.0.0.1, coincide con todos los espectadores. Escribe reglas solo para direcciones de espectadores. - Securetoken: Alta acepta un token creado para cualquiera de las dos direcciones. Crea los tokens para la dirección del espectador.
- HTTP Backend: la cabecera
X-Real-Ipcontiene la dirección del espectador.
Comprobar la configuración
Sección titulada «Comprobar la configuración»-
Pide la lista de reproducción a través de nginx desde otro equipo:
Ventana de terminal curl -s http://tv.example.com/news/index.m3u8Los enlaces de la respuesta empiezan por
http://tv.example.com/. -
Abre el canal en un reproductor y mira la página Sesiones: la columna IP muestra la dirección del espectador, no la de nginx.