Задать параметры в файле конфигурации модуля lbcore-tv24

После того как вы установите модуль lbcore-tv24, задайте настройки подключения к сервису.

Настроить доступ к API модуля для запросов со стороны платформы «24 часа ТВ»

  1. Настройка Nginx.

    • С отдельным поддоменом:
    server {
    	server_name 24tv.operator.ru; # operator.ru - доменное имя, 24tv произвольный поддомен
    
    	location / {
    		# если модуль lbcore-24 находится на другом сервере, необходимо указать адрес этого сервера
    		proxy_pass   http://127.0.0.1:34038;
    	}
    
    	listen 80; # Для настройки SSL обратитесь к документации Nginx
    }
    

    ``

    • С url-префиксом на основном домене:
    server {
    	# ... основные настройки сервера
    
    	location /24tv/ {
    		# если модуль lbcore-24 находится на другом сервере, необходимо указать адрес этого сервера
    		proxy_pass   http://127.0.0.1:34038/; # / в конце должен присутствовать для того, чтобы префикс /24tv обрезался
    	}
    }
    

    ``

  2. Настройки Apache. Загрузите модули proxy и proxy_http.

    $ sudo a2enmod proxy
    $ sudo a2enmod proxy_http
    

    ``

    • Настройка с отдельным поддоменом:

      <VirtualHost *:80>
      	ServerName 24tv.operator.ru; # operator.ru - доменное имя, 24tv произвольный поддомен
      
      	# если модуль lbcore-24 находится на другом сервере, необходимо указать адрес этого сервера
      	ProxyPass / http://127.0.0.1:34038
      </VirtualHost>
      
      
      
    • Настройка с url-префиксом на основном домене:

      <VirtualHost *:80>
      	# ... основные настройки сервера
      
      	# если модуль lbcore-24 находится на другом сервере, необходимо указать адрес этого сервера
      	ProxyPass /24tv http://127.0.0.1:34038
      </VirtualHost>
      
      
      

Обратите внимание: нужно сообщить представителю платформы «24 часа ТВ» настроенный адрес.

Задать параметры в файле конфигурации lbcore-tv24

Открыть файл конфигурации:

nano /etc/lanbilling/lbcore-tv24.conf

Пример конфигурации:

# Настройки доступа к LANBilling LBcore Server
[lbcore]
addr = "127.0.0.1:1502"
login = "admin"
password = ""
agent_ids = [9]
log_requests = true
tv24_uuid_prefix = "tv24:"
max_events = 10000

# Настройки доступа к API 24 часа ТВ
[tv24]
addr = "https://api.24h.tv/v2/"
auth_token = "000x0xxx0x0xx00x000x0xx0"

# Настройки сервера
[server]
addr = "0.0.0.0:34038"
allowed_addresses = ["0.0.0.0/0"]

# Настройки модуля
[options]
default_agent_id = 
default_tar_id = 
register_entities = false
allow_tar_change = true
log = ""
  • Секция [lbcore] — настройки доступа к серверу, на котором установлено ядро LANBilling.

    • addr — IP-адрес и порт сервера, на котором установлен LBcore.

    • login и password — реквизиты доступа для сотрудника, от лица которого будут выполняться запросы.

    • agent_ids — идентификаторы агентов, работающих с модулем lbcore-tv24. Модуль будет обрабатывать события только для тех учётных записей, в которых назначен агент из этого списка.

      Как узнать ID агента?
    • log_requests — логирование запросов к ядру. Чтобы включить логирование, установите значение true.

    • tv24_uuid_prefix — префикс, по которому система будет определять, что услуги относятся к платформе «24 часа ТВ». Префикс нужно будет указывать при создании услуг в каталоге LANBilling.

    • max_events — максимальный размер буфера для модуля lbcore. Определяет наибольшее число событий, обрабатываемых одновременно. Если опция не задана, используется значение по умолчанию — 10 000.

  • Секция [tv24] — настройки доступа к API платформы.

    • addr — URL сервера «24 часа ТВ» в формате <http или https>://<URL-адрес>

    • auth_token — ключ доступа к API сервиса. Должен быть сгенерирован в личном кабинете «24 часа ТВ».

      Как сгенерировать ключ доступа к API?
  • Секция [server] — настройки сервера «24 часа ТВ».

    • addr — адрес и порт, который будет принимать API-запросы от сервиса «24 часа ТВ». По умолчанию указано значение 0.0.0.0 — это значит, что система будет прослушивать все адреса. Вы можете указать вместо него другой IP-адрес в формате <хост>:<порт>.

    • allowed_addresses — сегменты сети, с которых могут быть отправлены API-запросы от сервиса «24 часа ТВ». Формат: <ip>/<маска>. Если сегментов несколько, укажите их через запятую.

  • Секция [options] — дополнительные настройки модуля.

    • Вы можете включить автоматическое создание учётных записей в биллинге. Система будет создавать их, когда абонент зарегистрируется в приложении «24 часа ТВ». Эти настройки определяют, какой агент и тариф будут назначаться по умолчанию в таких учётных записях. Убедитесь, что в системе есть нужный агент и тариф — запишите их ID.

      • default_agent_id — ID агента, который будет назначаться по умолчанию в учётной записи. Если это поле оставить пустым, будет использоваться первый агент из поля agent_ids в блоке [lbcore]. Если указать значение 0, то учётные записи не будут создаваться по запросу приложения «24 часа ТВ».

      • default_tar_id — ID тарифа, который будет назначаться по умолчанию в учётной записи. Если указать значение 0, то учётные записи не будут создаваться по запросу приложения «24 часа ТВ».

    • register_entities — возможность назначать тарифы и услуги платформы «24 часа ТВ» юридическим лицам.

    • allow_tar_change — возможность для абонентов переключаться между тарифами в приложении «24 часа ТВ».

    • log — путь к файлу журнала работы модуля. Если путь не задан, используется syslog.

Далее запустите модуль.