Alta за nginx (X-Forwarded-For)
Когда перед Alta стоит nginx или другой обратный прокси, все запросы приходят в Alta с адреса прокси. Адрес зрителя прокси передаёт в заголовке X-Forwarded-For. В этой статье показано, как настроить nginx и Alta, чтобы сессии и авторизация работали с адресом зрителя.
Статья описывает Alta 261020 и новее.
Как это работает
Заголовок раздела «Как это работает»- Зритель запрашивает
http://tv.example.com/news/index.m3u8. - nginx передаёт запрос в Alta и добавляет заголовок
X-Forwarded-For: <адрес зрителя>. - Alta проверяет, что запрос пришёл с адреса из списка X-Forwarded-For IP OTT-сервера.
- Если да, Alta считает адрес из заголовка адресом зрителя: на странице Сессии и в авторизаторах.
Alta читает заголовок один раз, когда зритель открывает плейлист канала: index.m3u8 или ссылку на архив из формата URL. Медиаплейлисты и сегменты адрес не проверяют. Запросы WebRTC (WHEP) заголовок не используют: авторизаторы видят адрес прокси.
Настройка nginx
Заголовок раздела «Настройка 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: порт 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://.
CDN перед nginx
Заголовок раздела «CDN перед nginx»Если перед nginx стоит CDN или другой прокси, в $remote_addr оказывается адрес CDN. Пусть модуль nginx realip возьмёт адрес зрителя из заголовка CDN:
set_real_ip_from 192.0.2.0/24; # адреса CDNreal_ip_header X-Forwarded-For;real_ip_recursive on;После этого в $remote_addr адрес зрителя, и конфигурация выше передаёт его в Alta.
Настройка Alta
Заголовок раздела «Настройка Alta»- Откройте Settings → HTTP Servers и отредактируйте OTT Server.
- В разделе X-Forwarded-For IP нажмите Add IP и введите адрес nginx, с которого он подключается к Alta. Если nginx на том же сервере, введите
127.0.0.1. Можно указать и сеть, например10.0.0.0/24. - Если nginx на том же сервере, выберите Default Interface
localhost. Тогда зрители не смогут подключиться к порту Alta напрямую, в обход nginx. - Сохраните настройки.
У 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содержит адрес зрителя.
Проверка
Заголовок раздела «Проверка»-
Запросите плейлист через nginx с другого компьютера:
Окно терминала curl -s http://tv.example.com/news/index.m3u8Ссылки в ответе начинаются с
http://tv.example.com/. -
Откройте канал в плеере и посмотрите страницу Сессии: в колонке IP адрес зрителя, а не адрес nginx.