Конфигурирование интеграции с OpenID
Выполните следующие шаги под учетной записью администратора PassOffice.
Настройка PassOffice:
1. Запуск сервера PassOffice: Запустите сервер PassOffice, используя файл PassOfficeSrv.bat
.
2. Авторизация в PassOffice: Откройте браузер, введите адрес сервера PassOffice (например, localhost:80
) и авторизуйтесь под учетной записью администратора.
3. Переход к настройкам интеграции: Откройте пункт меню «Администрирование / Настройки интеграции».
4. Редактирование настроек OpenID:
Основные параметры:
ADFS discovery document URL
: URL, по которому можно получить метаданные OpenID Connect (например,https://example.com/.well-known/openid-configuration
). Это позволяет PassOffice автоматически обнаружить endpoints авторизации, токена и userInfo.Идентификатор клиента (Client ID):
идентификатор клиента, выданный PassOffice Identity Provider'ом (ADFS или другим).Алгоритм генерации токена:
алгоритм, используемый для подписи токенов (например, RS256, ES256).Connection timeout и Read timeout
: задайте значения тайм-аутов для соединения и чтения данных.
• Вкладка «SSL»:
Добавьте сертификат для защищенного соединения.
Поддерживаются сертификаты x509, хранилища JKS и PKCS12.
Включите настройку "Упрощенная проверка" для отключения проверки хоста и домена.
• Вкладка «Настройки операторов»:
Соответствие настроек оператора в PassOffice и группы Active Directory: установите соответствие между группами AD и предустановленными "Настройками оператора" в PassOffice.
• Вкладка «Настройки внешнего вида»:
Соответствие настроек оператора в PassOffice и группы Active Directory: установите соответствие между группами AD и предустановленными "Настройками внешнего вида" в PassOffice.
В случае, если у пользователя несколько групп, подходящих под отображение, ему будут присвоены те настройки оператора, которые в таблице указаны выше.
• Вкладка «Саморегистрация»:
Разрешать саморегистрацию: если флажок установлен, пользователи смогут создавать учетные записи PassOffice при первом входе через OpenID. Укажите настройки по умолчанию для вновь созданных учетных записей.
Настройки по-умолчанию - укажите настройки оператора по-умолчанию.
Настройки внешнего вида по-умолчанию - укажите настройки внешнего вида оператора по-умолчанию.
Синхронизировать роли при входе: автоматически синхронизирует роли пользователей при каждом входе в PassOffice.
Синхронизировать настройки при входе: автоматически синхронизирует настройки пользователя при каждом входе.
Вкладка «Данные»:
Active Directory: используйте Active Directory в качестве источника данных для атрибутов пользователя. Это предполагает, что Identity Provider (например, ADFS) настроен для получения информации из AD.
JWT Token: используйте JWT (JSON Web Token), полученный от Identity Provider'а, для получения атрибутов пользователя. В этом случае, необходимо настроить сопоставление клеймов JWT с полями PassOffice.
Определите, каким полям в PassOffice соответствуют атрибуты в OpenID. Например:
ФИО=displayName
,Имя=givenName,GivenName
(поиск ведется сначала в поле givenName, а затем, если оно не заполнено, в поле GivenName.
Фамилия=sn
Почта=mail
Логин=userPrincipalName
Телефон=telephoneNumber
Рабочий телефон=telephoneNumber
Комната=physicalDeliveryOfficeName
Отдел=department
Должность=title
Организация=Company
Страна=co
На следующем шаге задайте соответствие ролей, указав название и атрибут:
Подача заявок=requestRole
Согласование заявок=acceptRole
Выдача пропусков=issueRole
Работа с реестром=reportRole
Администрирование=adminRole
Картотека=cardlibRole
Управление доступом без заявки=accessManagementRole
Дежурный режим=guardRole
Терминалы=terminalRole
История проходов=passHistoryRole
Изъятие пропусков=withdrawRole
Перевыдача пропусков=reissueRole
Служба безопасности=securityRole
Пользователь=uiRole
Сервис интеграции=integrationRole
• В каждом поле задайте стратегия разрешения конфликтов при обнаружении совпадений:
Сторонняя система, очищать - если поле есть и в PassOffice и в СКУД, то оно будет заменено на соответствующее из СКУД. Если поле есть в PassOffice, но нет в СКУД, то поле в PassOffice будет очищено. Если каких-то полей нет в PassOffice, но есть в СКУД, то оно заменится на соответствующее из СКУД.
Сторонняя система, дополнять - если поле есть и в PassOffice и в СКУД, то оно будет заменено на соответствующее из СКУД. Если поле есть в PassOffice, но нет в СКУД, то поле отгрузится из PassOffice. Если каких-то полей нет в PassOffice, но есть в СКУД, то оно заменится на соответствующее из СКУД.
Бюро пропусков - данные в PassOffice сохраняются, даже если они отличаются от данных в AD. Если каких-то полей нет в PassOffice, но есть в Active Directory, то они заменяются на соотвествующие из Active Directory.
Тест соединения: обязательно проведите тест соединения после ввода параметров.
Успешный тест: активируйте настройки соединения с OpenID.
Ошибка: проверьте логи сервера PassOffice для выявления и устранения проблемы.
• Реактивация/Деактивация соединения: используйте соответствующие кнопки для управления состоянием соединения с OpenID.
Last updated
Was this helpful?