К содержимому

Доступ и SSO ​

Space авторизует пользователей самостоятельно. Для него нужны отдельный домен и SAML-клиент. Cookie веб-интерфейса Orpheus не даёт доступ к Space. Круг пользователей каждого приложения задаётся в IdP.

Режим доступа ​

Режим задаётся ORPHEUS_BROWSER_AUTH на API Space.

РежимБраузерAPI-ключ
api_onlyБез доступа по cookieЧтение и запись
anonymousЧтение и запись без входаЧтение и запись
samlЧтение всех заданий, запись с учётом владельцаЧтение и запись

Используйте anonymous на изолированном локальном стенде. Этот режим и действительные API-ключи сохраняют полный доступ ко всем заданиям и их владельцам.

Точные правила API, Origin и CSRF.

Права на задания ​

Все вошедшие пользователи видят задания, историю и результаты. Задайте администраторов через access.admin_emails:

toml
[access]
admin_emails = ["admin@example.com"]
  • Администраторы создают и меняют любые задания, включая назначение и очистку владельца.
  • Остальные создают только на себя и меняют только свои задания. Они не могут передать задание другому человеку или присвоить общее.
  • Задания без владельца обычным пользователям доступны только для чтения.
  • Сессия без корректного email разрешает только просмотр.

Правила действуют для редактирования, ручного запуска, паузы, возобновления, удаления и сброса контекста, в том числе при прямых API-запросах с cookie. API-ключи сохраняют полный доступ. Если список администраторов пуст или отсутствует, полных прав через браузер нет ни у кого. После изменения списка перезапустите API. Действующие сессии получают новые права без повторного входа.

Настройка SAML ​

Передайте API Space настройки SAML:

dotenv
ORPHEUS_BROWSER_AUTH=saml
ORPHEUS_PUBLIC_URL=https://space.example.com
SAML_SP_ENTITY_ID=orpheus-space
SAML_IDP_METADATA_FILE=/etc/orpheus-space/idp.xml
SAML_SP_CERT_FILE=/etc/orpheus-space/sp.crt
SAML_SP_KEY_FILE=/run/secrets/space-sp.key
BROWSER_SESSION_TTL_SECONDS=43200
  1. Подготовьте сертификат SP и соответствующий приватный ключ.
  2. Создайте отдельный SAML-клиент IdP с entity ID orpheus-space. Разрешите вход нужной группе сотрудников.
  3. Задайте ACS https://space.example.com/auth/callback, binding HTTP-POST.
  4. Настройте проверку подписей запросов сертификатом SP и подпись ответов/assertions через SHA-256.
  5. Настройте стабильный NameID и AuthnStatement, как при настройке SSO Orpheus.
  6. Передайте SAML-атрибут с Name или FriendlyName email. В Keycloak добавьте User Property mapper: свойство пользователя email → SAML-атрибут email. Этот email определяет владельца и права администратора. IdP должен подтверждать адрес и запрещать пользователям произвольно назначать себе чужие адреса.
  7. Выгрузите метаданные IdP, смонтируйте их вместе с сертификатом и ключом в API и перезапустите его.
  8. Откройте Space, выполните вход и проверьте создание задания на паузе. Метаданные SP доступны по /saml/metadata.

Space также принимает email из NameID в формате email. Если email отсутствует или некорректен, вход работает, но сессия разрешает только чтение. После изменения mapping выйдите из Space и войдите снова, чтобы обновить email в сессии.

Можно использовать ту же SP-пару, что у Orpheus, если она зарегистрирована и у клиента Space. Домены, клиенты и браузерные сессии приложений остаются отдельными. Worker Space не нужны SAML-файлы.

Выход ​

Выход завершает локальную сессию Space. Сессии IdP и веб-интерфейса Orpheus сохраняются, поэтому повторный вход может пройти без ввода пароля.

Доступ к приложению задавайте правилами IdP, полный доступ к заданиям — списком администраторов. Навык агента использует API-ключ с полным доступом и отдельно учитывает личность автора сообщения.