[Документация Yandex Cloud](../../../../index.md) > [Практические руководства](../../../index.md) > [Безопасность](../../index.md) > Настройка единого входа в приложения (SSO) > OpenCode Console > SAML

# Создать SAML-приложение в Yandex Identity Hub для интеграции с OpenCode Console


{% note warning %}

Часть ресурсов, необходимых для прохождения практического руководства, доступны только в [регионе Россия](../../../../overview/concepts/region.md).

{% endnote %}


[OpenCode Console](https://opencode.ai/console) позволяет управлять [рабочими пространствами](https://opencode.ai/docs/console/workspaces/) (workspaces) и настраивать [единый вход](../../../../glossary/sso.md) (SSO) для их участников. Чтобы пользователи вашей [организации](*organization) могли входить в рабочее пространство с помощью Yandex Identity Hub, создайте [SAML-приложение](../../../../organization/concepts/applications/saml.md) и настройте интеграцию по протоколу [SAML 2.0](https://ru.wikipedia.org/wiki/SAML).

Руководство описывает настройку доступа к рабочему пространству в OpenCode Console. Настройка доступа к экземпляру OpenCode, запущенному локально или на сервере, не рассматривается.

{% note info %}

* Для одного рабочего пространства можно настроить только одно подключение SSO: либо [SAML](https://ru.wikipedia.org/wiki/SAML), либо [OIDC](https://ru.wikipedia.org/wiki/OpenID#OpenID_Connect). Использовать оба протокола одновременно нельзя.
* К рабочему пространству можно привязать несколько почтовых доменов, но каждый домен может принадлежать только одному рабочему пространству.

{% endnote %}

Управлять SAML-приложениями может пользователь, которому назначена [роль](../../../../organization/security/index.md#organization-manager-samlApplications-admin) `organization-manager.samlApplications.admin` или выше.

Чтобы настроить единый вход:

1. [Подготовьтесь к работе](#before-you-begin).
1. [Получите параметры OpenCode Console](#saml-sp-settings).
1. [Создайте и настройте SAML-приложение](#saml-create-app).
1. [Активируйте SAML в OpenCode Console](#saml-activate).
1. [Предоставьте пользователям доступ к приложению](#add-users).
1. [Привяжите и подтвердите почтовый домен](#verify-domain).
1. [Проверьте вход в рабочее пространство](#validate).

## Перед началом работы {#before-you-begin}

1. Подготовьте организацию в Yandex Identity Hub. Если у вас еще нет организации, [создайте ее](../../../../organization/operations/enable-org.md).
1. Убедитесь, что у вас есть рабочее пространство в OpenCode Console и роль **Owner** в нем. Настраивать SSO может только владелец рабочего пространства.
1. Подготовьте почтовый домен вашей организации и убедитесь, что можете добавлять TXT-записи в его DNS-зону. Домен потребуется привязать к рабочему пространству и подтвердить в OpenCode Console.
1. Убедитесь, что у пользователей, которые будут входить через SSO, в Yandex Identity Hub указан адрес электронной почты в этом домене.

{% note warning %}

После активации SSO администраторы и участники рабочего пространства должны входить через настроенного поставщика удостоверений. Владелец сохраняет возможность входа без SSO. Не закрывайте сессию владельца до завершения настройки и проверки входа.

{% endnote %}

## Получите параметры OpenCode Console {#saml-sp-settings}

1. Войдите в [OpenCode Console](https://opencode.ai/console) как владелец рабочего пространства и выберите нужное рабочее пространство.
1. Откройте **Settings** → **Security** и нажмите **Configure SSO**.
1. Выберите **SAML 2.0** и вариант настройки произвольного поставщика удостоверений **Custom SAML**.
1. На шаге **Set up your provider** скопируйте значения **ACS URL (Callback)** и **SP Entity ID**. Они понадобятся для настройки приложения в Yandex Identity Hub.

    Используйте значения из вашего подключения. Адреса содержат уникальный идентификатор подключения SSO и имеют вид:

    * **ACS URL (Callback)** — `https://opencode.ai/console/auth/sso/<идентификатор_подключения>/callback`.
    * **SP Entity ID** — `https://opencode.ai/console/auth/sso/<идентификатор_подключения>/metadata`.

## Создайте и настройте SAML-приложение {#saml-create-app}

{% list tabs group=instructions %}

- Интерфейс Cloud Center {#cloud-center}

    1. В другой вкладке браузера откройте сервис [Yandex Identity Hub](https://kz.center.yandex.cloud/organization).
    1. На панели слева выберите ![shapes-4](../../../../_assets/console-icons/shapes-4.svg) **Приложения**.
    1. Нажмите ![circles-3-plus](../../../../_assets/console-icons/circles-3-plus.svg) **Создать приложение** и в открывшемся окне:

        1. Выберите метод единого входа **SAML (Security Assertion Markup Language)**.
        1. В поле **Имя** укажите имя приложения, например `opencode-saml`.
        1. (Опционально) Добавьте описание и [метки](../../../../resource-manager/concepts/labels.md) приложения.
        1. Нажмите **Создать приложение**.
    1. На странице созданного приложения нажмите ![pencil](../../../../_assets/console-icons/pencil.svg) **Редактировать** и задайте настройки:

        * **SP EntityID** — значение **SP Entity ID** из OpenCode Console.
        * **ACS URL** — значение **ACS URL (Callback)** из OpenCode Console.
        * **Режим подписи** — **Assertions**.

        Поле **SP Logout URL** оставьте пустым.
    1. Нажмите **Сохранить**.
    1. Настройте передачу адреса электронной почты пользователя:

        1. Перейдите на вкладку **Атрибуты**.
        1. Нажмите ![plus](../../../../_assets/console-icons/plus.svg) **Добавить атрибут**.
        1. В поле **Имя атрибута** укажите `email`.
        1. В поле **Значение** выберите `SubjectClaims.email`.
        1. Нажмите **Добавить**.

        Если атрибут `email` уже есть, проверьте его значение вместо создания нового атрибута.
    1. Перейдите на вкладку **Обзор** и в блоке **Конфигурация поставщика удостоверений (IdP)** скопируйте значение поля **Metadata URL**.

{% endlist %}

{% note info %}

OpenCode Console требует, чтобы поставщик удостоверений подписывал SAML-ответ или содержащиеся в нем утверждения. Также поставщик должен передавать адрес электронной почты пользователя в атрибуте `email` или в `NameID`. В этом руководстве используются подпись утверждений и отдельный атрибут `email`.

{% endnote %}

## Активируйте SAML в OpenCode Console {#saml-activate}

1. Вернитесь к настройке **Custom SAML** в OpenCode Console и нажмите **Next**.
1. На шаге **Add provider details** в поле **IdP Metadata** вставьте URL метаданных приложения, скопированный из Yandex Identity Hub.
1. Нажмите **Fetch**. Проверьте, что заполнились поля **IdP Entity ID**, **IdP SSO URL** и **IdP Certificate**.

    Вместо загрузки по URL можно использовать **Upload XML** и загрузить файл метаданных, скачанный со страницы SAML-приложения в Yandex Identity Hub.
1. В поле **Display Name** укажите имя поставщика удостоверений, например `Identity Hub SAML`.
1. Нажмите **Next**.
1. На шаге **Review** проверьте параметры и нажмите **Activate SSO**.

## Предоставьте пользователям доступ к приложению {#add-users}

Пользователей или [группы пользователей](*users-groups) нужно явно добавить в созданное SAML-приложение Yandex Identity Hub:

{% note info %}

Управлять пользователями и группами, добавленными в SAML-приложение, может пользователь, которому назначена [роль](../../../../organization/security/index.md#organization-manager-samlApplications-userAdmin) `organization-manager.samlApplications.userAdmin` или выше.

{% endnote %}

{% list tabs group=instructions %}

- Интерфейс Cloud Center {#cloud-center}

    1. В сервисе [Yandex Identity Hub](https://kz.center.yandex.cloud/organization) откройте **Приложения** и выберите созданное приложение.
    1. Перейдите на вкладку **Пользователи и группы**.
    1. Нажмите ![person-plus](../../../../_assets/console-icons/person-plus.svg) **Добавить пользователей**.
    1. Выберите нужного пользователя или группу пользователей и нажмите **Добавить**.

{% endlist %}

{% note tip %}

Если вы хотите более тонко настроить аутентификацию пользователей в приложениях, в том числе разрешить аутентификацию только с определенных IP-адресов, используйте [политики аутентификации](*authentication_policies).

{% endnote %}

[*authentication_policies]: Политики аутентификации — это инструмент Yandex Identity Hub, позволяющий гибко настраивать доступ к приложениям, запрещая или разрешая аутентификацию определенным пользователям в определенных приложениях и/или с определенных IP-адресов. Подробнее читайте в разделе [Политики аутентификации в Yandex Identity Hub](../../../../organization/concepts/authentication-policy.md).

## Привяжите и подтвердите почтовый домен {#verify-domain}

Домен нужно добавить и подтвердить именно в OpenCode Console. Подтверждение домена в Yandex Identity Hub не заменяет эту настройку.

1. В OpenCode Console откройте **Settings** → **Security** нужного рабочего пространства.
1. После активации SSO в блоке **Email domains** нажмите **Add domain**.
1. Укажите домен адресов электронной почты пользователей, например `example.com`.
1. В DNS-зоне домена создайте TXT-запись с именем и значением, которые покажет OpenCode Console. Запись имеет вид:

    #|
    || **Параметр** | **Пример** ||
    || Имя | `_opencode-console-challenge.example.com` ||
    || Тип | `TXT` ||
    || Значение | `oc-verify=<код_подтверждения>` ||
    |#

    Используйте код подтверждения из OpenCode Console, а не значение из примера.
1. Дождитесь обновления DNS-записей и нажмите **Verify Domain** в OpenCode Console. Если проверка не прошла, убедитесь, что запись корректна, и повторите попытку позже.
1. Убедитесь, что домен подтвержден. Если пользователи используют несколько почтовых доменов, повторите эти действия для каждого домена.

{% note info %}

К одному рабочему пространству можно привязать несколько доменов. Один и тот же домен нельзя привязать к нескольким рабочим пространствам.

{% endnote %}

## Проверьте вход в рабочее пространство {#validate}

1. Откройте [OpenCode Console](https://opencode.ai/console) в приватном окне браузера, чтобы не использовать сессию владельца.
1. Начните вход с адресом электронной почты пользователя из подтвержденного домена. Пользователь должен быть добавлен в приложение Yandex Identity Hub напрямую или через группу.
1. После перенаправления в Yandex Identity Hub выполните аутентификацию этого пользователя.
1. Если учетная запись с таким адресом уже существует в OpenCode Console, подтвердите ее связывание кнопкой **Link account**, когда появится соответствующий запрос.
1. Убедитесь, что пользователю доступно нужное рабочее пространство.

При первом входе через SSO пользователи из подтвержденного домена автоматически присоединяются к рабочему пространству с ролью **Member**. Исключения:

* у пользователя есть ожидающее приглашение;
* в рабочем пространстве настроена синхронизация каталога [SCIM](https://ru.wikipedia.org/wiki/SCIM);
* используется [подписка OpenCode Go](https://opencode.ai/pricing).

В этих случаях членство определяется приглашением, синхронизацией или условиями подписки. Подробнее в [документации OpenCode](https://opencode.ai/v2/docs/console/sso/#automatic-membership).

#### Полезные ссылки {#see-also}

* [Настройка SSO в OpenCode Console](https://opencode.ai/v2/docs/console/sso/).
* [Создать SAML-приложение в Yandex Identity Hub](../../../../organization/operations/applications/saml-create.md).

[*organization]: _Организация_ — это высший ресурс в иерархии ресурсной модели Yandex Cloud, который объединяет ресурсы всех остальных сервисов, а также используется для управления пользователями и параметрами их аутентификации и авторизации. Подробнее читайте в разделе [Организация](../../../../organization/concepts/organization.md).

[*users-groups]: Пользователей Yandex Identity Hub можно объединять в группы, что упрощает управление доступом в Yandex Cloud. Подробнее читайте в разделе [Группы пользователей](../../../../organization/concepts/groups.md).