# Sigur (СКУД)

Журнал проходов и пропуска Sigur прямо в чате

Кто на объекте, отказы в проходе, пропуска

## Как агент работает с Sigur (СКУД)

Агент работает с Public REST API сервера Sigur: в подключении указывается адрес сервера с портом (по умолчанию 9500), логин и пароль оператора. Сервер обычно стоит в локальной сети, поэтому запросы идут через ваш компьютер с запущенным приложением. Сервер отвечает с правами этого оператора.

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

Запись в Sigur меняет физический доступ людей: выдача карты, идентификатора, гостевого пропуска или режима открывает двери. Агент собирает такие изменения как черновик, показывает человека, карту и срок и выполняет их только после подтверждения. Открыть дверь или снять зону с охраны через этот API нельзя.

## Сценарии интеграции

### Табель и опоздания
Агент соберёт проходы за период, найдёт по каждому сотруднику первый вход и последний выход за день и сравнит их с началом смены.

### Кто сейчас на объекте
Агент прочитает последнюю зону каждого сотрудника и покажет, кто внутри, по отделам и зонам.

### Отказы в проходе
Агент разберёт отказы по причинам: истёкший ключ, нет доступа к двери, повторный проход, и назовёт сотрудников и точки, где они повторяются.

### Пропуск новому сотруднику
Агент заведёт сотрудника в отделе, выдаст свободную карту и назначит режим доступа, показав перед записью, что именно изменится.

### Ревизия карт и режимов
Агент найдёт заблокированных сотрудников с выданными картами, карты без владельца и сотрудников без режима доступа.

### Тревоги и состояние оборудования
Агент соберёт вскрытия корпусов, потерю связи с точками доступа и переходы на батарею за период.

## Как подключить

**Перед подключением**

- Лицензия REST API: пакет Pro или Enterprise либо модуль «Лицензии Web: REST API»
- Оператор с правом «Доступ по REST API (Интеграции)»
- Сетевой доступ к серверу Sigur с компьютера, где запущено приложение

### Включите REST API на сервере Sigur
«Управление сервером» → «Порты» → «Использовать REST API», порт 9500, затем «Применить» и перезапуск сервера. Нужна лицензия REST API: Pro, Enterprise или модуль Web.

### Заведите оператора для интеграции
В программе «Клиент» на вкладке «Персонал» дайте сотруднику права оператора, отметьте «Доступ по REST API (Интеграции)» и задайте логин и пароль.

### Проверьте адрес и HTTPS
Адрес вида http://192.168.0.10:9500. С включённым «Использовать TLS» адрес начинается с https, а сертификат сервера должен проверяться на компьютере с приложением.

### Вставьте адрес, логин и пароль
Запустите приложение на компьютере в сети сервера Sigur: запросы к серверу в локальной сети идут через него.

## Частые вопросы

### Как подключить Sigur?
Включите «Использовать REST API» на вкладке «Порты» программы «Управление сервером», дайте сотруднику права оператора с галочкой «Доступ по REST API (Интеграции)» и задайте ему логин и пароль. В подключении укажите адрес сервера с портом, например http://192.168.0.10:9500, и эти логин с паролем.

### Что агент видит в Sigur?
Отделы, должности, сотрудников, карты и виртуальные идентификаторы, служебный транспорт, гостей и гостевые карты, режимы доступа, точки доступа и зоны, операторов и роли, а также журнал событий в кратком и разобранном виде.

### Меняет ли агент доступ?
Только по вашему подтверждению: заводит сотрудников, выдаёт и изымает карты и идентификаторы, назначает режимы. Перед каждой такой записью агент показывает, что изменится. Команд открытия дверей в API нет.

### Сервер работает по HTTPS. Что учесть?
Если на сервере включено шифрование TLS, указывайте адрес с https. Сертификат сервера должен проверяться на компьютере, через который идут запросы; при взаимной аутентификации нужен ещё и сертификат внешней системы.

[Открыть Sigur (СКУД)](https://sigur.com/doc/Public_REST_API_Developers_Guide.pdf)