Документация BILLmanager 6

Выгрузка для СОРМ

СОРМ — это комплекс технических средств оперативно-розыскных мероприятий, предназначенных для выполнения требований законодательства в области связи.

Нормативные документы:

Модуль Выгрузка для СОРМ позволяет выгрузить необходимые данные из BILLmanager для их дальнейшей обработки. Данные выгружаются в файлы формата CSV.

Справочники, доступные для выгрузки:

  • данные клиентов;
  • данные внутренних пользователей;
  • истории авторизации;
  • данные платежей;
  • данные банковских платежей;
  • данные IP-адресов;
  • данные доменов;
  • сообщения из запросов.

Установка

Чтобы установить модуль:

  1. Обновите BILLmanager до версии 6.77 или выше.
  2. Подключитесь к серверу с платформой по SSH.
  3. Выполните:

    Ubuntu 20.04 и Astra Linux 1.7.4
    sudo apt install billmanager-plugin-sorm -y
    CentOS 7 и Alma Linux 9
    sudo yum install billmanager-plugin-sorm -y

После завершения установки модуль появится в разделе левого меню ИнструментыВыгрузка для СОРМ.

Настройка выгрузки для СОРМ

  1. Перейдите в раздел ИнструментыВыгрузка для СОРМ.
  2. Выберите Провайдеров, по которым будут выгружаться данные.
  3. Укажите один Разделитель, который будет использоваться в выходном файле для разделения полей в пределах одной строки. Например, запятая или точка с запятой.
  4. Если необходимо, активируйте опцию Использовать общую папку для всех файлов выгрузки и укажите путь к папке, куда будут выгружаться файлы. Путь по умолчанию — /usr/local/mgr5/var/sorm_reports/.
  5. Выберите справочники, которые нужно выгружать. Для выбранных справочников будет отображён дополнительный блок, в котором вы можете настроить выгрузку определенных полей справочника.
  6. Выберите поля, которые нужно выгружать в справочнике.
  7. Нажмите Ок. Настройки будут записаны в файл конфигурации /usr/local/mgr5/etc/sorm/config.json.

После сохранения настроек первая выгрузка произойдёт по времени задания cron.

Дополнительно

Модуль реализован на python и после установки расположен по пути /usr/local/mgr5/etc/sorm/sorm.py, заданные настройки записываются в файл конфигурации /usr/local/mgr5/etc/sorm/config.json.

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

Логирование

Логи взаимодействия биллинговой платформы с модулем СОРМ записываются в файлы:

  • /usr/local/mgr5/var/sorm.log — запросы во время выгрузки;
  • /usr/local/mgr5/var/billmgr.log — форма настройки.

Планировщик заданий

Выгрузка производится через скрипт sorm.py в планировщике cron. По умолчанию выгрузка выполняется один раз в сутки в 4:45 по времени сервера. При необходимости запуск скрипта можно выполнить вручную:

usr/local/mgr5 && /usr/local/mgr5/etc/sorm/sorm.py

База данных

Выгружаемые объекты фиксируются в таблицах базы данных:

  • sorm_reports_tracking — фиксируется дата последней выгрузки (записи или всей выгрузки в целом);
  • sorm_reported_values — фиксируются значения в последней выгрузке для записи.

Удаление модуля

Чтобы удалить модуль:

  1. Подключитесь к серверу с платформой по SSH.
  2. Выполните:

    Ubuntu 20.04 и Astra Linux 1.7.4
    sudo apt remove billmanager-plugin-sorm -y
    CentOS 7 и Alma Linux 9
    sudo yum remove billmanager-plugin-sorm -y

Удаление модуля не затрагивает:

  • имеющиеся файлы выгрузки;
  • файл конфигурации;
  • таблицы в базе данных.