# Конфигурирование интеграции с СКД APACS

**Настройка интеграции PassOffice с APACS: Пошаговая инструкция**

Данное руководство описывает процесс настройки интеграции между PassOffice и системой контроля доступа APACS. Выполните следующие шаги под учетной записью администратора PassOffice.

**Предварительные требования:**

**1.** **Установка и запуск службы менеджера драйверов APACS:** Следуйте инструкции к ПК APACS для установки и запуска службы.

{% hint style="info" %}
Для активации защищенного соединения с **Менеджером драйверов** через SSL необходимо изменить параметр в конфигурационном файле `ApcWebDrvManager_defaultCfg.ini` (по пути Apacs30\exe\Apacs3000\Settings\ApcApplRes\ApcWebDrvManager): useSSL=1
{% endhint %}

**2. Создание отдельного оператора APACS:** Рекомендуется создать специального оператора APACS, от имени которого PassOffice будет взаимодействовать с системой.

**3. Настройка прав оператора APACS:**

• Выдайте созданному оператору права на чтение тех групп доступа, которые должны быть доступны для выбора в PassOffice.

• Укажите права на добавление, редактирование и удаление объектов в папке, используемой PassOffice.

**4. Создание папки для объектов PassOffice:** В дереве объектов APACS создайте папку, в которую будут добавляться новые объекты (посетители, пропуска), созданные в PassOffice.

**5**. **Задание псевдонима для папки:** Присвойте псевдоним созданной папке.

**Настройка PassOffice:**

**1. Запуск сервера PassOffice:** Запустите сервер PassOffice, используя файл `PassOfficeSrv.bat`.

**2. Авторизация в PassOffice:** Откройте браузер, введите адрес сервера PassOffice (например, `localhost:80`) и авторизуйтесь под учетной записью администратора.

**3**. **Переход к настройкам интеграции:** Откройте пункт меню «Администрирование / Настройки интеграции».

**4. Редактирование настроек APACS:**

* **Соединение:**
* `Логин и пароль оператора APACS`: укажите логин и пароль оператора APACS, созданного на этапе предварительных требований (по умолчанию `user` и `password`). Для обновления пароля:
  * Установите галочку **«Обновить пароль»**
  * Введите **новый пароль** в соответствующее поле и после этого нажмите **«Сохранить»**.
* `URL службы APACS`: укажите URL адрес службы APACS, например, `http://localhost:7010/v1/webapi/v3`
* `Connection timeout и Read timeout`: задайте значения тайм-аутов для соединения и чтения данных.

• **Вкладка «SSL»:**

* Добавьте сертификат для защищенного соединения.
* Поддерживаются сертификаты x509, хранилища JKS и PKCS12.
* Включите настройку «Упрощенная проверка» для отключения проверки хоста и домена.

• **Вкладка «Поля»**

Сконфигурируйте поля человека и пропуска, указав какие поля необходимо отгружать или импортировать из СКД, а также стратегию слияния при импорте:

* *Сторонняя система, очищать -* если поле есть и в PassOffice и в СКУД, то оно будет заменено на соответствующее из СКУД. Если поле есть в PassOffice, но нет в СКУД, то поле в PassOffice будет очищено. Если каких-то полей нет в PassOffice, но есть в СКУД, то оно заменится на соответствующее из СКУД.
* *Сторонняя система, дополнять -* если поле есть и в PassOffice и в СКУД, то оно будет заменено на соответствующее из СКУД. Если поле есть в PassOffice, но нет в СКУД, то поле отгрузится из PassOffice. Если каких-то полей нет в PassOffice, но есть в СКУД, то оно заменится на соответствующее из СКУД.
* *Бюро пропусков -* при расхождении данных, поля из PassOffice останутся приоритетными. Если каких-то полей нет в PassOffice, но есть в СКУД, то оно заменится на соответствующее из СКУД. И если есть поля в PassOffice, но нет в СКУД - недостающие поля отгружаются в СКУД.

**Поля посетителя, которые синхронизируются с СКД APACS:**

|     Поля    | Отгрузка в СКД | Импорт из СКД |
| :---------: | :------------: | :-----------: |
|     ФИО     |        +       |       +       |
|     Фото    |        +       |       +       |
|  Категория  |        +       |       +       |
|  Активность |        +       |       +       |
|    Email    |        +       |       +       |
|     Пол     |        +       |       +       |
| Организация |        +       |       +       |
|  Должность  |        +       |       +       |
|   Доп.поля  |        +       |       +       |

**Поля пропуска, которые синхронизируются с СКД APACS:**

|       Поля      | Отгрузка в СКД | Импорт из СКД |
| :-------------: | :------------: | :-----------: |
|  Номер пропуска |        +       |       +       |
| Код организации |        +       |       +       |
|   Пин пропуска  |        +       |       +       |

• **Вкладка «Дополнительные»**

**Синхронизация**

* *Отгружать посетителей без пропусков* - при включенной настройке посетитель может быть отгружен без создания заявки.
* *Папка для Картотеки -* укажите папку в APACS, в которую будут добавляться новые объекты PassOffice (используйте псевдоним, заданный ранее).
* *Разрешать слияние конфликтов при импорте -* при включенной настройке при импорте людей из интеграций объединяются похожие посетители.
* *Номер доп.поля для идентификации авто -* укажите доп.поле в APACS, в котором будет отображаться значение Car.
* *Отгрузка настроек доступа:* выберите способ отгрузки настроек доступа: *Идентификатор* или *Владелец карты -* используется для интеграции с системами распознавания лиц. После выдачи виртуального пропуска и фотографирования посетителя, ему будет назначена группа доступа и интервал посещения, что позволит идентифицировать его по лицу и предоставить доступ в указанный период.

**Режимы отгрузки**

* *Отгружать только через заявку -* данные о пользователе и его пропуске передаются в систему СКУД после обработки заявки.
* *Не отгружать* - информация о пользователе и пропуске полностью блокируется для автоматической передачи в систему СКУД при любых действиях в системе - создании заявки, редактировании данных пользователя или пропуска.
* *Всегда отгружать* - данные синхронизируются с системой СКУД при любом изменении, независимо от наличия заявки.

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

**Режимы удаления**

* *Удалять в СКУД при удалении в бюро пропусков -* при удалении посетителя или пропуска в PassOffice будет удалена соответствующая запись в ПК APACS.
* *Деактивировать в СКУД при удалении в бюро пропусков -* при удалении посетителя или пропуска в PassOffice, посетитель в ПК APACS остается со статусом «неактивен», пропуск при этом деактивируется.
* *Не отрабатывать удаление -* при удалении посетителя или пропуска в PassOffice, посетитель в ПК APACS остается активным.

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

**Пропуска**

Выберите стратегию выдачи временного пропуска на основе постоянного:

| **Стратегия**                          | **Действие**                                                                        | **Когда использовать**                                                                         |
| -------------------------------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **Сдвигать даты постоянного пропуска** | Период действия постоянного пропуска автоматически продлевается на срок временного. | Если нужно сохранить постоянный пропуск, но временно изменить срок его действия.               |
| **Деактивировать постоянный пропуск**  | Постоянный пропуск отключается на время действия временного.                        | Если временный пропуск должен полностью заменить постоянный (например, для гостевого доступа). |
| **Изымать постоянный пропуск**         | Постоянный пропуск изымается.                                                       | Если временный пропуск должен полностью заменить постоянный.                                   |

* *«Срок действия бессрочного пропуска» -* бессрочный пропуск из PassOffice отгрузится в APACS с указанным сроком действия.

**События:**

* Включите настройку «Получать события через RabbitMQ», если необходимо получать события от APACS в режиме реального времени.
* Укажите `url-адрес` компьютера с запущенным менеджером драйверов, `порт`, а также `имя пользователя` и `пароль`, созданные в веб-интерфейсе RabbitMQ. Для обновления пароля:
  * Установите галочку **«Обновить пароль»**
  * Введите **новый пароль** в соответствующее поле и после этого нажмите **«Сохранить»**.
* *Зачитывать события терминалов хранения за* - укажите период.
* *Импортировать события доступа начиная с -* укажите дату.

{% hint style="info" %}
При включенной настройке, любые изменения (добавление, изменение, удаление) людей, фотографий, групп доступа, организаций, должностей, выдача и изъятие пропусков в СКД APACS будут отображаться в PassOffice в реальном времени.
{% endhint %}

После выполнения этих шагов интеграция PassOffice с APACS должна быть настроена. Рекомендуется проверить работоспособность интеграции путем создания тестовой заявки и отслеживания её в системе APACS.

После активации соединения во вкладке «Соответствие категорий» настройте сопоставление полей PassOffice с полями APACS.