Yandex Cloud
Документация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 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

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

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

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

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

Важно

Часть ресурсов, необходимых для прохождения практического руководства, доступны только в регионе Россия.

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

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

Примечание

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

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

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

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

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

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

Важно

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

Получите параметры OpenCode ConsoleПолучите параметры OpenCode Console

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

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

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

  4. На шаге 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-приложение

Интерфейс Cloud Center
  1. В другой вкладке браузера откройте сервис Yandex Identity Hub.

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

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

    1. Выберите метод единого входа SAML (Security Assertion Markup Language).
    2. В поле Имя укажите имя приложения, например opencode-saml.
    3. (Опционально) Добавьте описание и метки приложения.
    4. Нажмите Создать приложение.
  4. На странице созданного приложения нажмите Редактировать и задайте настройки:

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

    Поле SP Logout URL оставьте пустым.

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

  6. Настройте передачу адреса электронной почты пользователя:

    1. Перейдите на вкладку Атрибуты.
    2. Нажмите Добавить атрибут.
    3. В поле Имя атрибута укажите email.
    4. В поле Значение выберите SubjectClaims.email.
    5. Нажмите Добавить.

    Если атрибут email уже есть, проверьте его значение вместо создания нового атрибута.

  7. Перейдите на вкладку Обзор и в блоке Конфигурация поставщика удостоверений (IdP) скопируйте значение поля Metadata URL.

Примечание

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

Активируйте SAML в OpenCode ConsoleАктивируйте SAML в OpenCode Console

  1. Вернитесь к настройке Custom SAML в OpenCode Console и нажмите Next.

  2. На шаге Add provider details в поле IdP Metadata вставьте URL метаданных приложения, скопированный из Yandex Identity Hub.

  3. Нажмите Fetch. Проверьте, что заполнились поля IdP Entity ID, IdP SSO URL и IdP Certificate.

    Вместо загрузки по URL можно использовать Upload XML и загрузить файл метаданных, скачанный со страницы SAML-приложения в Yandex Identity Hub.

  4. В поле Display Name укажите имя поставщика удостоверений, например Identity Hub SAML.

  5. Нажмите Next.

  6. На шаге Review проверьте параметры и нажмите Activate SSO.

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

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

Примечание

Управлять пользователями и группами, добавленными в SAML-приложение, может пользователь, которому назначена роль organization-manager.samlApplications.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.
  • Создать SAML-приложение в Yandex Identity Hub.

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

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

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

Предыдущая
NetBird
Следующая
OpenID Connect
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»