Pular para o conteúdo
Produtos

Alta atrás do nginx (X-Forwarded-For)

Quando o nginx ou outro proxy reverso fica na frente do Alta, todas as requisições chegam ao Alta a partir do endereço do proxy. O proxy passa o endereço do espectador no cabeçalho X-Forwarded-For. Este artigo mostra como configurar o nginx e o Alta para que as sessões e a autorização usem o endereço do espectador.

Este artigo descreve o Alta 261020 e versões posteriores.

  1. Um espectador solicita http://tv.example.com/news/index.m3u8.
  2. O nginx encaminha a requisição ao Alta e adiciona o cabeçalho X-Forwarded-For: <endereço do espectador>.
  3. O Alta verifica se a requisição veio de um endereço da lista X-Forwarded-For IP do servidor OTT.
  4. Se veio, o Alta usa o endereço do cabeçalho como endereço do espectador: na página Sessões e nos autorizadores.

O Alta lê o cabeçalho uma vez, quando o espectador abre a playlist do canal: index.m3u8 ou um link de arquivo do Formato de URL. As playlists de mídia e os segmentos não verificam o endereço. As requisições WebRTC (WHEP) não usam o cabeçalho: os autorizadores veem o endereço do 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: a porta do servidor OTT do Alta.
  • X-Forwarded-For $remote_addr: o Alta aceita exatamente um endereço no cabeçalho. Não use $proxy_add_x_forwarded_for: se a requisição já tiver o cabeçalho, o nginx forma uma lista como 203.0.113.7, 198.51.100.20. O Alta ignora uma lista, e a sessão recebe o endereço do nginx.
  • Host: o Alta escreve links completos nas playlists e os monta a partir do cabeçalho Host, por exemplo http://tv.example.com/news/.... Sem esta linha os links apontam para 127.0.0.1:8102 e os players não conseguem abri-los.
  • X-Forwarded-Proto: necessário quando o nginx aceita HTTPS. Assim o Alta escreve links https:// nas playlists.

Se uma CDN ou outro proxy fica na frente do nginx, $remote_addr contém o endereço da CDN. Deixe o módulo realip do nginx pegar o endereço do espectador do cabeçalho da CDN:

set_real_ip_from 192.0.2.0/24; # endereços da CDN
real_ip_header X-Forwarded-For;
real_ip_recursive on;

Depois disso $remote_addr contém o endereço do espectador, e a configuração acima o passa ao Alta.

  1. Abra Settings → HTTP Servers e edite o OTT Server.
  2. Em X-Forwarded-For IP, clique em Add IP e digite o endereço de onde o nginx se conecta ao Alta. Se o nginx estiver no mesmo servidor, digite 127.0.0.1. Uma rede também é aceita, por exemplo 10.0.0.0/24.
  3. Se o nginx estiver no mesmo servidor, escolha localhost em Default Interface. Assim os espectadores não conseguem acessar a porta do Alta diretamente, sem passar pelo nginx.
  4. Salve as configurações.

O API Server tem a sua própria lista X-Forwarded-For IP. Lá ela muda apenas o endereço do cliente no log de requisições da API.

Com os endereços dos proxies na lista, uma requisição com um único endereço em X-Forwarded-For que vem de um endereço fora da lista é tratada assim:

  • o canal tem autorizador: o Alta ignora o cabeçalho e verifica o endereço da conexão;
  • o canal não tem autorizador: o Alta responde 403 Forbidden e escreve no log do serviço: Real IP check failed for path ... from IP ..., X-Forwarded-For: ....

Uma requisição de um proxy confiável traz dois endereços: o da conexão (nginx) e o do espectador, vindo do cabeçalho.

  • IP: uma regra se aplica se corresponder a qualquer um dos dois. Uma regra para o endereço do nginx, por exemplo allow 127.0.0.1, corresponde a todos os espectadores. Escreva regras apenas para endereços de espectadores.
  • Securetoken: o Alta aceita um token criado para qualquer um dos dois endereços. Crie os tokens para o endereço do espectador.
  • HTTP Backend: o cabeçalho X-Real-Ip contém o endereço do espectador.
  1. Solicite a playlist através do nginx a partir de outro computador:

    Terminal window
    curl -s http://tv.example.com/news/index.m3u8

    Os links da resposta começam com http://tv.example.com/.

  2. Abra o canal em um player e veja a página Sessões: a coluna IP mostra o endereço do espectador, não o do nginx.