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

SAML / SSO

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

Пользователь начинает вход в Клавдии, переходит на страницу IdP и после проверки возвращается в архив. Если требуется второй фактор, его проверяет IdP: Клавдий не запрашивает TOTP из профиля при входе через SAML.

Перед началом

  • Определите, какие учётные записи должны использовать сотрудники. См. {{ССЫЛКА:install.corporate-sign-in|Корпоративный вход: выбор способов аутентификации}}.
  • Подготовьте адрес входа и сертификат подписи IdP.
  • Синхронизируйте часы IdP и узлов Клавдия. Допустимое расхождение — 3 минуты.

Настройте 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 почтовому адресу и отображаемому имени. Если настройка не задана, используется NameID.
  4. Нажмите [Тест IdP] (!). Проверяется доступность метаданных и наличие службы SingleSignOnService.
  5. Включите конфигурацию и сохраните её.
  6. На стороне IdP зарегистрируйте Клавдий как доверяющую сторону: укажите фактический ACS URL и Entity ID из метаданных SP /saml/metadata.
  7. Настройте передачу имени пользователя и подпись ответа, как описано ниже.

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

{{СКРИНШОТ}}

Настройте имя пользователя

Клавдий находит учётную запись по NameID, переданному IdP. Формат имени в запросе входа Клавдий не задаёт: его определяет настройка клиента на IdP.

Учётные записи в Клавдии Значение NameID Пример
Синхронизированы из AD/LDAP userPrincipalName (UPN) ivanov@corp.example.ru
Созданы локально логин учётной записи ivanov

Если NameID совпадает с логином, сотрудник попадает в существующую учётную запись. Если совпадения нет, создаётся новая учётная запись с источником «SAML» и без локального пароля. Права учётной записи AD на неё не распространяются.

Пример для Keycloak с Active Directory

  1. В LDAP-федерации добавьте сопоставление userPrincipalName с атрибутом пользователя, например upn.
  2. В SAML-клиенте Клавдия добавьте [User Attribute Mapper For NameID] (!) с атрибутом upn и форматом urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified.
  3. Включите подпись ответа — [Sign documents] (!). Сертификат подписи области Keycloak укажите в настройках SAML Клавдия.

Проверьте результат

  1. Откройте страницу входа Клавдия и нажмите [Войти через корпоративный SSO] (!).
  2. Войдите на стороне IdP, включая второй фактор, если он настроен.
  3. После возврата проверьте логин, группы и доступные ящики. Должна использоваться та же учётная запись, что при входе паролем домена, если так настроен NameID.

Успешный [Тест IdP] (!) проверяет метаданные, но не заменяет эту проверку полного входа.

Если вход отклонён

Проверьте причину на странице ошибки и в журнале узла:

  • вход должен начинаться кнопкой Клавдия в том же браузере; вход, начатый на портале IdP, не поддерживается;
  • ответ должен быть адресован этому Клавдию: значения SP Entity ID и ACS URL должны совпадать с настройками;
  • подпись ответа должна проверяться сертификатом IdP;
  • часы IdP и Клавдия не должны расходиться более чем на 3 минуты;
  • один и тот же ответ нельзя использовать повторно. Для новой попытки начните вход заново.

Если вход выполнен, но ящики недоступны, проверьте NameID, выбранную учётную запись и {{ССЫЛКА:install.rbac|правила доступа}}.

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

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