Управление номерной емкостью оператора

При каждом изменении номерной емкости оператора, необходимо:
вносить изменение в локальный список /home/uvr/setup/SETUP-full.csv
и выполнять выгрузку измененённой номерной ёмкости на SFTP ЦСУ Антифрод.

Изменение конфигурации УВР

Файл /home/ipats/config/proconf.txt, использует список нумерации своего оператора.

На основании этих данных УВр определяет тип вызова - исходящий или входящий, и проводит уведомление ИС Антифрод или верификацию вызова.
Некорректная информация в этой таблице может привести к пропуску фродового вызова, т.к. верификация не будет проведена.

Убедитесь, что в файле /home/ipats/config/proconf.txt настроен импорт из файла ‘/home/uvr/setup/SETUP-full.csv’

# Сначала задаётся наша нумрация
CONF NEW   tb_local TABLE 1 31 NOT
import tb_local /home/uvr/setup/SETUP-full.csv

При изменении списка нумерации в файле SETUP-full.csv, необходимо дать команду для применения изменений в файле proconf.txt:

sudo /home/ipats/terminal-manager.sh
uppro

Загрузка номерной емкости на ЦСУ

Формат файла описан в документе 1137847334745.63.11.1.2023.1.001.ПВ.01_Протокол-взаимодействия-ЦУ-УВр, смотр. п.4.5.1 в личном кабинете РКН. (текущая версия Протокол-ЦУ-УВР-v18.15.pdf).

Для упрощения выгрузки можно использовать готовый скрипт 0-update-setup-sftp-full.sh (см. ниже).

Файл идентичен по формату /home/uvr/setup/SETUP-testing.csv.

Для выгрузки необходимо создать или изменить файл /home/uvr/setup/SETUP-full.csv, используя следующий формат:

CODE;RANGE_START;RANGE_END;UVR_TYPE
ABC;START1;END1;1
ABC;START2;END2;1
ABC;START3;END3;1
ABC;START4;END4;1

Подставьте вместо ABC/START/END ваши номера или интервалы. Пример:

CODE;RANGE_START;RANGE_END;UVR_TYPE
495;1111111;1111111;1
495;1222000;1222999;1
495;2000022;2000033;1
495;1231235;1231235;1

Требования, предъявляемые к файлу SETUP-full.csv:

Если файл не примется ИС Антфрод, текущая ёмкость может удалиться из справочников и начнутся большие проблемы с повторным её добавлением.

Выгрузить емкость в ИС Антифрод, запустив скрипт:

cd /home/uvr
sudo ./0-update-setup-sftp-full.sh

Скрипт решает все вопросы связанные с выгрузкой файла нумерации:

Проблема при выгрузке номерной ёмкости в ГРЧЦ и её решение

При выгрузке ‘в лоб’ очередной версии номерной ёмкости
из БД исчезают те номера, которые уже были выгружены ранее (например, три тестовых номера),
несмотря на то, что эти номера включены в новый выгружаемый файл.

Эту ‘особенность’ в ГРЧЦ планируют устранить со временем.
Чтобы сейчас обойти эту проблему, обязательно соблюдайте такую последовательность действий:

  1. Выгрузить пустую ёмкость, см. ниже команду.
  2. Подождать одну ночь (или минимум 5 часов).
  3. Убедиться, что ранее выгруженные номера удалены из БД (не пробиваются командой CONF CMD afr NUMINFO)
  4. Выгрузить полную номерную ёмкость.

Для выгрузки пустой ёмкости не нужно редактировать SETUP-full.csv.
Вместо этого выполните команды:

cd /home/uvr
sudo ./0-update-setup-sftp-empty.sh

Официальные рекомендации подготовки файла распространяемые ГРЧЦ

Требуется максимально избегать:

  1. Не нужно выгружать емкость оператора, до того как сформирован новый полный файл numbers, если об этом явно не попросила поддержка системы.
  2. Нельзя переименовывать файл прямо на SFTP. При необходимости нужно выгружать файл локально, переименовывать и потом заново загружать на SFTP.
  3. Не нужно удалять старые файлы с SFTP.
  4. Недопустимы пересечения диапазонов внутри одного файла.

Нужно:

  1. Внимательно читать протокол ЦСУ УВР (размещен на портале Роскомнадзора).
  2. При необходимости полностью удалить номерную емкость нужно выложить пустой файл. Дождаться выгрузки полного файла numbers. Только после этого загрузить полный файл setup.
  3. При необходимости догрузить емкость, требуется выложить полный файл setup, содержащий всю требуемую емкость.

Типичные ошибки:

  1. Пересечение диапазонов внутри файла setup.
  2. Переназначение номера на другой УВр без удаления его на старом УВр.

Проверка наличия номерной емкости в справочниках ЦСУ

Справочники ЦСУ обновляются каждые 4 часа. Таким образом, появление новой нумерации в системе можно ожидать в период от 4 до 8 часов.

Обязательно надо проконтролировать, что нумерация выгрузилась и применилась в справочниках ЦСУ.
Для этого, выборочно, из разных диапазонов выгружаемого файла SETUP, провести проверку привязки номера к УВР.
При изменении состава нумерации - проводить проверку для новых и удаленных номеров.

Полные исходные данные справочников нумерации находятся в файлах NUM_*.zip или DELTA_*.zip на SFTP сервере.
Копия файлов с SFTP ЦСУ хранится локально на диске в каталоге /home/uvr/numbers.
Формат файлов описан в документе 1137847334745.63.11.1.2023.1.001.ПВ.01_Протокол-взаимодействия-ЦУ-УВр, смотр. п.4.5.1 в личном кабинете РКН. (текущая версия Протокол-ЦУ-УВР-v18.15.pdf).
При желании, в этих файлах вручную можно найти соответствие телефонного номера к УВР.

В АПК Астарта-Антифрод встроена функция выборочного запроса информации принадлежности номера УВР.

В терминале управления

sudo /home/ipats/terminal-manager.sh

Ввести команду:

CONF CMD afr NUMINFO <number>

где <number> - номер для которого требуется запросить информацию.

Пример:

CONF CMD afr NUMINFO 79541071024
11:22:51 AFRControl-afr. Number info:
11:22:51   number         : 79541071024
11:22:51   uvrIdPrimary   : 78
11:22:51   uvrIdSecondary : 0
11:22:51 --

Запись uvrIdPrimary : 78 - означает, что номер 79541071024 привязан к УВР 78.

Пример:

CONF CMD afr NUMINFO 78123082580
11:25:06 AFRControl-afr. Number info: 
11:25:06   number         : 78123092580
11:25:06   uvrIdPrimary   : 0
11:25:06   uvrIdSecondary : 0
11:25:06 --

Запись uvrIdPrimary : 0 - означает, что номер 78123092580 не привязан ни к какому УВР.