Перейти к содержимому
Продукты

Alta за nginx (X-Forwarded-For)

Когда перед Alta стоит nginx или другой обратный прокси, все запросы приходят в Alta с адреса прокси. Адрес зрителя прокси передаёт в заголовке X-Forwarded-For. В этой статье показано, как настроить nginx и Alta, чтобы сессии и авторизация работали с адресом зрителя.

Статья описывает Alta 261020 и новее.

  1. Зритель запрашивает http://tv.example.com/news/index.m3u8.
  2. nginx передаёт запрос в Alta и добавляет заголовок X-Forwarded-For: <адрес зрителя>.
  3. Alta проверяет, что запрос пришёл с адреса из списка X-Forwarded-For IP OTT-сервера.
  4. Если да, Alta считает адрес из заголовка адресом зрителя: на странице Сессии и в авторизаторах.

Alta читает заголовок один раз, когда зритель открывает плейлист канала: index.m3u8 или ссылку на архив из формата URL. Медиаплейлисты и сегменты адрес не проверяют. Запросы WebRTC (WHEP) заголовок не используют: авторизаторы видят адрес прокси.

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: порт OTT-сервера Alta.
  • X-Forwarded-For $remote_addr: Alta принимает в заголовке ровно один адрес. Не используйте $proxy_add_x_forwarded_for: если в запросе уже есть заголовок, nginx составит список вида 203.0.113.7, 198.51.100.20. Список Alta игнорирует, и сессия получает адрес nginx.
  • Host: Alta пишет в плейлисты полные ссылки и строит их из заголовка Host, например http://tv.example.com/news/.... Без этой строки ссылки указывают на 127.0.0.1:8102, и плееры не могут их открыть.
  • X-Forwarded-Proto: нужен, когда nginx принимает HTTPS. Тогда Alta пишет в плейлисты ссылки https://.

Если перед nginx стоит CDN или другой прокси, в $remote_addr оказывается адрес CDN. Пусть модуль nginx realip возьмёт адрес зрителя из заголовка CDN:

set_real_ip_from 192.0.2.0/24; # адреса CDN
real_ip_header X-Forwarded-For;
real_ip_recursive on;

После этого в $remote_addr адрес зрителя, и конфигурация выше передаёт его в Alta.

  1. Откройте Settings → HTTP Servers и отредактируйте OTT Server.
  2. В разделе X-Forwarded-For IP нажмите Add IP и введите адрес nginx, с которого он подключается к Alta. Если nginx на том же сервере, введите 127.0.0.1. Можно указать и сеть, например 10.0.0.0/24.
  3. Если nginx на том же сервере, выберите Default Interface localhost. Тогда зрители не смогут подключиться к порту Alta напрямую, в обход nginx.
  4. Сохраните настройки.

У API Server свой список X-Forwarded-For IP. Там он меняет только адрес клиента в журнале запросов API.

Когда адреса прокси добавлены в список, запрос с одним адресом в X-Forwarded-For с адреса не из списка обрабатывается так:

  • у канала есть авторизатор: Alta игнорирует заголовок и проверяет адрес подключения;
  • у канала нет авторизатора: Alta отвечает 403 Forbidden и пишет в журнал сервиса: Real IP check failed for path ... from IP ..., X-Forwarded-For: ....

У запроса от доверенного прокси два адреса: адрес подключения (nginx) и адрес зрителя из заголовка.

  • IP: правило срабатывает, если подходит любой из двух адресов. Правило для адреса nginx, например allow 127.0.0.1, подходит каждому зрителю. Пишите правила только для адресов зрителей.
  • Securetoken: Alta принимает токен, созданный для любого из двух адресов. Создавайте токены для адреса зрителя.
  • HTTP Backend: заголовок X-Real-Ip содержит адрес зрителя.
  1. Запросите плейлист через nginx с другого компьютера:

    Окно терминала
    curl -s http://tv.example.com/news/index.m3u8

    Ссылки в ответе начинаются с http://tv.example.com/.

  2. Откройте канал в плеере и посмотрите страницу Сессии: в колонке IP адрес зрителя, а не адрес nginx.