> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yahont.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# SAML

> Настройка аутентификации SAML

Настройте в Yahont аутентификацию SAML.

Поставщики SAML настраиваются в **Панель администратора** → **Организация** → [Поставщики
SSO](/deployment/authentication/sso_providers). Файлы конфигурации и перезапуски не нужны,
и можно настроить несколько поставщиков и включить их одновременно (см.
[Доступность в Yahont CE и Enterprise Edition](/deployment/authentication/sso_providers#plan-availability)).
SAML работает на стандартных образах Yahont.

> [!NOTE]
>
> В Yahont Cloud SAML недоступен: там можно выбрать только Google и OIDC. См.
> раздел [Yahont Cloud](/deployment/authentication/sso_providers#onyx-cloud).

В этом руководстве описана настройка для Okta. Другие поставщики удостоверений настраиваются похожим образом.
Свяжитесь с нами, если нужна помощь с другим поставщиком удостоверений.

## Руководство

**1. Создайте приложение Okta**

Откройте Okta **Admin Console** → **Applications** → **Create App Integration**.

![Страница создания интеграции в Okta](https://mintcdn.com/yahont-ai/UKtfkv0aQHzrYqTA/assets/deployment/oidc_create_integration.png?fit=max\&auto=format\&n=UKtfkv0aQHzrYqTA\&q=85\&s=6f6f9de7ec381bc943ebac8b2bb7207a)

**2. Настройте приложение Okta**

Выберите **SAML 2.0**.

Задайте **Name** приложения `Yahont` и загрузите логотип Yahont.

> [!TIP]
>
> Если вы используете white labeling Yahont, приложение можно назвать как угодно и загрузить собственный логотип.

Добавьте **Single sign-on URL** (URL ACS, общий для всех поставщиков SAML в инстансе):

```
https://YOUR_YAHONT_DOMAIN.com/auth/saml/callback
```

Добавьте **Audience URI (SP Entity ID)**. Подойдёт любой стабильный идентификатор, если он совпадает с SP entity ID,
который вы вводите в Yahont:

```
https://YOUR_YAHONT_DOMAIN.com/metadata
```

Добавьте **Attribute Statement**, где **Name** — `email`, а **Value** — `user.email`.

![Страница настройки приложения SAML в Okta](https://mintcdn.com/yahont-ai/UKtfkv0aQHzrYqTA/assets/deployment/saml_config.png?fit=max\&auto=format\&n=UKtfkv0aQHzrYqTA\&q=85\&s=8365a7c1c2ef5fb2fa5dd543e6800b89)

**3. Назначьте пользователей приложению**

Создайте приложение и откройте вкладку **Assignments**, чтобы назначить пользователей.

**4. Соберите значения IdP**

Yahont нужны три значения из Okta:

> **IdP Entity ID**
>
> Откройте вкладку **Sign On** вашего приложения в Okta, скопируйте **Metadata URL** и вставьте его в браузер.
> Вы должны увидеть XML вида:
>
> ```XML theme={null}
> <md:EntityDescriptor
>     xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata"
>     entityID="http://www.okta.com/exkngircrvOYQyNg35d7">
> ...
> </md:EntityDescriptor>
> ```
>
> Скопируйте значение `entityID`.

> **IdP x509 Certificate**
>
> В XML с предыдущего шага найдите элемент `ds:X509Certificate`.
>
> ```XML theme={null}
> <md:KeyDescriptor use="signing">
>     <ds:KeyInfo xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
>         <ds:X509Data>
>             <ds:X509Certificate>
>                 [Some certificate value here]
>             </ds:X509Certificate>
>         </ds:X509Data>
>     </ds:KeyInfo>
> </md:KeyDescriptor>
> ```
>
> Скопируйте значение сертификата.

> **IdP SSO URL**
>
> Откройте вкладку **General** вашего приложения в Okta и скопируйте **Embed Link**.

**5. Добавьте поставщика в Yahont**

Откройте **Панель администратора** → **Организация** → [Провайдеры SSO](/deployment/authentication/sso_providers)
и нажмите **Add Provider**.

Выберите тип поставщика **SAML**, задайте поставщику **Name** (slug в нижнем регистре, например `okta`)
и вставьте **IdP entity ID**, **IdP SSO URL**, **IdP x509 certificate** и **SP entity ID** из приложения Okta.

> **Необязательно: сертификат SP и закрытый ключ**
>
> Если ваш IdP требует подписанных запросов,
> создайте самоподписанный сертификат и введите оба значения в форме поставщика:
>
> ```bash theme={null}
> openssl genrsa -out sp-private-key.pem 2048
> openssl req -new -x509 -key sp-private-key.pem -out sp-cert.pem -days 730 -subj "/CN=<YOUR_DOMAIN e.g. saml.yahont.example.com>"
> ```

После создания поставщика в его строке показывается точный **ACS URL**. Убедитесь,
что он совпадает с single sign-on URL, зарегистрированным в Okta,
затем войдите через новый вариант на странице входа.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.