Доступ и 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:
[access]
admin_emails = ["admin@example.com"]- Администраторы создают и меняют любые задания, включая назначение и очистку владельца.
- Остальные создают только на себя и меняют только свои задания. Они не могут передать задание другому человеку или присвоить общее.
- Задания без владельца обычным пользователям доступны только для чтения.
- Сессия без корректного email разрешает только просмотр.
Правила действуют для редактирования, ручного запуска, паузы, возобновления, удаления и сброса контекста, в том числе при прямых API-запросах с cookie. API-ключи сохраняют полный доступ. Если список администраторов пуст или отсутствует, полных прав через браузер нет ни у кого. После изменения списка перезапустите API. Действующие сессии получают новые права без повторного входа.
Настройка SAML
Передайте API Space настройки SAML:
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- Подготовьте сертификат SP и соответствующий приватный ключ.
- Создайте отдельный SAML-клиент IdP с entity ID
orpheus-space. Разрешите вход нужной группе сотрудников. - Задайте ACS
https://space.example.com/auth/callback, binding HTTP-POST. - Настройте проверку подписей запросов сертификатом SP и подпись ответов/assertions через SHA-256.
- Настройте стабильный NameID и AuthnStatement, как при настройке SSO Orpheus.
- Передайте SAML-атрибут с Name или FriendlyName
email. В Keycloak добавьте User Property mapper: свойство пользователяemail→ SAML-атрибутemail. Этот email определяет владельца и права администратора. IdP должен подтверждать адрес и запрещать пользователям произвольно назначать себе чужие адреса. - Выгрузите метаданные IdP, смонтируйте их вместе с сертификатом и ключом в API и перезапустите его.
- Откройте Space, выполните вход и проверьте создание задания на паузе. Метаданные SP доступны по
/saml/metadata.
Space также принимает email из NameID в формате email. Если email отсутствует или некорректен, вход работает, но сессия разрешает только чтение. После изменения mapping выйдите из Space и войдите снова, чтобы обновить email в сессии.
Можно использовать ту же SP-пару, что у Orpheus, если она зарегистрирована и у клиента Space. Домены, клиенты и браузерные сессии приложений остаются отдельными. Worker Space не нужны SAML-файлы.
Выход
Выход завершает локальную сессию Space. Сессии IdP и веб-интерфейса Orpheus сохраняются, поэтому повторный вход может пройти без ввода пароля.
Доступ к приложению задавайте правилами IdP, полный доступ к заданиям — списком администраторов. Навык агента использует API-ключ с полным доступом и отдельно учитывает личность автора сообщения.