![SSO в Пачке через Keycloak](https://pachca.com/help/sso7.jpg)

# SSO в Пачке через Keycloak

> Настройка единого входа SSO через Keycloak в корпоративном мессенджере Пачка: интеграция с открытым IdP по протоколу OpenID Connect

Источник: https://pachca.com/help-center/administration/sso-v-pachke-s-keycloak

Для интеграции Пачка используется [OpenID](https://pachca.com/help-center/administration/sso) Connect протокол.

Перейдите в Realm, который будет использоваться в интеграции с Пачкой. Realm не должен быть Master.

Создайте новый Client и сообщите нам его имя.

![alt](https://pachca.com/help/sso-v-pachke-s-keycloak-1.avif)

Укажите в разделе **Valid redirect URIs:**

- msauth.co.staply.pachca://auth
- com.pachca.app://oidc
- Ваш уникальный URL, который мы вам сообщим

![alt](https://pachca.com/help/sso-v-pachke-s-keycloak-2.avif)

**Client authentication** должен быть включён.

В **Credentials** скопируйте Secret и сообщите его нам.

### Автоматический выход из Пачки (Backchannel logout)

Можно настроить автоматическое завершение сессии: когда сотрудник выходит из учётной записи в SSO-провайдере, его сессия в Пачке тоже завершается.

Для этого в Keycloak откройте клиента, созданного для Пачки, и в разделе **Logout settings**:

1.  Выключите **Front channel logout**.
2.  В поле **Backchannel logout URL** укажите `https://auth.pachca.com/realms/<название вашего realm>/protocol/openid-connect/logout/backchannel-logout` — точный URL сообщит поддержка Пачки.
3.  Включите **Backchannel logout session required**.
4.  Включите **Backchannel logout revoke offline sessions**.

**После настройки напишите в поддержку Пачки — мы включим Backchannel logout со своей стороны.**

### Передача атрибутов сотрудника в Пачку

> Для наглядности, мы опишем процесс передачи атрибута из Windows [ADFS](https://pachca.com/help-center/administration/sso-adfs-openid) через Keycloak в Пачку.

На первом шаге необходимо настроить передачу атрибутов в Keycloak.

В ADFS менеджере открываем настройки [приложения](https://pachca.com/help-center/start/vsyo-pro-prilozheniya-pachki) созданного для Пачки.

![alt](https://pachca.com/help/sso-v-pachke-s-keycloak-3.avif)

Нажимаем на "Edit…" 👇

![alt](https://pachca.com/help/sso-v-pachke-s-keycloak-4.avif)

На вкладке "Issuance Transform Rules" нажимаем "Edit Rule…"

Заполняем табличку необходимыми вам атрибутами.

![alt](https://pachca.com/help/sso-v-pachke-s-keycloak-5.avif)

Например, для передачи групп сотрудника необходимо выбрать поле "Is-Member-Of-DL".

Перейти в Keycloak в настройки клиента созданного для Пачки в разделе "Clients".

![alt](https://pachca.com/help/sso-v-pachke-s-keycloak-6.avif)

Перейти в раздел "Client scopes"

Нажать на первый элемент в списке "<название клиента>-dedicated".

Нажать "Configure a new mapper".

![alt](https://pachca.com/help/sso-v-pachke-s-keycloak-7.avif)

В списке выбрать "User Attribute" 👇

![alt](https://pachca.com/help/sso-v-pachke-s-keycloak-8.webp)

Заполнить форму необходимыми значениями. В примере мы передаём в Пачку значение атрибута "groupTags".

Для работы интеграции тегов в Пачки с группами в Active Directory аттрибут должен иметь такое название.

![alt](https://pachca.com/help/sso-v-pachke-s-keycloak-9.avif)

А вот так можно передать в Пачку указанный у сотрудника телефон:

![alt](https://pachca.com/help/sso-v-pachke-s-keycloak-10.avif)

🎉 Готово, теперь при очередном входе по SSO, в Пачку будут переданы новые значения атрибутов сотрудника.

Чтобы добавить в [профиль сотрудника](https://pachca.com/help-center/features/profile) в Пачке другие поля, нужно в маппинге указать название атрибута:

- Телефон - phone\_number
- Должность - title
- Департамент - department
- [Групповые теги](https://pachca.com/help-center/administration/tags-team-members) - group\_tags

Так же вы можете передать в Пачку любые другие текстовые поля, которые есть в вашем каталоге. Например, руководителя сотрудника или его день рождения. Для этого необходимо:

1.  Создать необходимое поле через раздел "[Участники](https://pachca.com/help-center/administration/user-management)" в интерфейсе Пачки (раздел участники -> настройки -> добавить поле -> установить название и любой тип, кроме "файл")
2.  Указать название этого атрибута в маппинге, как было описано выше для стандартных полей профиля

**После настройки маппинга сообщите об этом нашей команде поддержки для подключения**

Обновлено: 17 февраля 2025 г.
