Подписчики¶

Подписчик — это абонент витрины: кто он, на какие пакеты подписан и какие каналы ему в итоге доступны.

Заведите подписчика¶

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

Карточка подписчика¶

Вкладка Настройки:

• Имя, Email, Телефон — витринные поля.
• Язык — язык абонента.
• Токен плейбека — уникальный токен, который Catena генерирует при создании подписчика. Это идентификатор абонента для вашей интеграции: по нему витрина узнаёт, чей запрос обслуживает. Им же собираются ссылки на плейлист и XMLTV.

Параллельная правка той же записи отклоняется сообщением Запись изменил кто-то другой — перезагрузите и повторите.

Учётная запись кабинета¶

Блок Учётная запись кабинета — то, с чем абонент входит в витрину сам:

• Логин — без него учётку не сохранить: под ним подписчик и входит.
• Пароль — не короче восьми символов. Пустое поле оставляет прежний пароль: сервер его не отдаёт и показать не может.

Смена пароля не отключает уже вошедшие устройства: пароль защищает вход, а не выданные токены. Чтобы отрезать устройство, его отзывают — в блоке ниже.

Устройства¶

Блок Устройства — с чего абонент смотрит прямо сейчас. У каждой строки — имя устройства, время последнего обращения и кнопка Отозвать: отозванное устройство перестаёт показывать сразу и при следующем запросе получает предложение войти заново.

Отозвать все гасит сразу весь список. Это ответ на «телевизор украли, а какой он в списке — не знаю»: войти заново абонент сможет паролем или кодом.

Те же устройства абонент видит и отзывает сам, в своём кабинете. Консоль нужна там, где он этого сделать не может.

Привязка устройства¶

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

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

Штатный путь другой: код подтверждает сам абонент в своём кабинете, и оператор в этой петле не участвует.

Подписки и доступные каналы¶

Блок Подписки — пакеты, на которые подписан этот абонент. Блок Доступные каналы показывает результат: что абонент в итоге видит.

Формула доступа простая:

• доступные абоненту пакеты = его подписки плюс все пакеты с флагом Бесплатный;
• канал доступен, если входит хотя бы в один из этих пакетов.

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

Удаление подписчика снимает его подписки каскадом.

Чего абонентский сервис не делает¶

Токен плейбека — не пропуск к плейбэку. Абонентский сервис ведёт каталог и права, но сам по себе никого к стриму не допускает и ничего не запрещает: воспроизведение по-прежнему защищает Auth & DRM, а допуск зрителя выдаётся билетом Catena или вашим бэкендом авторизации.

Штатная связка выглядит так: витрина по токену находит абонента, спрашивает у Catena список его доступных каналов, и на разрешённый канал выписывает зрителю билет. Список каналов абонента доступен по API — ресурс /catena/api-v1/subscribers/{id}/channels.

Штатной витрине отдельная интеграция для этого не нужна: она проходит эту связку сама и отдаёт зрителю уже готовые адреса.

Журнал операций¶

Вкладка Операции: subscriber_create, subscriber_update, subscriber_delete, а также subscribe и unsubscribe — выдача и снятие подписки, subscriber_credentials — правка учётной записи, device_link и device_revoke — появление и отзыв устройства. Как и везде в абонентском сервисе, запись в журнал идёт в одной транзакции с изменением, и ретенции у журнала нет.

Что дальше¶

• Пакеты — то, на что выдаётся подписка, и потолок экранов.
• Витрина — приложение, в которое абонент входит этой учётной записью.
• Плейлист и XMLTV — те же каналы для стороннего плеера.
• Билеты Catena — как превратить право абонента в допуск к воспроизведению.