Медиа.маги Документация
On this page

Last updated

Создать

Обзор

Используйте Создать, чтобы задать новую политику привязки к аудитории: озаглавьте её, выберите точку присутствия, прикрепите origin- и live-каналы и при необходимости ограничьте доступ белым списком сетевых адресов.

Как сюда попасть

Боковое меню → Дистрибуция → Дистрибуция → Создать, либо нажмите Добавить дистрибуцию вверху списка дистрибуций.

Что здесь можно делать

Добавить дистрибуцию

Назначение. Привязать подобранный набор каналов к точке присутствия и при необходимости ограничить, кто может их тянуть, чтобы внешняя аудитория или партнёр потребляли результат платформы, не видя полный каталог.

  1. Нажмите + Добавить дистрибуцию в правой части панели инструментов или выберите Дистрибуция → Создать в боковом меню. Откроется форма Новая дистрибуция.
  2. Введите Название — минимум три символа. Это метка в списке и в шапке страницы; называйте по аудитории или партнёру (Публичный OTT — <регион>, Партнёр — <имя>, Внутренний — <назначение>), чтобы строка читалась с первого взгляда.
  3. Откройте PoP и выберите точку присутствия, которая будет раздавать эту дистрибуцию. В списке — все точки присутствия, заведённые на учётной записи; выбранная граничная точка — это место, куда подключаются потребители, поэтому выбирайте ближайшую к аудитории или названную в партнёрском контракте.
  4. Добавьте каналы, которые эта аудитория должна видеть, — см. Привязать каналы к дистрибуции.
  5. При необходимости ограничьте доступ по сетевому адресу — см. Ограничить доступ белым списком.
  6. Нажмите Создать. Кнопка неактивна, пока форма недействительна; как минимум требуются название и хотя бы один канал.

Используйте это, когда:

  • поднимаете партнёрскую точку забора к началу контракта — одна дистрибуция на партнёра с контрактным белым списком;
  • публикуете публичный OTT-набор прямых каналов через ближайшую к аудитории граничную точку;
  • собираете отказоустойчивую дистрибуцию на вторичной точке присутствия, зеркалящую список каналов основной, на случай вывода основной граничной точки на обслуживание.

Результат: новая строка в таблице дистрибуций; внешние потребители смогут тянуть каждый привязанный канал по адресу distrib.mediamagi.ru/d/<id>/ после распространения изменений белого списка.

Привязать каналы к дистрибуции

Назначение. Решить, какие потоки раскрывает дистрибуция. Два семейства делят один и тот же многострочный паттерн, но берут данные из разных каталогов.

Origin-каналы

Origin-каналы — это файловые или VOD-потоки, произведённые конвейерами транскодирования платформы.

  1. Нажмите + Добавить канал под Origin-каналами. Появится строка с списком выбора канала, переключателем CORS и значком удаления.
  2. Откройте список и выберите origin-канал для раскрытия.
  3. Включите CORS, если итоговый поток блокируется политикой CORS в плеере потребителя — подсказка над строкой объясняет назначение. Иначе оставьте выключенным.
  4. Нажимайте + Добавить канал для каждого следующего потока.
  5. Нажмите значок удаления на строке, чтобы убрать её.

Live-каналы

Live-каналы — это непрерывные потоки, производимые разделом Каналы. Их выбирают из диалога, а не из однострочного списка, чтобы можно было выбрать сразу несколько.

  1. Нажмите + Добавить каналы под Live-каналами. Откроется выбор Каналы прямого эфира.
  2. Введите запрос в Поиск, чтобы сузить список по имени, или откройте фильтр меток, чтобы оставить только каналы с нужным ярлыком.
  3. Отметьте флажок слева от каждого канала, чтобы включить его.
  4. Нажмите Добавить для подтверждения; диалог закроется, и каждый выбранный канал станет строкой под Live-каналами в форме.
  5. Уберите канал, нажав значок удаления на его строке в форме.

Используйте это, когда:

  • собираете набор, смешивающий VOD-origin (например, запись архива) с одним или несколькими прямыми потоками;
  • поднимаете дистрибуцию только из прямых каналов, которая тянет несколько live-каналов одного шаблона в одну граничную точку для аудитории;
  • добавляете новый канал в существующий набор, не трогая остальную часть дистрибуции, — см. Отредактировать или удалить дистрибуцию.

Ограничить доступ белым списком

Назначение. Разрешить тянуть из этой дистрибуции только перечисленным сетевым адресам. Дистрибуция без записей в белом списке открыта любому клиенту, который может достичь точки присутствия.

  1. Нажмите + Добавить адрес под Белым списком. Откроется диалог Добавить адрес.
  2. Выберите IP-адрес для одного хоста или Подсеть для диапазона CIDR. IP-адрес фиксирует поле Маска на /32; Подсеть разблокирует его, чтобы можно было задать любую длину префикса IPv4.
  3. Введите IPv4-адрес. Для Подсети адрес должен быть сетевым (хостовые биты обнулены под выбранную маску).
  4. Задайте Маску — длину префикса, когда выбрана Подсеть.
  5. Нажмите Добавить. Кнопка неактивна, пока адрес не разбирается. Диалог закроется, и запись появится строкой под разделом Белый список в нотации CIDR.
  6. Нажмите значок удаления на строке, чтобы убрать запись.

Изменения белого списка могут распространяться до граничной точки до одного часа — подсказка над разделом прямо об этом говорит. Планируйте партнёрские переключения с учётом этого окна.

Используйте это, когда:

  • партнёр тянет с одного фиксированного пирингового IP — добавьте один хост /32;
  • партнёрский CDN забирает из диапазона — добавьте подсеть /24 или /16 на каждый регион, который объявляет CDN;
  • только внутренние дистрибуции остаются в корпоративном префиксе — добавьте офисную подсеть (подсети) и ничего больше.

Шаблоны белого списка

  • Однопользовательская граничная точка — один /32. Партнёр пирингуется на одном IP, и больше никто не тянет.
  • Партнёрский CDN по регионам — несколько подсетей /24, по одной на регион, который объявляет CDN. Сочетайте с устойчивым названием, чтобы журнал действий называл партнёра.
  • Открытый доступ — без записей в белом списке. Используйте для публичных OTT-аудиторий, чей доступ контролируется подписью токенов, DRM или геофенсингом дальше по цепочке; сама дистрибуция их не навязывает.

Белый список — один слой контроля доступа. Он ограничивает кто может достичь байтов на граничной точке; что с этими байтами можно делать после забора — отдельный вопрос, решаемый плеером, провайдером DRM или партнёрским контрактом.

Связанные страницы

Медиа.маги Документация