Создать OIDC-приложение в Yandex Identity Hub для интеграции с OpenCode Console
Важно
Часть ресурсов, необходимых для прохождения практического руководства, доступны только в регионе Россия.
OpenCode Console
Руководство описывает настройку доступа к рабочему пространству в OpenCode Console. Настройка доступа к экземпляру OpenCode, запущенному локально или на сервере, не рассматривается.
Примечание
Управлять OIDC-приложениями может пользователь, которому назначена роль organization-manager.oauthApplications.admin или выше.
Чтобы настроить единый вход:
- Подготовьтесь к работе.
- Создайте OIDC-приложение и получите учетные данные.
- Создайте подключение в OpenCode Console.
- Настройте адрес возврата и атрибуты.
- Предоставьте пользователям доступ к приложению.
- Привяжите и подтвердите почтовый домен.
- Проверьте вход в рабочее пространство.
Перед началом работы
- Подготовьте организацию в Yandex Identity Hub. Если у вас еще нет организации, создайте ее.
- Убедитесь, что у вас есть рабочее пространство в OpenCode Console и роль Owner в нем. Настраивать SSO может только владелец рабочего пространства.
- Подготовьте почтовый домен вашей организации и убедитесь, что можете добавлять TXT-записи в его DNS-зону. Домен потребуется привязать к рабочему пространству и подтвердить в OpenCode Console.
- Убедитесь, что у пользователей, которые будут входить через SSO, в Yandex Identity Hub указан адрес электронной почты в этом домене.
- Подготовьте каталог, в котором будет создан OAuth-клиент.
Важно
После активации SSO администраторы и участники рабочего пространства должны входить через настроенного поставщика удостоверений. Владелец сохраняет возможность входа без SSO. Не закрывайте сессию владельца до завершения настройки и проверки входа.
Создайте OIDC-приложение и получите учетные данные
-
Войдите в сервис Yandex Identity Hub
. -
На панели слева выберите
Приложения. -
Нажмите
Создать приложение и в открывшемся окне:- Выберите метод единого входа OIDC (OpenID Connect).
-
В поле Тип приложения выберите тип Web Application.
OIDC-приложения типа
Web Applicationоптимально подходят для аутентификации пользователей во внешних веб-приложениях, имеющих серверную часть (бэкенд), в которой может безопасно храниться секрет приложения. Подробнее о типах OIDC-приложений читайте в разделе Типы OIDC-приложений в Yandex Identity Hub. - В поле Имя укажите имя приложения, например
opencode-oidc. - В поле Каталог выберите каталог, в котором будет создан OAuth-клиент.
- (Опционально) Добавьте описание и метки приложения.
- Нажмите Создать приложение.
-
На вкладке Обзор в блоке Конфигурация поставщика удостоверений (IdP) скопируйте значение ClientID.
-
Создайте секрет приложения (действие доступно только для приложений типа
Web Application).Для этого в блоке Секреты приложения нажмите кнопку Добавить секрет и в открывшемся окне:
-
(Опционально) Добавьте произвольное описание создаваемого секрета.
-
Нажмите Создать.
В окне отобразится сгенерированный секрет приложения. Сохраните полученное значение.
Важно
После обновления или закрытия страницы с информацией о приложении посмотреть секрет будет невозможно.
Если вы закрыли или обновили страницу, не сохранив сгенерированный секрет, используйте кнопку Добавить секрет, чтобы создать новый.
Чтобы удалить секрет, в списке секретов на странице OIDC-приложения в строке с нужным секретом нажмите значок
и выберите Удалить. -
Создайте подключение в OpenCode Console
-
Войдите в OpenCode Console
как владелец рабочего пространства и выберите нужное рабочее пространство. -
Откройте Settings → Security и нажмите Configure SSO.
-
Выберите OpenID Connect и вариант настройки произвольного поставщика удостоверений Custom OIDC.
-
Заполните поля:
- Issuer URL —
https://auth.yandex.cloud. - Client ID — идентификатор OAuth-клиента, скопированный из Yandex Identity Hub.
- Client Secret — секрет приложения, созданный в Yandex Identity Hub.
- Display Name — имя поставщика удостоверений, например
Identity Hub OIDC.
- Issuer URL —
-
Нажмите Save. OpenCode Console проверит доступность поставщика удостоверений и активирует SSO.
-
Скопируйте точный адрес Callback URL из сохраненного подключения. Он имеет вид
https://opencode.ai/console/auth/sso/<идентификатор_подключения>/callback.
Важно
Точный адрес Callback URL создается только после сохранения подключения. Не используйте шаблон адреса из формы настройки. До добавления этого адреса в Yandex Identity Hub вход через SSO работать не будет.
Настройте адрес возврата и атрибуты
- Вернитесь к OIDC-приложению в Yandex Identity Hub.
- Нажмите
Редактировать. - В поле Redirect URI вставьте точный Callback URL, скопированный из OpenCode Console. Поле Post Logout Redirect URI оставьте пустым.
- В поле Scopes выберите атрибуты
openid,emailиprofile. -
В блоке Безопасность OAuth/OIDC отключите опцию Требовать PKCE, чтобы приложение Yandex Identity Hub при обмене данными не требовало от внешнего приложения использовать расширение безопасности PKCE.
PKCE — это расширение безопасности, применяемое в стандарте OAuth 2.0 с целью минимизировать риски перехвата аутентификационных данных. Подробнее читайте в разделе PKCE.
- Нажмите Сохранить.
Предоставьте пользователям доступ к приложению
Пользователей или группы пользователей нужно явно добавить в созданное OIDC-приложение Yandex Identity Hub:
Примечание
Управлять пользователями и группами, добавленными в OIDC-приложение, может пользователь, которому назначена роль organization-manager.oauthApplications.userAdmin или выше.
- В сервисе Yandex Identity Hub
откройте Приложения и выберите созданное приложение. - Перейдите на вкладку Пользователи и группы.
- Нажмите
Добавить пользователей. - Выберите нужного пользователя или группу пользователей и нажмите Добавить.
Совет
Если вы хотите более тонко настроить аутентификацию пользователей в приложениях, в том числе разрешить аутентификацию только с определенных IP-адресов, используйте политики аутентификации.
Политики аутентификации — это инструмент Yandex Identity Hub, позволяющий гибко настраивать доступ к приложениям, запрещая или разрешая аутентификацию определенным пользователям в определенных приложениях и/или с определенных IP-адресов. Подробнее читайте в разделе Политики аутентификации в Yandex Identity Hub.
Привяжите и подтвердите почтовый домен
Домен нужно добавить и подтвердить именно в OpenCode Console. Подтверждение домена в Yandex Identity Hub не заменяет эту настройку.
-
В OpenCode Console откройте Settings → Security нужного рабочего пространства.
-
После активации SSO в блоке Email domains нажмите Add domain.
-
Укажите домен адресов электронной почты пользователей, например
example.com. -
В DNS-зоне домена создайте TXT-запись с именем и значением, которые покажет OpenCode Console. Запись имеет вид:
Параметр
Пример
Имя
_opencode-console-challenge.example.comТип
TXTЗначение
oc-verify=<код_подтверждения>Используйте код подтверждения из OpenCode Console, а не значение из примера.
-
Дождитесь обновления DNS-записей и нажмите Verify Domain в OpenCode Console. Если проверка не прошла, убедитесь, что запись корректна, и повторите попытку позже.
-
Убедитесь, что домен подтвержден. Если пользователи используют несколько почтовых доменов, повторите эти действия для каждого домена.
Примечание
К одному рабочему пространству можно привязать несколько доменов. Один и тот же домен нельзя привязать к нескольким рабочим пространствам.
Проверьте вход в рабочее пространство
- Откройте OpenCode Console
в приватном окне браузера, чтобы не использовать сессию владельца. - Начните вход с адресом электронной почты пользователя из подтвержденного домена. Пользователь должен быть добавлен в приложение Yandex Identity Hub напрямую или через группу.
- После перенаправления в Yandex Identity Hub выполните аутентификацию этого пользователя.
- Если учетная запись с таким адресом уже существует в OpenCode Console, подтвердите ее связывание кнопкой Link account, когда появится соответствующий запрос.
- Убедитесь, что пользователю доступно нужное рабочее пространство.
При первом входе через SSO пользователи из подтвержденного домена автоматически присоединяются к рабочему пространству с ролью Member. Исключения:
- у пользователя есть ожидающее приглашение;
- в рабочем пространстве настроена синхронизация каталога SCIM
; - используется подписка OpenCode Go
.
В этих случаях членство определяется приглашением, синхронизацией или условиями подписки. Подробнее в документации OpenCode
Полезные ссылки
Организация — это высший ресурс в иерархии ресурсной модели Yandex Cloud, который объединяет ресурсы всех остальных сервисов, а также используется для управления пользователями и параметрами их аутентификации и авторизации. Подробнее читайте в разделе Организация.
Пользователей Yandex Identity Hub можно объединять в группы, что упрощает управление доступом в Yandex Cloud. Подробнее читайте в разделе Группы пользователей.
Каталог — это логическое пространство, в котором создаются и группируются ресурсы Yandex Cloud. Как и каталоги в файловой системе, каталоги в Yandex Cloud упрощают управление ресурсами. Подробнее читайте в разделе Каталог.