Перейти к основному контенту

SAML / SSO

Клавдий поддерживает SAML 2.0 в роли поставщика услуг (Service Provider, SP). В качестве поставщика удостоверений (Identity Provider, IdP) можно использовать ADFS, Microsoft Entra ID (Azure AD), Keycloak, Okta и другие SAML-совместимые системы.

При входе Клавдий перенаправляет пользователя на IdP. После успешной аутентификации IdP возвращает подписанный SAML-ответ. Клавдий проверяет подпись, затем находит существующую учётную запись или создаёт новую с источником «SAML» без локального пароля.

Настройте SAML

  1. Откройте [Настройки → SSO (SAML)].
  2. Нажмите [Добавить IdP].
  3. Заполните параметры:
    • [URL IdP для входа (SSO)] — адрес службы SingleSignOnService, на которую Клавдий перенаправляет пользователя;
    • [SP Entity ID] — уникальный идентификатор Клавдия, например https://klvd.example.ru/saml/metadata;
    • [ACS URL] — адрес приёма SAML-ответа, например https://klvd.example.ru/saml/acs; если поле оставить пустым, адрес вычисляется автоматически;
    • [Сертификат IdP (PEM)] — сертификат подписи IdP для проверки SAML-ответа; его можно получить из метаданных IdP;
    • [Маппинг атрибутов] — соответствие атрибутов SAML почтовому адресу и отображаемому имени пользователя. Если настройка не задана, используется NameID.
  4. Нажмите [Тест IdP]. Клавдий запросит метаданные IdP и проверит наличие службы SingleSignOnService.
  5. Включите конфигурацию и сохраните её.
  6. На стороне IdP зарегистрируйте Клавдий как доверяющую сторону (relying party (!)):
    • ACS URL — https://klvd.example.ru/saml/acs;
    • Entity ID — значение из метаданных SP /saml/metadata.

После настройки на странице входа появится кнопка [Войти через корпоративный SSO].

Связанные материалы

Навигация по книге