Yandex Cloud
КейсыДокументация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»
Практические руководства
    • Все руководства
    • Разграничение прав доступа для групп пользователей
    • Приглашение нового пользователя и назначение ролей
    • Создание L7-балансировщика с профилем безопасности Smart Web Security через Ingress-контроллер Application Load Balancer
    • Создание распределенной инфраструктуры с защищенным доступом
    • Централизованная публикация в интернете и защита приложений от DDoS
    • Базовая настройка SWS
    • Подключение SolidWall WAF к веб-приложению
    • Экстренная защита сервисов в Application Load Balancer от DDoS на уровне L7
    • Передача логов с виртуальной машины в Cloud Logging
    • Запись логов балансировщика в PostgreSQL
    • Безопасное хранение паролей для GitLab CI в виде секретов Yandex Lockbox
    • Сервисный аккаунт с профилем OS Login для управления ВМ с помощью Ansible
    • Передача логов с Container Optimized Image в Cloud Logging
    • Добавление HTML-страницы для работы SmartCaptcha
    • Настройка алертов и дашбордов в Monium
    • Загрузка аудитных логов в SIEM Splunk
    • Загрузка аудитных логов в SIEM ArcSight
    • Шифрование для бакета Object Storage на стороне сервера
    • Шифрование секретов в HashiCorp Terraform
    • Управление ключами KMS с HashiCorp Terraform
    • Auto Unseal в HashiCorp Vault
      • 1С:Предприятие
      • Grafana OSS
      • Harbor
      • Managed Service for GitLab
      • Managed Service for OpenSearch
      • MWS
      • NetBird
        • SAML
        • OpenID Connect
      • OpenSearch
      • Open WebUI
      • Sentry
      • SonarQube
      • VK Cloud
      • Zabbix
      • МТС Линк
      • Пассворк
      • Яндекс 360
      • Яндекс Браузер для организаций
      • Использование OAuth2 Proxy для приложений, не поддерживающих SSO
    • Передача логов кластера Yandex MPP Analytics for PostgreSQL в Yandex Cloud Logging
    • Получение сведений для запроса на включение ресурса в белый список Минцифры
    • Загрузка объектов в бакет Object Storage с помощью эфемерного ключа доступа
    • Интеграция LiteLLM Proxy с Yandex AI Studio и Monium Traces
    • Использование внешних политик Kyverno с KSPM

В этой статье:

  • Перед началом работы
  • Создайте OIDC-приложение и получите учетные данные
  • Создайте подключение в OpenCode Console
  • Настройте адрес возврата и атрибуты
  • Предоставьте пользователям доступ к приложению
  • Привяжите и подтвердите почтовый домен
  • Проверьте вход в рабочее пространство
  1. Безопасность
  2. Настройка единого входа в приложения (SSO)
  3. OpenCode Console
  4. OpenID Connect

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

Статья создана
Yandex Cloud
Обновлена 19 ноября 2026 г.
Открыть в Markdown
  • Перед началом работы
  • Создайте OIDC-приложение и получите учетные данные
  • Создайте подключение в OpenCode Console
  • Настройте адрес возврата и атрибуты
  • Предоставьте пользователям доступ к приложению
  • Привяжите и подтвердите почтовый домен
  • Проверьте вход в рабочее пространство

OpenCode Console позволяет управлять рабочими пространствами (workspaces) и настраивать единый вход (SSO) для их участников. Чтобы пользователи вашей организации могли входить в рабочее пространство с помощью Yandex Identity Hub, создайте OIDC-приложение и настройте интеграцию по протоколу OpenID Connect (OIDC).

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

Примечание

  • Для одного рабочего пространства можно настроить только одно подключение SSO: либо SAML, либо OIDC. Использовать оба протокола одновременно нельзя.
  • К рабочему пространству можно привязать несколько почтовых доменов, но каждый домен может принадлежать только одному рабочему пространству.

Управлять OIDC-приложениями может пользователь, которому назначена роль organization-manager.oauthApplications.admin или выше.

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

  1. Подготовьтесь к работе.
  2. Создайте OIDC-приложение и получите учетные данные.
  3. Создайте подключение в OpenCode Console.
  4. Настройте адрес возврата и атрибуты.
  5. Предоставьте пользователям доступ к приложению.
  6. Привяжите и подтвердите почтовый домен.
  7. Проверьте вход в рабочее пространство.

Перед началом работыПеред началом работы

  1. Подготовьте организацию в Yandex Identity Hub. Если у вас еще нет организации, создайте ее.
  2. Убедитесь, что у вас есть рабочее пространство в OpenCode Console и роль Owner в нем. Настраивать SSO может только владелец рабочего пространства.
  3. Подготовьте почтовый домен вашей организации и убедитесь, что можете добавлять TXT-записи в его DNS-зону. Домен потребуется привязать к рабочему пространству и подтвердить в OpenCode Console.
  4. Убедитесь, что у пользователей, которые будут входить через SSO, в Yandex Identity Hub указан адрес электронной почты в этом домене.
  5. Подготовьте каталог, в котором будет создан OAuth-клиент.

Важно

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

Создайте OIDC-приложение и получите учетные данныеСоздайте OIDC-приложение и получите учетные данные

Интерфейс Cloud Center
  1. Войдите в сервис Yandex Identity Hub.

  2. На панели слева выберите Приложения.

  3. Нажмите Создать приложение и в открывшемся окне:

    1. Выберите метод единого входа OIDC (OpenID Connect).
    2. В поле Тип приложения выберите тип Web Application.

      OIDC-приложения типа Web Application оптимально подходят для аутентификации пользователей во внешних веб-приложениях, имеющих серверную часть (бэкенд), в которой может безопасно храниться секрет приложения. Подробнее о типах OIDC-приложений читайте в разделе Типы OIDC-приложений в Yandex Identity Hub.

    3. В поле Имя укажите имя приложения, например opencode-oidc.
    4. В поле Каталог выберите каталог, в котором будет создан OAuth-клиент.
    5. (Опционально) Добавьте описание и метки приложения.
    6. Нажмите Создать приложение.
  4. На вкладке Обзор в блоке Конфигурация поставщика удостоверений (IdP) скопируйте значение ClientID.

  5. Создайте секрет приложения (действие доступно только для приложений типа Web Application).

    Для этого в блоке Секреты приложения нажмите кнопку Добавить секрет и в открывшемся окне:

    1. (Опционально) Добавьте произвольное описание создаваемого секрета.

    2. Нажмите Создать.

      В окне отобразится сгенерированный секрет приложения. Сохраните полученное значение.

      Важно

      После обновления или закрытия страницы с информацией о приложении посмотреть секрет будет невозможно.

    Если вы закрыли или обновили страницу, не сохранив сгенерированный секрет, используйте кнопку Добавить секрет, чтобы создать новый.

    Чтобы удалить секрет, в списке секретов на странице OIDC-приложения в строке с нужным секретом нажмите значок и выберите Удалить.

Создайте подключение в OpenCode ConsoleСоздайте подключение в OpenCode Console

  1. Войдите в OpenCode Console как владелец рабочего пространства и выберите нужное рабочее пространство.

  2. Откройте Settings → Security и нажмите Configure SSO.

  3. Выберите OpenID Connect и вариант настройки произвольного поставщика удостоверений Custom OIDC.

  4. Заполните поля:

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

  6. Скопируйте точный адрес Callback URL из сохраненного подключения. Он имеет вид https://opencode.ai/console/auth/sso/<идентификатор_подключения>/callback.

Важно

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

Настройте адрес возврата и атрибутыНастройте адрес возврата и атрибуты

Интерфейс Cloud Center
  1. Вернитесь к OIDC-приложению в Yandex Identity Hub.
  2. Нажмите Редактировать.
  3. В поле Redirect URI вставьте точный Callback URL, скопированный из OpenCode Console. Поле Post Logout Redirect URI оставьте пустым.
  4. В поле Scopes выберите атрибуты openid, email и profile.
  5. В блоке Безопасность OAuth/OIDC отключите опцию Требовать PKCE, чтобы приложение Yandex Identity Hub при обмене данными не требовало от внешнего приложения использовать расширение безопасности PKCE.

    PKCE — это расширение безопасности, применяемое в стандарте OAuth 2.0 с целью минимизировать риски перехвата аутентификационных данных. Подробнее читайте в разделе PKCE.

  6. Нажмите Сохранить.

Предоставьте пользователям доступ к приложениюПредоставьте пользователям доступ к приложению

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

Примечание

Управлять пользователями и группами, добавленными в OIDC-приложение, может пользователь, которому назначена роль organization-manager.oauthApplications.userAdmin или выше.

Интерфейс Cloud Center
  1. В сервисе Yandex Identity Hub откройте Приложения и выберите созданное приложение.
  2. Перейдите на вкладку Пользователи и группы.
  3. Нажмите Добавить пользователей.
  4. Выберите нужного пользователя или группу пользователей и нажмите Добавить.

Совет

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

Политики аутентификации — это инструмент Yandex Identity Hub, позволяющий гибко настраивать доступ к приложениям, запрещая или разрешая аутентификацию определенным пользователям в определенных приложениях и/или с определенных IP-адресов. Подробнее читайте в разделе Политики аутентификации в Yandex Identity Hub.

Привяжите и подтвердите почтовый доменПривяжите и подтвердите почтовый домен

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

  1. В OpenCode Console откройте Settings → Security нужного рабочего пространства.

  2. После активации SSO в блоке Email domains нажмите Add domain.

  3. Укажите домен адресов электронной почты пользователей, например example.com.

  4. В DNS-зоне домена создайте TXT-запись с именем и значением, которые покажет OpenCode Console. Запись имеет вид:

    Параметр

    Пример

    Имя

    _opencode-console-challenge.example.com

    Тип

    TXT

    Значение

    oc-verify=<код_подтверждения>

    Используйте код подтверждения из OpenCode Console, а не значение из примера.

  5. Дождитесь обновления DNS-записей и нажмите Verify Domain в OpenCode Console. Если проверка не прошла, убедитесь, что запись корректна, и повторите попытку позже.

  6. Убедитесь, что домен подтвержден. Если пользователи используют несколько почтовых доменов, повторите эти действия для каждого домена.

Примечание

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

Проверьте вход в рабочее пространствоПроверьте вход в рабочее пространство

  1. Откройте OpenCode Console в приватном окне браузера, чтобы не использовать сессию владельца.
  2. Начните вход с адресом электронной почты пользователя из подтвержденного домена. Пользователь должен быть добавлен в приложение Yandex Identity Hub напрямую или через группу.
  3. После перенаправления в Yandex Identity Hub выполните аутентификацию этого пользователя.
  4. Если учетная запись с таким адресом уже существует в OpenCode Console, подтвердите ее связывание кнопкой Link account, когда появится соответствующий запрос.
  5. Убедитесь, что пользователю доступно нужное рабочее пространство.

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

  • у пользователя есть ожидающее приглашение;
  • в рабочем пространстве настроена синхронизация каталога SCIM;
  • используется подписка OpenCode Go.

В этих случаях членство определяется приглашением, синхронизацией или условиями подписки. Подробнее в документации OpenCode.

Полезные ссылкиПолезные ссылки

  • Настройка SSO в OpenCode Console.
  • Создать OIDC-приложение в Yandex Identity Hub.

Организация — это высший ресурс в иерархии ресурсной модели Yandex Cloud, который объединяет ресурсы всех остальных сервисов, а также используется для управления пользователями и параметрами их аутентификации и авторизации. Подробнее читайте в разделе Организация.

Пользователей Yandex Identity Hub можно объединять в группы, что упрощает управление доступом в Yandex Cloud. Подробнее читайте в разделе Группы пользователей.

Каталог — это логическое пространство, в котором создаются и группируются ресурсы Yandex Cloud. Как и каталоги в файловой системе, каталоги в Yandex Cloud упрощают управление ресурсами. Подробнее читайте в разделе Каталог.

Была ли статья полезна?

Предыдущая
SAML
Следующая
OpenSearch
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»