Интеграция с Ministra (ex Stalker)

Skip to end of metadata
Go to start of metadata
Вы просматриваете старую версию данной страницы. Смотрите текущую версию. Сравнить с текущим  |   просмотр истории страницы

Заведение оборудования

Время выполнения инструкции: до 5 минут

Для настройки IPTV нужно:

Шаг 1. Создать сервер IPTV  в разделе оборудования, вкладка IPTV

IP-адрес - любой, например 1.1.1.1
IP важен только для [Ministra]


Примечание: Стандартная схема OSS зависит от IPTV портала. В данном случае схема выбрана для TITV!

Шаг 2. На вкладке Дополнительно ставим опцию "Передавать пароль в скрипт событий"

Шаг 3. Переходим в управление  и нажимаем Сохранить где указан каталог управления. Затем В "шаг 1 Инициализация" выполняем все кнопки последовательно

Шаг 4. Переходим на вкладку Настройка и обновляем список файлов

Шаг 5. В main.ini прописываем данные для вашего IPTV

Настройка Ministra

Время выполнения инструкции: 60-120 минут, зависит от количества услуг и тарифных планов
Раньше платформа называлась Stalker Middleware и в интерфейсе Carbon Billing осталось прежнее название, тем не менее интеграция работает и с Ministra

Настройка доступа конфигурации Ministra в custom.ini

Для интеграции Ministra с Carbon Billing 5, в настройках конфигурационного файла IPTV custom.ini требуется настроить API и включить работу с тарифами.
Путь до API обязательно должен быть /stalker_portal/api/

[system]
stalker_api_url = http://localhost/stalker_portal/api/

Должны быть указаны логи и пароль:

[server_api]
enable_api = true
api_auth_login = stalkerapiuser
api_auth_password = stalkerapipassword

Интеграция со Сталкером возможна только при включении тарифов на стороне Сталкера:

[billing]
enable_subscription = false
enable_tariff_plans = true

Подробней про настройки Ministra Вы можете почитать в его документации: "Конфигурационный файл"

Ministra с IPTVPortal

Пример содержимого main.ini для Ministra:

tmplt=tmplt/main.cfg.tmplt
iptvportal_host=provider.iptvportal.ru
iptvportal_username=iptvportaladmin
iptvportal_password=adminpassword111
stalker_username=stalkeradmin
stalker_password=adminpassword2000
delete_not_existing=1
enabled="1"

iptvportal_host - Доменное имя сервиса, который предоставляет услуги. Например admin.provider.iptvportal.ru
iptvportal_username - имя пользователя на портале
iptvportal_password - пароль пользователя на портале
stalker_username - имя пользователя при использовании оборудования Ministra
stalker_password - пароль пользователя при использовании оборудования Ministra
delete_not_existing - флаг, отвечающий за удаление абонента на оборудовании, если абонента нет в биллинге (0-не удалять, 1-удалять).

После этого обязательно нужно нажать кнопку "Сохранить" сразу под полем, в которое вносились изменения.

При добавлении нового пользователя не происходит автоматического добавления его на оборудование. Это происходит в момент синхронизации биллинга с оборудованием, которая проводится раз в час при наличии галочки "Синхронизировать пользователей на этом NAS" в настройках NAS

Ministra без IPTVPortal

Пример содержимого main.ini для Ministra:

tmplt=tmplt/main.cfg.tmplt
iptvportal_host=
iptvportal_username=
iptvportal_password=
stalker_username=stalkeradmin
stalker_password=adminpassword2000
delete_not_existing=1
sync_stalker_users_by_mac=0
enabled="1"

iptvportal_host - оставьте пустым
iptvportal_username - оставьте пустым
iptvportal_password - оставьте пустым
stalker_username - имя пользователя на API Ministra
stalker_password - пароль пользователя API Ministra
delete_not_existing - флаг, отвечающий за удаление абонента в портале, если абонента нет в биллинге (0-не удалять, 1-удалять)
sync_stalker_users_by_mac - синхронизировать учетные записи iptv по mac приставки (0 - по ip, 1 - по mac)

В учетных записях IPTV необходимо заполнить поле MAC. В зависимости от выбранного метода синхронизации, она будет проходить либо по связке ip+mac, либо только по mac:

  • Синхронизация по IP

  • Синхронизация по MAC

После этого обязательно нужно нажать кнопку "Сохранить" сразу под полем, в которое вносились изменения.

Синхронизация абонентов между Carbon Billing 5 и Ministra производится по IP учетной записи интернет. При необходимости (например, если ip абонента динамический, либо учетная запись интернет отсутствует или их несколько) в main.ini можно установить опцию sync_stalker_users_by_mac=1, тогда синхронизация приставок будет проходить по mac из учетной записи iptv
При добавлении нового пользователя не происходит автоматического добавления его на оборудование. Это происходит в момент синхронизации биллинга с оборудованием, которая проводится раз в час при наличии галочки "Синхронизировать пользователей на этом NAS" в настройках NAS

Ограничение запросов к API поставщика услуг

В файле main.ini необходимо добавить параметр sync_minutes (по умолчанию значение параметра равно 60, единица измерения - 1 минута). Данный параметр задает период ожидания между синхронизациями IPTV OSS, другими словами, регулирует частоту отправки API-запросов на портал поставщика. У некоторых поставщиков услуг IPTV есть ограничение на кол-во API-запросов к их серверу. Чтобы не выходить за рамки данных ограничений, рекомендуется увеличить параметр sync_minutes таким образом, чтобы период ожидания увеличился с 60 минут до 24 часов или 7 суток. После этого необходимо перезапустить обработчик синхронизаций:

chroot /app/asr_billing
service oss restart

Настройка тарифных планов, пакетов услуг и пользователей на Ministra

  1. Добавьте ТВ-каналы



  2. Зайдите в меню "Пакеты услуг"



  3. Создайте пакеты услуг, значение поля "Внешний ID" используйте в дальнейшем при создании услуг в биллинге - именно ими реализовано управление через биллинг.



  4. Зайдите в меню "Тарифные планы"



  5. Создайте один тариф, установите опцию "По умолчанию", добавьте пакеты услуг. Все не опциональные пакеты будут подключаться абоненту автоматический, управление ими из биллинга будет невозможно.



  6. Зайдите в меню "Пользователи" и нажмите "Добавить пользователя"



  7. В форме добавления пользователя достаточно указать MAC-адреса приставки - по нему будет происходить синхронизация.



  8. Далее добавьте абоненту в биллинге услугу создания учетной записи и услуги пакетов ТВ, это описано в разделе "[Настройка услуг IPTV]"
    После настройки пользователя в биллиге, в течение 10 минут в портале Сталкер ему добавятся пакеты ТВ, обновятся логин, пароль, а так же имя пользователя.



Создание услуг IPTV

Время выполнения инструкции: от 5 минут, 1-2 минуты на каждую услугу, 1-2 минуты на создание шаблона сообщения

Для подключения сервиса IPTV абоненту, рекомендуется подключить как минимум две услуги:

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

Услуг, подключающих пакеты ТВ может быть несколько.

  • Услуга создания учётной записи должна быть в единственном экземпляре для каждого сервиса IPTV: одна для 24часаТВ, одна для Смотрёшки и тд
  • Если не делать отдельную услугу, создающую учетную запись IPTV, она все равно будет создана синхронизатором в течение 10 минут после подключения услуги с пакетом ТВ

Добавление услуги, подключающей пакеты телевидения

Создайте услугу с типом "IP телевидение" по статье документации "Услуги". Настройте в ней следующие опции:

  1. Вкладка "Основные". Опции:
    • Вид сервиса: IPTV;
    • Название: любое, соответствующее пакету TV выбранного оператора



  2. Вкладка "Дополнительно". Опции:
    • Строка с дополнительными параметрами по активации/деактивации: ID пакета телевидения, список пакетов уточните у оператора IPTV



  3. Вкладка "Личный кабинет". Опции:
    • Разрешить заказ через веб-интерфейс и Разрешить отключать через ЛК: параметры, позволяющие абоненту самостоятельно управлять подключением пакетов телевидения



Добавление услуги, создающей учетную запись на портале телевидения

Создайте услугу с типом "IP телевидение" по статье документации "Услуги". Настройте в ней следующие опции:

  1. Вкладка "Основные". Опции:
    • Вид сервиса: IPTV;
    • Название: любое,  например "Учетная запись IPTV"
    • Бесплатный пакет IPTV: необходимая опция для работы услуги создания учетной записи:
      • в схеме LifeStream услуги с этой опцией не синхронизируются как пакеты IPTV
      • в схеме MEGOGO услуги с опцией не отображаются как возможные для заказа на промо-странице



  2. Вкладка "Дополнительно".
    • Строка с дополнительными параметрами по активации/деактивации: оставьте пустыми;
    • NAS: выберите NAS соответствующего IPTV сервиса
    • Создавать учетную запись при подключении: включите;
    • Количество учетных записей: в зависимости от специфики работы Вашего IPTV, минимум одна;
    • Использовать цифровой пароль при создании учетной записи: включении этой опции не обязательно, но может быть полезно для сервисов настраиваемых на ТВ-приставках


  3. Вкладка "Личный кабинет". Опции:
    • Разрешить заказ через веб-интерфейс: включите, чтобы абонент сам мог создать себе учетную запись;
    • Разрешить отключать через ЛК: отключите, чтобы  абонент случайно не создал себе множество учетных записей



Отправка сообщения абоненту о создании учетной записи

Создайте шаблон с типом сообщения "Создание учетной записи из услуги" по статье "Система отправки сообщений" как показано на изображении ниже:

Для передачи логина и пароля новой учетной записи, используйте переменные user_login и user_psw. Например:
Реквизиты учетной записи: логин %(user_login)s, пароль %(user_psw)s. Используйте их для идентификации в портале IPTV

В настройках шаблона сообщений должна быть отключена опция "Использовать шаблонизатор django"


Если несколько сервисов телевидения, как правильно настроить?

Если в биллинг интегрировано более 1 сервиса IPTV одновременно (например, Lifestream + IPTVPortal) - смс будет отправляться по любому событию создания учетной записи.
В этом случае абонент может получить логин и пароль от второго сервиса.

Как решить

  1. Добавьте в личном кабинете страницу с данными доступа к IPTV
  2. В СМС отправляйте текст общего характера, например: "Реквизиты учетной записи IPTV находятся в личном кабинете".
Введите метки, чтобы добавить к этой странице:
Please wait 
Ищите метку? просто начните печатать.