Saltearse al contenido
Productos

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.

  1. Un espectador pide http://tv.example.com/news/index.m3u8.
  2. nginx reenvía la petición a Alta y añade la cabecera X-Forwarded-For: <dirección del espectador>.
  3. Alta comprueba que la petición llega desde una dirección de la lista X-Forwarded-For IP del servidor OTT.
  4. 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.

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 como 203.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 cabecera Host, por ejemplo http://tv.example.com/news/.... Sin esta línea los enlaces apuntan a 127.0.0.1:8102 y los reproductores no pueden abrirlos.
  • X-Forwarded-Proto: necesaria cuando nginx acepta HTTPS. Así Alta escribe enlaces https:// en las listas de reproducción.

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 CDN
real_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.

  1. Abre Settings → HTTP Servers y edita el OTT Server.
  2. 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 ejemplo 10.0.0.0/24.
  3. Si nginx está en el mismo servidor, elige localhost en Default Interface. Así los espectadores no pueden llegar al puerto de Alta directamente, sin pasar por nginx.
  4. 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.

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 Forbidden y escribe en el registro del servicio: Real IP check failed for path ... from IP ..., X-Forwarded-For: ....

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-Ip contiene la dirección del espectador.
  1. 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.m3u8

    Los enlaces de la respuesta empiezan por http://tv.example.com/.

  2. 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.