7.4. Настройка интеграции с Региональным сегментом ЕБС

	Если у вас уже настроена интеграция с РС ЕБС, то перед обновлением сервера RusGuard ознакомьтесь с разделом "Обновление сервера".



Перед обновлением необходимо убедиться в том, что у вас сохранены и доступны данные для подключения (ClientID, ClientSecret и Наименование топика Kafka). При необходимости их можно получить из файла DeviceServer.dll.config. Подробнее об этом см. в разделе "Настройка интеграции с Региональным сегментом ЕБС".

	Не допускается замена файла DeviceServer.dll.config предыдущей версии RusGuard Soft: необходимо вносить изменения именно в тот файл, который был автоматически создан при установке актуальной версии RusGuard Soft.

	Если вам необходимо добавить дополнительную точку интеграции с РС ЕБС, ознакомьтесь с разделом "Добавление дополнительной точки интеграции".

Доступны два варианта интеграции RusGuard Soft с РС ЕБС:

Покупка RusGuard Soft версии Enterprise. В состав версии входит одна точка интеграции с РС ЕБС и возможность подключения к РС ЕБС до 5 камер. Есть возможность приобретения дополнительных лицензий на камеры, если необходимо увеличить их количество в рамках одного объекта.

Покупка модуля интеграции RusGuard с РС ЕБС на 2 камеры. Модуль интеграции работает в составе бесплатной версии RusGuard Soft Standard. В состав модуля входит одна точка интеграции с РС ЕБС и возможность подключения к РС ЕБС до 2 камер. В случае необходимости установки дополнительных камер требуется приобретение дополнительных экземпляров модуля интеграции, приобретение дополнительных лицензий на камеры по аналогии п.1 не возможно.

	Если в качестве камеры для распознавания лиц используется терминал RusGuard R20-Face, то необходимо произвести настройку в соответствии с разделом "Настройка терминалов R20-Face для РС ЕБС".

Перед началом работ по настройке интеграции с Региональным сегментом ЕБС (РС ЕБС) в RusGuard Soft, необходимо привести программно-аппаратные комплексы, а также сетевую архитектуру объекта в соответствие с требованиями, которые утверждены распоряжением Департамента градостроительной политики города Москвы от 27.06.2025 № 64-16-307/25/22 «Об утверждении Порядка функционирования и установки биометрических систем контроля и управления доступом на контрольно-пропускных пунктах строительных площадок и Технических требований к биометрическим системам контроля и управления доступом, устанавливаемых на контрольно-пропускных пунктах строительных площадок» (далее – Документ). Ознакомиться с Документом.

После успешного прохождения всех описанных в Документе процедур заказчик получает от уполномоченных госорганов следующие данные:

Адрес API;
Адрес сервиса авторизации;
Адрес сервиса событий;
Логин;
Пароль;
Client_ID;
Client_Secret;
Наименование топика Kafka;

Согласованные метки доступа для каждой подключаемой камеры или терминала;

	Метки доступа задаются при подачи заявки на подключение к РС ЕБС. Метки должны быть уникальными. Для удобства администрирования рекомендуем указывать одинаковое имя камеры и ее метку доступа латинскими буквами.

Указание типа подключения протокола Kafka: с авторизацией или без авторизации. Если для объекта назначен протокол Kafka с авторизацией, то подробнее о его подключении см. в разделе "Протокол Kafka с авторизацией". Если уполномоченный госорган не выдал никаких распоряжений о типе подключения протокола Kafka, то это означает, что ваш объект будет использовать протокол Kafka без авторизации.

Только при наличии всех этих данных у администратора СКУД можно приступать к настройке интеграции с РС ЕБС в RusGuard Soft.

Откройте RusGuard Soft и перейдите в раздел "Конфигурация системы". В пункте "Биометрия" выберите "Типы карт".

Выберите тип пропуска, для которого будет доступна идентификация с использованием биометрии.

Если в качестве камеры вы используете терминал распознавания лиц, то в поле "Формат" вы можете выбрать вариант отображения ФИО сотрудника на экране терминала.

Подробнее о настройке типов карт см. в разделе "Терминалы распознавания лиц R20-Face".

Выберите пункт "Поставщики биометрии". Если у вас отсутствуют поставщики snils и kig-poly, то их необходимо добавить. Нажмите иконку с зеленым плюсом и в новом окне введите идентификатор поставщика – snils.

Аналогичным образом добавьте еще одного поставщика – kig-poly.

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

В новом окне укажите данные для подключения, которые были вам предоставлены после выполнения требований Документа. Поле "Имя" заполняется по усмотрению администратора.

	Рекомендуется в качестве адреса API, сервиса авторизации и сервиса событий указывать доменные адреса, полученные от уполномоченного госоргана, а не IP-адреса. Пример ввода значений:

Нажмите кнопку "Добавить".

В случае успешного добавления новой точки интеграции она будет иметь иконку без дополнительных знаков, а в Мониторе событий появится новое событие об установке связи с этой точкой интеграции.

Обратите внимание на значение ID, которое было автоматически присвоено точке интеграции.

Используя меню "Пуск", откройте приложение "Блокнот" от имени администратора. В приложении "Блокнот" откройте текстовый файл конфигурации DeviceServer.dll.config (расположение по-умолчанию: C:\Program Files\VVI Investment\RusGuard).

В открывшемся текстовом файле в блоке EbsIntegrations необходимо установить значения для следующих типов настроек: id, clientId, secret и topic. Необходимо подставить значения, которые вы получили после выполнения требований Документа. Используйте значение id, которое было сформировано при создании новой точки интеграции.

	В качестве разделительного знака в значении topic может использоваться только нижнее подчеркивание (например: test_topic_name).

	В случае, если для вашего объекта уполномоченным госорганом был определен протокол Kafka с авторизацией, то в значении kafkaAuth необходимо установить значение true. Подробнее см. в разделе "Протокол Kafka с авторизацией".

Сохраните изменения в файле DeviceServer.dll.config.

	Все значения, передаваемые уполномоченным госорганом заказчику, являются уникальными и не могут быть скопированы и применены на других объектах.

Используя меню "Пуск", запустите утилиту "RusGuard Агент".

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

Дождитесь его остановки (флажок напротив пункта "Сервер оборудования" должен стать желтым), после чего нажмите кнопку "Запустить".

Вернитесь в RusGuard Soft в раздел "Конфигурация оборудования" и добавьте в созданную интеграцию подключенную камеру, соответствующую требованиям Документа, используя контекстное меню.

	Если в качестве камеры вы используете терминал распознавания лиц RusGuard, то этот терминал не должен использоваться в RusGuard Soft ни в каком другом качестве (не должен быть подключен к контроллеру или добавлен напрямую через LAN).

В новом окне присвойте камере имя, при необходимости присвойте псевдоним. Укажите метку доступа, которую назначил или согласовал уполномоченный госорган для указанного в заявке RTSP-потока (подробнее см. в Документе).

При использовании IP-камеры стороннего производителя

В поле "Адрес RTSP-потока" введите адрес RTSP-потока, который вы указывали в заявке. Формат RTSP-потока зависит от производителя камеры: в нем могут указываться или нет логин и пароль, а также другие параметры потока. Уточняйте формат RTSP-потока для вашего устройства в руководстве пользователя камеры.

Если RTSP-поток передается без логина и пароля ("rtsp://[IP-addr]:[port]"), то логин и пароль для доступа к камере необходимо указать отдельно в полях ниже.

Если RTSP-поток включает в себя логин и пароль ("rtsp://[username]:[password]@[IP-addr]:[port]" или в другом формате), то указывать их в отдельных полях не нужно.



В качестве устройства для передачи RTSP-потока рекомендуется использовать терминал распознавания лиц R20-Face. Благодаря наличию экрана терминал обеспечивает понятную обратную связь: пользователь видит, что устройство работает и что он находится в зоне его видимости. Кроме того, на экране терминала отображаются текстовые сообщения об успешной или неуспешной идентификации, которые могут быть продублированы голосовым сообщением.

При использовании терминала RusGuard

	Для использования терминалов RusGuard их необходимо предварительно настроить. Подробнее об этом см. в разделе. "Настройка терминалов R20-Face для РС ЕБС".

В поле "Адрес RTSP-потока" введите полный адрес RTSP-потока, который вы указывали в заявке, в формате: "rtsp://[IP-addr]:[port]/live?channel=1&stream=0&user=[username]&password=[password]".

	Пример: rtsp://10.0.2.34:554/live?channel=1&stream=0&user=admin&password=12345678

Логин и пароль к терминалу также необходимо продублировать в отдельных полях ниже.

Нажмите кнопку "Добавить".



Указываемый вами IP-адрес RTSP-потока является локальным и может не совпадать с IP-адресом RTSP-потока, который вы указываете в заявке для вывода RTSP-потока в РС ЕБС ввиду особенностей настройки правил маршрутизации.

Указывать необходимо RTSP ссылку с локальным адресом. Это не как не влияет на взаимодействие с РС ЕБС.

	Для каждой добавляемой камеры используется своя уникальная метка доступа. Для удобства администрирования рекомендуем указывать одинаковое имя камеры и ее метку доступа латинскими буквами.

Если в качестве камеры используется терминал, то после его добавления вам будут доступны настройки вывода информации о сотруднике на экране терминала. При установленной галочке "Уведомлять о проходе" на экран терминала будет выводиться сообщение с данными сотрудника в том формате, который вы установили ранее при настройке типов карт.

При установленной галочке "Уведомлять о нераспознанном лице" терминал будет уведомлять сотрудника о том, что его лицо не обнаружено в базе. На экран будет выведено соответствующее сообщение, сопровождающееся голосовым уведомлением.

В разделе "Конфигурация оборудования" выберите контроллер, используемый на точке доступа, где будет работать распознавание по лицу. Перейдите на вкладку "Камеры". Укажите камеры на вход и на выход (опционально), которые ранее вы добавили к точке интеграции.

Если в качестве камеры используется терминал RusGuard, то необходимо перейти на вкладку "Контроллер" и в блоке "Назначение интерфейсов" установить значение для порта RS232-1 как "R20-Face на входе" и для порта RS232-2 как "R20-Face на выходе" (в случае, если у вас используется биометрическая идентификация и на выходе).

Перейдите в раздел "Конфигурация СКУД", пункт "Уровни доступа". Выберите или создайте новый уровень доступа (подробнее см. в разделе "Создание уровня доступа").

В настройках уровня доступа добавьте новую точку доступа. В качестве устройства точки доступа выберите контроллер, для которого ранее вы добавили камеры распознавания лиц. Задайте расписание (не используйте расписание по-умолчанию "Всегда").

Установите галочку напротив пункта "Многофакторная идентификация". В блоке "Идентификация" нажмите на иконку с плюсом и выберите значение "По лицу (сервер)".

Нажмите кнопку "Добавить".

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

	При необходимости добавления дополнительных точек интеграции с РС ЕБС см. раздел "Добавление дополнительной точки интеграции".

Настройка интеграции завершена. Дальнейшая работа в СКУД RusGuard совместно с РС ЕБС будет производиться оператором АРМ, подробнее об этом см. в разделе "Работа в рамках РС ЕБС".

	При первичном вводе в эксплуатацию, а также для выявления ошибок в работе интеграции, рекомендуем воспользоваться инструментом по сбору логов взаимодействия сервера RusGuard и РС ЕБС. Работа с инструментом описана в разделе "Диагностика работоспособности интеграции".