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

Вход через SSO ​

Режим браузерного доступа задаётся на API, а не на web.

ORPHEUS_BROWSER_AUTHЧтениеУправление шаблонамиКоманды сессиям
api_onlyBearer-ключBearer-ключBearer-ключ
anonymousБез входаБраузер или Bearer-ключBearer-ключ
samlSSO или Bearer-ключSSO или Bearer-ключBearer-ключ

anonymous подходит для изолированного локального стенда. Все пользователи, допущенные через SAML, видят общую историю. Ограничьте круг пользователей на стороне IdP.

Настройка SAML ​

Передайте API следующие переменные окружения:

dotenv
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
  1. Создайте сертификат и соответствующий приватный ключ SP (RSA или ECDSA).
  2. Создайте SAML-клиент в IdP с entity ID orpheus-web.
  3. Укажите ACS https://orpheus.example.com/auth/callback, binding HTTP-POST.
  4. Включите проверку подписей запросов сертификатом SP и подпись ответов и assertions через SHA-256.
  5. Настройте стабильный NameID и AuthnStatement. В Keycloak параметр saml.authnstatement должен быть true.
  6. Выгрузите метаданные IdP. Смонтируйте XML, сертификат и ключ в API по указанным путям.
  7. Пересоздайте 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, даже если браузерная сессия существует.