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

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


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

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

{% note info %}

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

{% endnote %}

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

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

1. [Подготовьтесь к работе](#before-you-begin).
1. [Создайте OIDC-приложение и получите учетные данные](#oidc-create-app).
1. [Создайте подключение в OpenCode Console](#oidc-create-connection).
1. [Настройте адрес возврата и атрибуты](#oidc-redirect-uri).
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 указан адрес электронной почты в этом домене.
1. Подготовьте [каталог](*folder), в котором будет создан OAuth-клиент.

{% note warning %}

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

{% endnote %}

## Создайте OIDC-приложение и получите учетные данные {#oidc-create-app}

{% list tabs group=instructions %}

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

    1. Войдите в сервис [Yandex Identity Hub](https://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. Выберите метод единого входа **OIDC (OpenID Connect)**.
        1. В поле **Тип приложения** выберите тип [Web Application](*web_app_type).
           
           [*web_app_type]: OIDC-приложения типа `Web Application` оптимально подходят для аутентификации пользователей во внешних веб-приложениях, имеющих серверную часть (бэкенд), в которой может безопасно храниться секрет приложения. Подробнее о типах OIDC-приложений читайте в разделе [Типы OIDC-приложений в Yandex Identity Hub](../../../../organization/concepts/applications/oidc.md#oidc-application-types).
        1. В поле **Имя** укажите имя приложения, например `opencode-oidc`.
        1. В поле **Каталог** выберите каталог, в котором будет создан OAuth-клиент.
        1. (Опционально) Добавьте описание и [метки](../../../../resource-manager/concepts/labels.md) приложения.
        1. Нажмите **Создать приложение**.
    1. На вкладке **Обзор** в блоке **Конфигурация поставщика удостоверений (IdP)** скопируйте значение **ClientID**.
    1. Создайте секрет приложения (действие доступно только для приложений [типа](../../../../organization/concepts/applications/oidc.md#oidc-application-types) `Web Application`).
       
       Для этого в блоке **Секреты приложения** нажмите кнопку **Добавить секрет** и в открывшемся окне:
       
       1. (Опционально) Добавьте произвольное описание создаваемого секрета.
       1. Нажмите **Создать**.
       
           В окне отобразится сгенерированный [секрет приложения](../../../../organization/concepts/applications/oidc.md#oidc-secret). Сохраните полученное значение.
       
           {% note warning %}
       
           После обновления или закрытия страницы с информацией о приложении посмотреть секрет будет невозможно.
       
           {% endnote %}
       
       Если вы закрыли или обновили страницу, не сохранив сгенерированный секрет, используйте кнопку **Добавить секрет**, чтобы создать новый.
       
       Чтобы удалить секрет, в списке секретов на странице OIDC-приложения в строке с нужным секретом нажмите значок ![ellipsis](../../../../_assets/console-icons/ellipsis.svg) и выберите ![trash-bin](../../../../_assets/console-icons/trash-bin.svg) **Удалить**.

{% endlist %}

## Создайте подключение в OpenCode Console {#oidc-create-connection}

1. Войдите в [OpenCode Console](https://opencode.ai/console) как владелец рабочего пространства и выберите нужное рабочее пространство.
1. Откройте **Settings** → **Security** и нажмите **Configure SSO**.
1. Выберите **OpenID Connect** и вариант настройки произвольного поставщика удостоверений **Custom OIDC**.
1. Заполните поля:

    * **Issuer URL** — `https://auth.yandex.cloud`.
    * **Client ID** — идентификатор OAuth-клиента, скопированный из Yandex Identity Hub.
    * **Client Secret** — секрет приложения, созданный в Yandex Identity Hub.
    * **Display Name** — имя поставщика удостоверений, например `Identity Hub OIDC`.

1. Нажмите **Save**. OpenCode Console проверит доступность поставщика удостоверений и активирует SSO.
1. Скопируйте точный адрес **Callback URL** из сохраненного подключения. Он имеет вид `https://opencode.ai/console/auth/sso/<идентификатор_подключения>/callback`.

{% note warning %}

Точный адрес **Callback URL** создается только после сохранения подключения. Не используйте шаблон адреса из формы настройки. До добавления этого адреса в Yandex Identity Hub вход через SSO работать не будет.

{% endnote %}

## Настройте адрес возврата и атрибуты {#oidc-redirect-uri}

{% list tabs group=instructions %}

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

    1. Вернитесь к OIDC-приложению в Yandex Identity Hub.
    1. Нажмите ![pencil](../../../../_assets/console-icons/pencil.svg) **Редактировать**.
    1. В поле **Redirect URI** вставьте точный **Callback URL**, скопированный из OpenCode Console. Поле **Post Logout Redirect URI** оставьте пустым.
    1. В поле **Scopes** выберите атрибуты `openid`, `email` и `profile`.
    1. В блоке **Безопасность OAuth/OIDC** отключите опцию **Требовать PKCE**, чтобы приложение Yandex Identity Hub при обмене данными не требовало от внешнего приложения использовать расширение безопасности [PKCE](*pkce_info).
       
       [*pkce_info]: PKCE — это расширение безопасности, применяемое в стандарте OAuth 2.0 с целью минимизировать риски перехвата аутентификационных данных. Подробнее читайте в разделе [PKCE](../../../../organization/concepts/applications/oidc.md#pkce).
    1. Нажмите **Сохранить**.

{% endlist %}

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

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

{% note info %}

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

{% endnote %}

{% list tabs group=instructions %}

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

    1. В сервисе [Yandex Identity Hub](https://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/).
* [Создать OIDC-приложение в Yandex Identity Hub](../../../../organization/operations/applications/oidc-create.md).

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

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

[*folder]: Каталог — это логическое пространство, в котором создаются и группируются ресурсы Yandex Cloud. Как и каталоги в файловой системе, каталоги в Yandex Cloud упрощают управление ресурсами. Подробнее читайте в разделе [Каталог](../../../../resource-manager/concepts/resources-hierarchy.md#folder).