- Заведение оборудования
- Настройка Ministra
- Настройка доступа конфигурации Ministra в custom.ini
- Ministra с IPTVPortal
- Ministra без IPTVPortal
- Ограничение запросов к API поставщика услуг
- Настройка тарифных планов, пакетов услуг и пользователей на Ministra
- Создание услуг IPTV
- Добавление услуги, подключающей пакеты телевидения
- Добавление услуги, создающей учетную запись на портале телевидения
- Отправка сообщения абоненту о создании учетной записи
Заведение оборудования
Время выполнения инструкции: до 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
- Добавьте ТВ-каналы
- Зайдите в меню "Пакеты услуг"
- Создайте пакеты услуг, значение поля "Внешний ID" используйте в дальнейшем при создании услуг в биллинге - именно ими реализовано управление через биллинг.
- Зайдите в меню "Тарифные планы"
- Создайте один тариф, установите опцию "По умолчанию", добавьте пакеты услуг. Все не опциональные пакеты будут подключаться абоненту автоматический, управление ими из биллинга будет невозможно.
- Зайдите в меню "Пользователи" и нажмите "Добавить пользователя"
- В форме добавления пользователя достаточно указать MAC-адреса приставки - по нему будет происходить синхронизация.
- Далее добавьте абоненту в биллинге услугу создания учетной записи и услуги пакетов ТВ, это описано в разделе "[Настройка услуг IPTV]"
После настройки пользователя в биллиге, в течение 10 минут в портале Сталкер ему добавятся пакеты ТВ, обновятся логин, пароль, а так же имя пользователя.
Создание услуг IPTV
Время выполнения инструкции: от 5 минут, 1-2 минуты на каждую услугу, 1-2 минуты на создание шаблона сообщения |
Для подключения сервиса IPTV абоненту, рекомендуется подключить как минимум две услуги:
- Первая: создание учетной записи
В настройках услуги создания учётной записи для сервиса LifeStream нужно указать буквенный префикс логина для исключения возможного совпадения логинов в системе LifeStream. - Вторая: подключение пакетов телевидения
Услуг, подключающих пакеты ТВ может быть несколько.
|
Добавление услуги, подключающей пакеты телевидения
Создайте услугу с типом "IP телевидение" по статье документации "Услуги". Настройте в ней следующие опции:
- Вкладка "Основные". Опции:
- Вид сервиса: IPTV;
- Название: любое, соответствующее пакету TV выбранного оператора
- Вкладка "Дополнительно". Опции:
- Строка с дополнительными параметрами по активации/деактивации: ID пакета телевидения, список пакетов уточните у оператора IPTV
- Строка с дополнительными параметрами по активации/деактивации: ID пакета телевидения, список пакетов уточните у оператора IPTV
- Вкладка "Личный кабинет". Опции:
- Разрешить заказ через веб-интерфейс и Разрешить отключать через ЛК: параметры, позволяющие абоненту самостоятельно управлять подключением пакетов телевидения
- Разрешить заказ через веб-интерфейс и Разрешить отключать через ЛК: параметры, позволяющие абоненту самостоятельно управлять подключением пакетов телевидения
Добавление услуги, создающей учетную запись на портале телевидения
Создайте услугу с типом "IP телевидение" по статье документации "Услуги". Настройте в ней следующие опции:
- Вкладка "Основные". Опции:
- Вид сервиса: IPTV;
- Название: любое, например "Учетная запись IPTV"
- Бесплатный пакет IPTV: необходимая опция для работы услуги создания учетной записи:
- в схеме LifeStream услуги с этой опцией не синхронизируются как пакеты IPTV
- в схеме MEGOGO услуги с опцией не отображаются как возможные для заказа на промо-странице
- Вкладка "Дополнительно".
- Строка с дополнительными параметрами по активации/деактивации: оставьте пустыми;
- NAS: выберите NAS соответствующего IPTV сервиса
- Создавать учетную запись при подключении: включите;
- Количество учетных записей: в зависимости от специфики работы Вашего IPTV, минимум одна;
- Использовать цифровой пароль при создании учетной записи: включении этой опции не обязательно, но может быть полезно для сервисов настраиваемых на ТВ-приставках
- Вкладка "Личный кабинет". Опции:
- Разрешить заказ через веб-интерфейс: включите, чтобы абонент сам мог создать себе учетную запись;
- Разрешить отключать через ЛК: отключите, чтобы абонент случайно не создал себе множество учетных записей
Отправка сообщения абоненту о создании учетной записи
Создайте шаблон с типом сообщения "Создание учетной записи из услуги" по статье "Система отправки сообщений" как показано на изображении ниже:
Для передачи логина и пароля новой учетной записи, используйте переменные user_login и user_psw. Например:
Реквизиты учетной записи: логин %(user_login)s, пароль %(user_psw)s. Используйте их для идентификации в портале IPTV |
В настройках шаблона сообщений должна быть отключена опция "Использовать шаблонизатор django" |
Если несколько сервисов телевидения, как правильно настроить?
Если в биллинг интегрировано более 1 сервиса IPTV одновременно (например, Lifestream + IPTVPortal) - смс будет отправляться по любому событию создания учетной записи.
В этом случае абонент может получить логин и пароль от второго сервиса.
Как решить
- Добавьте в личном кабинете страницу с данными доступа к IPTV
- В СМС отправляйте текст общего характера, например: "Реквизиты учетной записи IPTV находятся в личном кабинете".