> For the complete documentation index, see [llms.txt](https://docs.aamsystems.ru/passoffice/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aamsystems.ru/passoffice/passoffice-guide/admin-guide-doc/acs-configuration/acs-lyrix.md).

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

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

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

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

• Убедитесь, что система LyriX установлена и настроена.

• Создайте объекты (например, категории посетителей) в LyriX, которые будут соответствовать категориям в PassOffice.

* Рекомендуется создать отдельного оператора LyriX, от лица которого будет работать PassOffice. Выдайте данному оператору права на чтение групп доступа, которые должны быть доступны при работе в PassOffice и права на добавление/редактирование/удаление пользователей и карт в соответствующие контейнеры
* В настройках интеграции задайте контейнеры пользователей и карт, в которые будут добавляться новые объекты из PassOffice.
* Также в настройках интеграции, в настройках внешней системы кликните на иконку «Задать поля» и выберите следующие поля для отчета:

<figure><img src="/files/kDJf1GK3mGXywUQGd8AH" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

* **Основные параметры:**
* `Логин и пароль оператора` LyriX: укажите логин и пароль оператора LyriX. Для обновления пароля:
  * Установите галочку **«Обновить пароль»**
  * Введите **новый пароль** в соответствующее поле и после этого нажмите **«Сохранить»**.
* `URL` LyriX: укажите URL адрес LyriX, например, `http://localhost:8099/AxisWebApp/services/CardlibIntegrationService2Port?wsdl`
* `Connection timeout и Read timeout`: задайте значения тайм-аутов для соединения и чтения данных.

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

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

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

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

* *Разрешать слияние конфликтов при импорте -* при включенной настройке при импорте людей из интеграций объединяются похожие посетители.

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

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

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

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

**Для людей:**

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

**Для пропуска:**

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

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

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

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

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

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

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

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

{% hint style="info" %}
Для корректной работы интеграции, наименование объекта «Оператор» в LyriX (для версии 6.2.4.4 и ниже) должно совпадать с логином этого оператора. PassOffice проверяет инициатора сообщений и обрабатывает только сообщения, инициированные оператором PassOffice.
{% endhint %}

{% hint style="info" %}
Получение живых событий через RabbitMQ доступно начиная с версии 5.4.3.10
{% endhint %}

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

* *Импортировать события доступа начиная с:* определите период времени для синхронизации событий между PassOffice и LyriX.
* *Конфигурирация размера пакетов для импорта:* оптимизируйте процесс импорта данных из LyriX, указав размер пакетов для различных типов объектов: человек, группа доступа, сообщение из СКД, должность, организация, считыватель.

• **Тест соединения:** обязательно проведите тест соединения после ввода параметров.

* **Успешный тест:** активируйте настройки соединения с СКД.
* **Ошибка:** проверьте логи LyriX и сервера PassOffice для выявления и устранения проблемы.

• **Соответствие категорий:** укажите соответствие между категориями пользователей в PassOffice и СКД: сотрудники, посетители, автомобили, VIP-Посетители. Это необходимо для корректной передачи информации о типе пользователя в СКД.

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

<figure><img src="/files/EBkOFr69BFjrjWd3q5nI" alt=""><figcaption><p>Пример конфигурирования доп.полей человека и пропусков</p></figcaption></figure>

• **Сконфигурируйте стратегию слиянию при импорте:**

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

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

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

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

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

**Реактивация/Деактивация соединения:** используйте соответствующие кнопки для управления состоянием соединения с СКД.

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