![SSO в Пачке с Indeed IdP по SAML](https://pachca.com/help/sso3.jpg)

# SSO в Пачке с Indeed IdP по SAML

> Настройка единого входа SSO через Indeed Identity Provider по протоколу SAML в корпоративном мессенджере Пачка — пошаговая инструкция

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

### 1\. Получение информации от администратора Keycloak (SP)

Прежде чем приступить к настройке, запросите у администратора [keycloak](https://pachca.com/help-center/administration/sso-v-pachke-s-keycloak) следующую информацию:

- **SP Entity ID (Идентификатор поставщика услуг)**
    - Пример: https://my-keycloak.company.com/auth/realms/my-realm
- **Assertion Consumer Service (ACS) URL**
    - Пример: https://my-keycloak.company.com/auth/realms/my-realm/broker/[saml](https://pachca.com/help-center/administration/sso)/endpoint
- **Single Logout (SLO) URL (если требуется)**
    - Пример: https://my-keycloak.company.com/auth/realms/my-realm/broker/saml/endpoint

> Примечание: В Keycloak SLO URL часто совпадает с ACS URL.

### 2\. Конфигурация файла настроек Indeed

Откройте ваш файл конфигурации (app-settings.json) и внесите изменения в следующие секции.

[Здесь](https://site-cdn.pachca.com/app-settings.json) можно посмотреть пример файла конфигурации.

### 2.1. Добавление нового Service Provider

Найдите секцию SAML.Configurations. Внутри нее находится массив `PartnerServiceProviderConfigurations`. Вам нужно добавить в этот массив новый объект для Keycloak.

Пример объекта для добавления:

```json
{
  "Name": "https://my-keycloak.company.com/auth/realms/my-realm",
  "SignSamlResponse": true,
  "ValidAssertionConsumerServiceUrls": ["http://localhost:8080"],
  "SingleLogoutServiceUrl": "https://my-keycloak.company.com/auth/realms/my-realm/broker/saml/endpoint"
}
```

Замените примеры URL и Name на реальные данные, полученные на Шаге 1. Параметр SignSamlResponse должен быть установлены в true, чтобы Indeed подписывал свои ответы.

### 2.2. Определение формата логина

Найдите секцию AuthenticationSettings.LoginFormats. Добавьте в этот массив новый объект, чтобы указать, какой атрибут пользователя использовать в качестве NameID для Keycloak.

Пример объекта для добавления:

```json
{
  "ServiceProvider": "https://my-keycloak.company.com/auth/realms/my-realm",
  "InLoginFormat": "Name",
  "OutLoginFormat": "PrincipalName"
}
```

### 2.3. Настройка передачи атрибутов пользователя (обязательно)

Для корректной работы Keycloak должен получать информацию о пользователе (email, имя, фамилия). Настройте передачу этих атрибутов в секции AuthenticationSettings.CustomAttributes. Добавьте в этот массив новый объект для Keycloak.

Пример объекта для добавления:

```json
{
  "ServiceProvider": "https://my-keycloak.company.com/auth/realms/my-realm",
  "Attributes": [
    {
      "Name": "email",
      "UserNameFormat": "email"
    },
    {
      "Name": "given_name",
      "UserNameFormat": "firstName"
    },
    {
      "Name": "family_name",
      "UserNameFormat": "lastName"
    },
    {
      "Name": "preferred_username",
      "UserNameFormat": "PrincipalName"
    }
  ]
}
```

Этот блок сопоставляет внутренние поля пользователя Indeed (email, firstName и т.д.) с именами атрибутов, которые будут отправлены в SAML-утверждении. Сообщите администратору Keycloak имена этих атрибутов (Name), чтобы он мог настроить их прием.

### 3\. Предоставление информации администратору Keycloak

После сохранения конфигурации и перезапуска сервиса Indeed, предоставьте администратору Keycloak следующие данные о вашем IdP:

1.  **IdP Entity ID (Issuer)**
    - urn:indeedid:saml\_idp
2.  **Single Sign-On (SSO) URL**
    - https://indeed.company.com/am/idp/Account/SsoService
3.  **SLO URL**
    - https://indeed.company.com/am/idp/Account/SloService
4.  **Публичный сертификат**
    - Экспортируйте публичную часть сертификата (отпечаток 57CB4...) в формате .cer или .pem

После того как [администратор](https://pachca.com/help-center/features/system-roles) Keycloak внесет эти данные в свою систему, интеграция будет готова к тестированию.

‍

Обновлено: 9 октября 2025 г.
