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.
Como funciona
Seção intitulada “Como funciona”- Um espectador solicita
http://tv.example.com/news/index.m3u8. - O nginx encaminha a requisição ao Alta e adiciona o cabeçalho
X-Forwarded-For: <endereço do espectador>. - O Alta verifica se a requisição veio de um endereço da lista X-Forwarded-For IP do servidor OTT.
- 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.
Configurar o nginx
Seção intitulada “Configurar o 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: 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 como203.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çalhoHost, por exemplohttp://tv.example.com/news/.... Sem esta linha os links apontam para127.0.0.1:8102e os players não conseguem abri-los.X-Forwarded-Proto: necessário quando o nginx aceita HTTPS. Assim o Alta escreve linkshttps://nas playlists.
Uma CDN na frente do nginx
Seção intitulada “Uma CDN na frente do nginx”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 CDNreal_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.
Configurar o Alta
Seção intitulada “Configurar o Alta”- Abra Settings → HTTP Servers e edite o OTT Server.
- 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 exemplo10.0.0.0/24. - Se o nginx estiver no mesmo servidor, escolha
localhostem Default Interface. Assim os espectadores não conseguem acessar a porta do Alta diretamente, sem passar pelo nginx. - 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.
Requisições de outros endereços
Seção intitulada “Requisições de outros endereços”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 Forbiddene escreve no log do serviço:Real IP check failed for path ... from IP ..., X-Forwarded-For: ....
Autorização atrás de um proxy
Seção intitulada “Autorização atrás de um proxy”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-Ipcontém o endereço do espectador.
Verificar a configuração
Seção intitulada “Verificar a configuração”-
Solicite a playlist através do nginx a partir de outro computador:
Terminal window curl -s http://tv.example.com/news/index.m3u8Os links da resposta começam com
http://tv.example.com/. -
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.