СКУД Sigur#
СКУД синхронизирует сотрудников со списком в Биометрической системе и слушает события, на основе которых решает открывать или не открывать турникет. Данные события генерируются в VL Access пайплайном SendToSigur. Используемый протокол: HTTP.
- Поддерживает версию СКУД Sigur: 1.6.3.18.s.
Поддерживаемые варианты интеграции СКУД Sigur#
Программные интеграции c ПО СКУД Sigur реализованы для взаимодействия:
- с LP5 и КБС для прохода распознанных лиц через турникет/дверь с магнитным замком.
- с LUNA CARS для обеспечения контроля доступа транспортных средств при проезде через преграждающие устройства.
Устройство детекции лиц генерирует событие, Access передает событие в LP5 на распознавание, LP5 обрабатывает событие и возвращает результат в Access для дальнейшей обработки.
Перенос данных пользователей из СКУД в LP5 происходит с помощью двух механизмов:
- репликация - механизм первоначального переноса данных пользователей;
- синхронизация - механизм периодичного переноса данных пользователей при изменении состава/данных пользователей.
Настройку синхронизации/репликации см. в настройках сервисов.
Если терминал не имеет средств вывода данных (например, экрана), пайплайн SendToDevice не требуется.
Варианты интеграции с LP5#
В каждой интеграции c LP5 (Таблица 59) используется сервис Luna.
Таблица 59. Варианты интеграции c LP5
Варианты интеграции с КБС#
В каждой интеграции c КБС (Таблица 60) используется сервис КБС.
Таблица 60. Варианты интеграции с КБС
Варианты интеграции с LUNA CARS#
В каждой интеграции c СКУД ТС (Таблица 61) используется сервис LunaCars.
СКУД ТС - Система контроля доступа на территорию автотранспорта с помощью шлагбаума.
LUNA CARS передает события детекций ТС в Access для дальнейшей обработки.
Подключение камер происходит через LUNA CARS.
Таблица 61. Варианты интеграции СКУД ТС
| Дополнительный сервис | Пайплайн |
|---|---|
| Sigur | SendCarsToSigur |
| Sigur + LaurentController | SendCarsToLaurent |
Стандартные интеграции с использованием СКУД Sigur#
1․ Схема интеграции Sigur для прохода распознанных лиц через турникет/дверь с магнитным замком. При интеграции с Sigur используются стандартные компоненты Access (Рисунок 94) и (Таблица 62).
Таблица 62. Описание интеграции
| Компонент | Описание |
|---|---|
| 1ф | |
| Человек | Персона, желающая пройти через точку прохода. |
| Точка прохода | Набор компонентов, используемых для контроля доступа человека. Точек прохода может быть подключено более одной, ограничивается лицензией на СКУД. Точка прохода может использовать как на вход, так и на выход. Для каждого направления используется свой считыватель и источник видеоданных. |
| Считыватель | Устройство для приема данных карты доступа. |
| Контроллер | Плата управления точкой прохода. |
| Турникет | Преграждающее устройство для разграничения доступов |
| СКУД Sigur | Центральное ПО для работы с Sigur. Хранит данные сотрудников и принимает решение о предоставлении доступа. |
| Сервис Sigur | Компонент Access для обработки информации от СКУД. |
| Надстройка для 2ф | |
| Источник видеоданных | Устройство для извлечения кадра лица человека. Может быть как биометрический терминал (LUNA FAST 4A1 и другие), либо камера, подключенная через FaceStream. |
| Устройство ... | Компонент Access для получения данных от источника видеоданных. Выбирается исходя из используемого устройства. |
| Работа с LP5 и КБС | |
| Пайплайн MatchByPhoto | Компонент Access для взаимодействия с БС |
| Пайплайн SendToController | Компонент Access для взаимодействия с КБС |
| Пайплайн SendToDevice | Компонент Access для отправки сигнала на открытие реле в устройство и вывода текста на экран |
2․ Схема интеграции Sigur для обеспечения контроля доступа транспортных средств при проезде через преграждающие устройства. При интеграции с Sigur используются стандартные компоненты Access (Рисунок 95) и (Таблица 63).
Таблица 63. Описание интеграции
| Компонент | Описание |
|---|---|
| Транспортное средство (ТС) | Автомобиль, желающий проехать через точку проезда. |
| Точка проезда | Набор компонентов, используемых для контроля доступа ТС. Точек прохода может быть подключено более одной, ограничивается лицензией на СКУД. Точка прохода может использовать как на вход, так и на выход. Для каждого направления используется свой источник видеоданных. |
| Контроллер | Плата управления точкой проезда. |
| Шлагбаум | Преграждающее устройство для разграничения доступов |
| СКУД Sigur | Центральное ПО для работы с Sigur. Хранит данные ТС и принимает решение о предоставлении доступа. |
| Сервис Sigur | Компонент Access для обработки информации от СКУД. |
| Источник видеоданных | Устройство для извлечения кадра Государственного регистрационного знака ТС. |
| Устройство ... | Компонент Access для получения данных от источника видеоданных. Выбирается исходя из используемого устройства. |
| Работа с LUNA CARS | |
| Пайплайн SendCarsToSigur | Компонент Access для отправки событий из LUNA CARS в Sigur. Access подключается к LUNA CARS Analytics backend с помощью websocket |
| Сервис LunaCars | Компонент Access для программно-аппаратной интеграции, необходимый для связи LUNA CARS и преграждающих устройств |
Настройка ПО СКУД Sigur#
Для запуска и настройки ПО СКУД Sigur необходимо выполнить следующие действия:
1․ Убедиться, что используется ПО СКУД Sigur версии 1.6.3.18.s или новее:
- В меню программы управления Sigur выбрать пункт меню «Справка» → «О программе».
- Сверить версию ПО с указанной на сайте www.sigur.com.
- При необходимости обновить ПО до последней версии.
2․ Настроить взаимодействие между модулем интеграции и сервером ПО СКУД «Sigur»:
- В меню программы управления Sigur выбрать пункт меню «Файл» → «Настройки».
- В диалоге «Редактирование настроек» перейти к пункту «Видеонаблюдение» (Рисунок 96).
- Добавить сервер видеонаблюдения (Рисунок 97).
- Указать произвольное имя сервера.
- Тип сервера — «Пользовательская система».
- Нажать «Ок»;
3․ Настроить параметры сервера (Рисунок 98):
- «Адрес сервера» и «Порт сервера (НТТР)» — используются при обращении к серверу со стороны СКУД по протоколу HTTP;
- «Адрес сервера» соответствует IP адресу машины, на которой запущен Access;
- «Порт сервера (НТТР)» — порт для интеграционного модуля (значение по умолчанию «9091», если порт уже используется — изменить);
- «Путь к сервису» задает общий префикс путей на сервере для всех запросов от СКУД. Данное значение следует взять из блока информации компонента Sigur в Access, значение поля webhook-url (Рисунок 99).
- Активировать флаг «Выгружать на серверов фотографии» при использовании сервиса Sigur, отключить при использовании сервиса SigurThroughDatabase.
- Активировать флаг «Получать с сервера события».
4․ Включить функцию распознавания лиц:
- В диалоге «Редактирование настроек» перейти к пункту «Распознавание лиц».
- Установить галочку в пункте «Включить распознавание лиц» (Рисунок 100).
Настройка точек доступа в Sigur#
При возникновении ошибок перезапустите сервер ПО СКУД Sigur, чтобы он смог подключиться к интеграционному модулю.
Для настройки точек доступа в Sigur необходимо выполнить следующие действия:
1․ В боковом меню программы управления Sigur выбрать пункт «Оборудование» (Рисунок 101).
2․ Выбрать требуемую точку доступа и настроить для неё параметры видеонаблюдения (Рисунок 102):
- «Система» — выбрать название созданной пользовательской системы;
- «Камера» — выбрать камеру. При нажатии на выпадающий список в нём должны отобразиться названия всех устройств, созданных в Access, это говорит о том, что интеграция работает исправно и Sigur удалось подключиться к Access. Выбрать устройство, которое используется для идентификации нужной точки доступа;
- Активировать флаги «Разрешить верификацию по лицу» и «Включить идентификацию по лицу»;
- Нажать кнопку «Применить».
После этого, должна начаться репликация сотрудников со стороны Sigur. Описание работы алгоритма репликации см. в разделе Диаграмма взаимодействия СКУД Sigur с LUNA Access.
Настройка режимов доступа в ПО СКУД Sigur#
В СКУД реализовано два режима идентификации в выбранном направлении:
- Режим 1ф - по факту распознавания лица объекта доступа
- Режим 2ф - по основному идентификационному признаку (карта) и по лицу объекта доступа
Для настройки ПО выполните следующие действия:
1․ В программе управления Sigur в боковом меню «Оборудование» выберете необходимую точку доступа и перейдите в настройки видеонаблюдения (Рисунок 103):
Для включения режима 1ф: активируйте флаг «Включить идентификацию по лицу».
Для включения режима 2ф: активируйте флаг «Разрешить верификацию по лицу».
2․ Перейдите на вкладку «Режимы» и, создав новый или выбрав нужный из уже существующих, перейти на вкладку «Специальные правила» (Рисунок 104):
Для работы в режиме 1ф: Если в каком-либо из направлений должен осуществляться доступ только по факту распознавания лиц, то для параметров «Идентификация лица при проходе «на вход/выход» установите значение "Включена".
Для работы в режиме 2ф: Если в каком-либо из направлений должен осуществляться доступ по факту предъявления основного идентификатора сотрудника и факта распознавания его лица, то для параметров «Верификация лица при проходе «на вход/выход» установите одно из следующих значений:
- Мягкая — пропускать в любом случае. После идентификации по основном признаку (поднесение карты) система предоставляет допуск, если он возможен по иным критериям, даже если человек в кадре так и не появился. Такое разрешение доступа будет сопровождаться событием «Лицо не опознано».
- Жёсткая — пропускать только при совпадении. После идентификации по основном признаку (поднесение карты) система проверяет, узнавалось ли лицо данного человека в кадре в течение указанного в настройках времени до события, и если нет, ждет появления человека в кадре в течение 5 секунд. Если человек в кадре так и не появился, доступ не предоставляется. На вкладке «Наблюдение» в ПО выводится событие: «Доступ запрещен. Лицо не опознано».
- Жёсткая групповая — пропускать только при совпадении с лицом из отдела. После идентификации по основном признаку (поднесение карты) система проверяет, узнавалось ли лицо человека в кадре в течение указанного в настройках времени до события, и если нет, ждет появления человека в кадре в течение 5 секунд. Обнаруженное лицо проверяется на соответствие любому из лиц, находящихся в том же отделе, что и идентифицированный объект. Если человек в кадре так и не появился, доступ не предоставляется. На вкладке «Наблюдение» в ПО выводится событие: «Доступ запрещен. Лицо не опознано».
- Мягкая групповая — пропускать при несовпадении с лицом из отдела. После идентификации по основном признаку система предоставляет допуск, если он возможен по иным критериям, даже если лицо идентифицированного или любого другого субъекта того же отдела так и не появилось. Такое разрешение доступа будет сопровождаться событием «Лицо не опознано».
Методы взаимодействия с Sigur#
Для обмена данными с СКУД используется API (Таблица 64).
Таблица 64. Используемые методы СКУД Sigur
| Метод | Описание |
|---|---|
| GET /event | Получение событий детекции. Однонаправленное стрим соединение, в котором Access транслирует возникающие события детекций для СКУДа. |
| GET /getpersons | Получить список сотрудников из Access. На основе ответа этого запроса, СКУД принимает решение о дальнейшем добавлении/обновлении/удалении сотрудников в Access |
| POST /updateprson | Обновить данные сотрудника в Access |
| GET /removeperson | Удалить данные сотрудника в Access |
| GET /getchannels | Получить список источников событий в Access, используется для конфигурации направлений прохода |
Диаграмма процессов взаимодействия с Sigur#
Access выступает в роли сервера, а Sigur в роли клиента. После настройки клиента, СКУД Sigur самостоятельно выполняет все запросы к Luna Access (Рисунок 105).
События детекции лиц
1․ СКУД Sigur инициирует GET-запрос: /event для получения событий деткции лиц от Access, соединение всегда остается открытым. 2․ Access возвращает в соединение события по мере того как они возникают. Даже если событий нет, Access раз в 5 секунд присылает искусственное "Keep alive" событие, чтобы обе стороны соединения были уверены, что соединение все еще в порядке. Access возвращает json-объект события, с полями:
- type - Тип события;
- channelId - ID канала в Access;
- persons - Массив с результатами распознавания;
- id - ID персоны;
- score - Степень схожести как вещественное число от 0 до 1.
События детекции ТС
3․ СКУД Sigur инициирует GET-запрос: /event для получения событий детекции ТС от Access, соединение всегда остается открытым (Access присылает новые события в СКУД по мере возникновения). 4․ Access возвращает в соединение события по мере того как они возникают. Даже если событий нет, Access раз в 5 секунд присылает искусственное "Keep alive" событие, чтобы обе стороны соединения были уверены, что соединение все еще в порядке. Access возвращает json-объект события, с полями:
- type - Тип события;
- channelId - ID канала в Access;
- number - Строка распознанного Государственного регистрационного знака ТС;
- direction - Направление вертикального движения автомобиля в кадре. Не обязательное поле, может отсутствовать. Если присутствует, то может принимать значения «up» или «down».
Получение списка сотрудников
5․ СКУД Sigur инициирует GET-запрос: /getpersons для синхронизации данных с Access. Запрос выполняется при старте сервера СКУД и при изменении каких либо синхронизируемых данных на стороне СКУД. В случае если запрос или последующие за ним запросы завершатся неудачно, СКУД будет пытаться раз в 5 секунд повторить запрос до тех пор пока синхронизация не пройдет без ошибок. 6․ Access возвращает json-объект, с полями:
- id - ID сотрудника;
- photoVersion - Текущая «версия фотографии» сотрудника в Access, значением поля выступает время обновления фотографии в СКУД в формате timestamp (unix формат);
- name - Имя сотрудника.
Модификация сотрудников
7․ СКУД Sigur инициирует POST-запрос: /updateperson для добавления или обновления данных сотрудника в Access. В теле запроса передается json-объект с полями:
- id - ID сотрудника в СКУД, целое число от 1 до 2^31-1;
- name - Имя сотрудника;
- photoVersion - Текущая «версия фотографии» сотрудника в Access, значением поля выступает время обновления фотографии в СКУД в формате timestamp (unix формат);
- photo - Фотография в формате JPEG, закодированная в base64.
8․ Access ищет в своей базе сотрудника с указанным id. Если такой есть, то его данные должны быть обновлены для приведения в соответствие с переданными. Если такого нет, то он должен быть создан. В случае успеха Access возвращает HTTP-статус 200. ОК. При неудаче СКУД досрочно прервет синхронизацию данных, т. е. перестанет исполнять updateperson и removeperson запросы, новую попытку СКУД совершит через 5 секунд. 9․ СКУД Sigur инициирует GET-запрос: /removeperson для удаления данных сотрудника в Access. В теле запроса передается json-объект с полем:
- id - ID удаляемого сотрудника.
Конфигурация направления прохода
10․ Access ищет в своей базе сотрудника с указанным id и удаляет его данные. В случае успеха Access возвращает HTTP-статус 200. ОК. При неудаче СКУД досрочно прервет синхронизацию данных, новую попытку СКУД совершит через 5 секунд. 11․ СКУД Sigur инициирует GET-запрос: /getchannels для выявления каналов устройств видеонаблюдения созданных в Access. Запрос выполняется при выполнении пользователем в интерфейсе СКУД действий по конфигурированию связи каналов и точек прохода. 12․ Access возвращает json-объект "channels", с полями:
- id - ID канала;
- name - Название канала.
Связь каналов и точек прохода происходит в пользовательском интерфейсе СКУД.
Sigur FAQ#
1․ Почему пуст выпадающий список в поле bio_system_id при настройке параметров подключения сервиса Sigur?
- Необходимо проверить наличие добавленного сервиса биометрической системы, он должен быть поддерживаемого типа. Поддерживаемые типы: Luna, CbsMts.
2․ Почему пуст выпадающий список в поле luna_cars_id при настройке параметров подключения сервиса Sigur?
- Необходимо проверить наличие добавленного сервиса LunaCars.
3․ Почему после настройки Sigur не началась синхронизация сотрудников?
- Для того, чтобы данные синхронизировалась должны быть выполнены следующие пункты:
- Включено распознавание в настройках ПО СКУД;
- Включено распознавание в оборудовании. В настройках точки доступа должна быть привязана камера и установлена галочка для необходимого режима (идентификация или верификация);
- У сотрудника должен быть доступ на эту точку доступа;
- У сотрудника должен быть режим доступа, в котором включён необходимый режим идентификации;
- Триггером запуска синхронизации сотрудников может являться любое редактирование любого сотрудника.