СКУД PERCo-Web#
Программные интеграции ПО СКУД PERCo-Web с LP5 реализована для обеспечения прохода распознанных лиц через турникет/дверь с магнитным замком.
- Поддерживает версии PERCo-Web системы 2.0, номер сборки PERCo-Web 4.30.
Выполняет репликацию данных пользователей из СКУД PERCo-Web и генерирует контроллеры PercoController из полученного списка устройств для последующего выполнения запросов на вход или выход.
Поддерживаемые варианты интеграции СКУД PERCo-Web#
Устройство детекции лиц генерирует событие, Access передает событие в LP5 на распознавание, LP5 обрабатывает событие и возвращает результат в Access для дальнейшей обработки.
Перенос данных пользователей из СКУД в LP5 происходит с помощью двух механизмов:
- репликация - механизм первоначального переноса данных пользователей;
- синхронизация - механизм периодичного переноса данных пользователей при изменении состава/данных пользователей.
Настройку синхронизации/репликации см. в настройках сервисов.
В каждой интеграции c LP5 (Таблица 53) используется сервис Luna.
Если терминал не имеет средств вывода данных (например, экрана), пайплайн SendToDevice не требуется.
Таблица 53. Варианты интеграции c LP5
Стандартная интеграция с использованием PERCo-Web#
Поддерживается только 1ф интеграция (Рисунок 86) и (Таблица 54).
Таблица 54. Описание интеграции
| Компонент | Описание |
|---|---|
| Человек | Персона, желающая пройти через точку прохода. |
| Точка прохода | Набор компонентов, используемых для контроля доступа человека. Точек прохода может быть подключена более одной, ограничивается лицензией на СКУД. Точка прохода может использовать как на вход, так и на выход. Для каждого направления используется свой считыватель и источник видеоданных. |
| Источник видеоданных | Устройство для извлечения кадра лица человека. Может быть как биометрический терминал (LUNA FAST 4A1 и другие), либо камера, подключенная через FaceStream. Биометрический терминал позволяет создать обратную связь для демонстрации человеку информации о проходе. |
| Турникет | Преграждающее устройство для разграничения доступов |
| СКУД PercoWEB | Центральное ПО для работы с PercoWEB. Хранит данные сотрудников и принимает решение о предоставлении доступа. |
| Пайплайн SendToDevice | Компонент Access для отправки сигнала на открытие реле в устройство и вывода текста на экран. |
| Устройство ... | Компонент Access для получения данных от источника видеоданных. Выбирается исходя из используемого устройства. |
| Контроллер PercoController | Компонент Access для отправки в СКУД номера карты. |
| Сервис PercoWeb | Компонент Access для выполнения репликации/синхронизации сотрудников из СКУД и прослушивания событий СКУД. |
| Сервис БС | Компонент Access для взаимодействия с Биометрическими Системами: для LP5 это Luna, для КБС - соответствующий сервис КБС. |
| Пайплайн MatchByPhoto | Компонент Access для взаимодействия с Биометрическими Системами. |
| Пайплайн SendToController | Компонент Access передает идентификатор сотрудника в PercoController после матчинга человека и подтверждения номера карты в Access. |
| Хранилище | Локальная система хранения связей между персонами СКУД и их биометрическими данными. |
| Биометрическая система | Система сравнения эталонного фото персоны и лучшего кадра, полученного от источника видеоданных. Может быть либо Luna, либо сервис поддерживаемой КБС. |
Методы взаимодействия с PERCo-Web#
Начало эндпоинта для всех запросов (Таблица 55): /api.
Таблица 55. Используемые методы СКУД PERCo-Web
| Задача | Метод | Описание |
|---|---|---|
| Авторизоваться | POST /system/auth | Авторизация Access в СКУД. Авторизация происходит при добавлении сервиса для получения токена. Время жизни токена - 840 секунд. |
| Проверка доступности | GET /system/language/ | Проверка доступности СКУД. Выполняется раз в минуту |
| Получить контроллеры | GET /devices | Получить device_id контроллеров для создания в Access PercoController. |
| Получить информацию о контроллере | GET /devices/{device_id} | Получить информацию о контроллере по его id, если он активен. |
| Синхронизация сотрудников | GET /users/staff/table | Получить информацию о сотрудниках: наличие фото, статус активности, ФИО и person_id. |
| Получить фото сотрудников | GET /users/{user_id}/image | Получить фото сотрудника |
| Получить события | GET /eventsystem | Запрос на получение событий изменения сотрудников. Запрос отправляется каждые 10 секунд. |
| Открыть турникет | POST /devices/{device_id}/pass | Отправка запрос для открытия доступа человеку на том же контроллере, от какого пришло событие. |
Диаграммы процессов взаимодействия с PERCo-Web#
Подключение сервиса PERCo-Web#
Диаграмма процесса (Рисунок 87).
1． Пользователь добавил в Access сервис PERCo-Web.
2． Access отправляет запрос на авторизацию в СКУД.
3． СКУД возвращает токен для авторизации. Токен имеет время жизни, по истечению которого Access повторно выполняет авторизацию.
4． Access отправляет запрос GET /system/language/ для определения активен ли сервис.
5． СКУД возвращает ответ.
6． Access отправляет запрос на получение списка активных контроллеров.
7． СКУД возвращает массив device_id.
8． Access отправляет запрос на получение информации о контроллере, для каждого полученного device_id.
9． СКУД возвращает данные контроллера.
10． Access создает PercoController по количеству полученных device_id.
11． Access отправляет запрос на репликацию сотрудников из СКУД.
12． СКУД возвращает данные сотрудников.
13． Access отправляет запрос на получение фото сотрудников, которые активны и имеют фото.
14． СКУД возвращает фото сотрудников.
15． Access отправляет запрос с фото сотрудников к БС на извлечение descriptor_id (face_id).
16． БС возвращает descriptor_id.
17． Access сохраняет в хранилище данные сотрудников.
18． Access отправляет запрос каждые 10 секунд для получения событий об изменении сотрудников для выполнения синхронизации.
19． СКУД возвращает события.
Обработка событий PERCo-Web при 1 факторе#
Диаграмма процесса (Рисунок 88).
1． Сотрудник у биометрического терминала на точке прохода.
2． Терминал отправляет в Access лучший кадр сотрудника.
3． Access отправляет в Биометрическую систему фото сотрудника.
4． БС производит сравнение фотографией с терминала и сохраненного в базе.
5． БС возвращает в Access результат матчинга.
6． Access ищет номер сотрудника по полученному descriptor_id.
7． Access отправляет в СКУД номер сотрудника.
8． СКУД принимает решение о пропуске человека.