Вход через SSO
Режим браузерного доступа задаётся на API, а не на web.
ORPHEUS_BROWSER_AUTH | Чтение | Управление шаблонами | Команды сессиям |
|---|---|---|---|
api_only | Bearer-ключ | Bearer-ключ | Bearer-ключ |
anonymous | Без входа | Браузер или Bearer-ключ | Bearer-ключ |
saml | SSO или Bearer-ключ | SSO или Bearer-ключ | Bearer-ключ |
anonymous подходит для изолированного локального стенда. Все пользователи, допущенные через SAML, видят общую историю. Ограничьте круг пользователей на стороне IdP.
Настройка SAML
Передайте API следующие переменные окружения:
ORPHEUS_BROWSER_AUTH=saml
ORPHEUS_PUBLIC_URL=https://orpheus.example.com
SAML_SP_ENTITY_ID=orpheus-web
SAML_IDP_METADATA_FILE=/etc/orpheus/saml/idp.xml
SAML_SP_CERT_FILE=/etc/orpheus/saml/sp.crt
SAML_SP_KEY_FILE=/run/secrets/orpheus-saml.key
BROWSER_SESSION_TTL_SECONDS=43200- Создайте сертификат и соответствующий приватный ключ SP (RSA или ECDSA).
- Создайте SAML-клиент в IdP с entity ID
orpheus-web. - Укажите ACS
https://orpheus.example.com/auth/callback, binding HTTP-POST. - Включите проверку подписей запросов сертификатом SP и подпись ответов и assertions через SHA-256.
- Настройте стабильный NameID и AuthnStatement. В Keycloak параметр
saml.authnstatementдолжен бытьtrue. - Выгрузите метаданные IdP. Смонтируйте XML, сертификат и ключ в API по указанным путям.
- Пересоздайте API и проверьте вход. Метаданные SP доступны на
/saml/metadata.
ORPHEUS_PUBLIC_URL содержит внешний HTTPS-origin веб-интерфейса без завершающего слеша. Worker не нужны SAML-файлы.
Выход завершает сессию Orpheus. Общая сессия в IdP сохраняется. Настройки Keycloak.
Управление шаблонами из браузера
Все SAML-пользователи могут добавлять, редактировать и удалять шаблоны. У локального анонимного доступа такие же права. Для браузерных изменений нужны точный Origin из ORPHEUS_PUBLIC_URL и заголовок X-Orpheus-CSRF: 1. Orpheus Web отправляет их сам. Для локального доступа задайте ORPHEUS_PUBLIC_URL=http://localhost:8085 и открывайте этот адрес.
Другой origin или отсутствующий CSRF-заголовок возвращает 403 invalid_origin. С действующим Bearer-ключом эти заголовки не нужны. Неверный Authorization возвращает 401, даже если браузерная сессия существует.