![SSO в Пачке по ADFS OpenID](https://pachca.com/help/sso5.jpg)

# SSO в Пачке по ADFS OpenID

> В данной инструкции описан процесс конфигурации ADFS для подключения к Пачке в Windows Server 2016 и выше.. Подробная инструкция с примерами для эффективной ...

Источник: https://pachca.com/help-center/administration/sso-adfs-openid

## В данной инструкции описан процесс конфигурации ADFS для подключения к Пачке в Windows Server 2016 и выше.

Откройте инструмент администрирования «AD FS Management».

![Инструмент AD FS Management в Windows Server](https://pachca.com/help/sso-adfs-openid-1762628465096-398bg9.png)

Нажмите на «Add Application Group…».

![Кнопка Add Application Group в ADFS](https://pachca.com/help/sso-adfs-openid-1762628466192-6gij.png)

Укажите любое имя (Например «Pachca»).

Укажите тип «Server application» и нажмите «next».

![Настройка имени приложения и выбор типа Server application](https://pachca.com/help/sso-adfs-openid-1762628467015-2dbpcl.png)

Сохраните значение поля «Client Identifier».

Укажите Redirect URI который мы вам сообщим.

![Поля Client Identifier и Redirect URI](https://pachca.com/help/sso-adfs-openid-1762628467785-7lgq35.png)

Включите опцию «Generate a shared secret» и скопируйте полученный код.

![Генерация shared secret для приложения](https://pachca.com/help/sso-adfs-openid-1762628468812-q1y3r7.png)

Сообщите нам значения:

- «Client Identifier»
- «Secret»
- URL вашего ADFS сервера

‍

Проверьте получившуюся конфигурацию и завершайте настройку по нажатию на «Next».

![Проверка конфигурации приложения](https://pachca.com/help/sso-adfs-openid-1762628469727-45bowl.png)

> Для работы ADFS по [OpenID](https://pachca.com/help-center/administration/sso) требуется дополнительная конфигурация описанная в [https://learn.microsoft.com/en-us/windows-server/identity/ad-fs/development/custom-id-tokens-in-ad-fs](https://learn.microsoft.com/en-us/windows-server/identity/ad-fs/development/custom-id-tokens-in-ad-fs)

Выберите созданный объект и нажмите на «Properties».

![Переход в Properties созданного объекта](https://pachca.com/help/sso-adfs-openid-1762628470483-vhqjys.png)

В настройках объекта нажмите на «Add application».

![Кнопка Add application в настройках](https://pachca.com/help/sso-adfs-openid-1762628471359-f6q28x.png)

Укажите тип «Web API».

![Выбор типа Web API](https://pachca.com/help/sso-adfs-openid-1762628472236-y7fzij.png)

В поле «Identifier» укажите ваш «Client Identifier».

![Настройка Identifier для Web API](https://pachca.com/help/sso-adfs-openid-1762628473317-mzv4ms.png)

> «Access Control Policy» оставьте выбранным «Permit everyone» за исключением ситуации, когда вам потребуется более тонкая настройка прав по работе ваших пользователей с приложением аутентификации.

![Access Control Policy - Permit everyone](https://pachca.com/help/sso-adfs-openid-1762628474373-yp5fai.png)

В разделе «Permitted scopes» выберите «allatclaims» и «openid».

![Выбор Permitted scopes: allatclaims и openid](https://pachca.com/help/sso-adfs-openid-1762628475193-1sxmie.png)

Проверьте настройки и завершайте конфигурацию.

![Финальная проверка настроек Web API](https://pachca.com/help/sso-adfs-openid-1762628476050-csve5.png)

‍

‍

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

> Для работы Пачке необходимы данные о пользователе, для чего необходимо настроить их передачу в токене OpenID.

Выберите созданное «Web API» и нажмите «Edit».

Перейдите в таб «Issuance Transform Rules» и нажмите «Add Rule…».

![Вкладка Issuance Transform Rules](https://pachca.com/help/sso-adfs-openid-1762628478255-ze3tzm.png)

Нажмите «Next».

![Мастер добавления правила трансформации](https://pachca.com/help/sso-adfs-openid-1762628479617-6qkgw6.png)

Укажите в поле «Claim rule name» любое название (например «User profile»).

В поле «Attribute store» укажите «Active Directory».

В таблице укажите следующие значения:

- E-Mail-Addresses: email
- Given-Name: firstName
- Surname: lastName

Завершайте конфигурацию по нажатию на «Finish».

![Настройка маппинга атрибутов Active Directory](https://pachca.com/help/sso-adfs-openid-1762628480603-6r0y5.png)

> Также мы можем с вами согласовать обработку в Пачке других полей, под ваш сценарий использования. Для передачи добавьте соотвествующий маппинг в эту табличку, и сообщите нам название кастомного «Outgoing Claim Type»

Название поля профиля сотрудника в Пачке и соответствующего ему названия атрибута:

- Телефон - 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.  Указать название этого атрибута в маппинге, как было описано выше для стандартных полей профиля

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

‍

‍

### Траблшутинг

**Ошибка на странице авторизации в ADFS**

![Ошибка на странице авторизации ADFS](https://pachca.com/help/sso-adfs-openid-1762628481383-5kee7o.png)

Для включения возможности авторизации через Identity Provider необходимо выполнить PowerShell команду:

```powershell
Set-AdfsProperties -EnableIdPInitiatedSignonPage $true
```

‍

**Ошибка после успешного входа в ADFS**

![Ошибка после успешного входа в ADFS](https://pachca.com/help/sso-adfs-openid-1762628482050-4094ak.png)

Возможно, на сервере установлено неправильное время. Проверьте синхронизацию NTP.

‍

‍

### Проверка работы

На экране [входа в Пачку](https://app.pachca.com/signin) нажать «Через почту».

![Кнопка Через почту на экране входа в Пачку](https://pachca.com/help/sso-adfs-openid-1762628482733-4trpv.png)

Нажать «**Войти через SSO**».

![Кнопка Войти через SSO](https://pachca.com/help/sso-adfs-openid-1762628483281-dxw8p.png)

В поле почты ввести свою рабочую почту в AD.

Выполнить [вход](https://pachca.com/help-center/start/signup-signin) через систему своей компании.

‍

**Ошибка «Cookie not found»**

![Ошибка Cookie not found на мобильном устройстве](https://pachca.com/help/sso-adfs-openid-1762628483850-y7gsgr.png)

Если на мобильном устройстве при входе возникает ошибка «Cookie not found. Please make sure cookies are enabled in your browser», поменяйте браузер по умолчанию, в котором открываются ссылки, на Google Chrome.

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