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
- Откройте [Настройки] → [SSO (SAML)] (!).
- Нажмите [Добавить IdP] (!).
- Заполните параметры:
-
[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.
-
[URL IdP для входа (SSO)] (!) — адрес службы
- Нажмите [Тест IdP] (!). Проверяется доступность метаданных и наличие службы
SingleSignOnService. - Включите конфигурацию и сохраните её.
- На стороне IdP зарегистрируйте Клавдий как доверяющую сторону: укажите фактический ACS URL и Entity ID из метаданных SP
/saml/metadata. - Настройте передачу имени пользователя и подпись ответа, как описано ниже.
После настройки на странице входа появляется кнопка [Войти через корпоративный SSO] (!).
{{СКРИНШОТ}}
Настройте имя пользователя
Клавдий находит учётную запись по NameID, переданному IdP. Формат имени в запросе входа Клавдий не задаёт: его определяет настройка клиента на IdP.
| Учётные записи в Клавдии | Значение NameID |
Пример |
|---|---|---|
| Синхронизированы из AD/LDAP | userPrincipalName (UPN) |
ivanov@corp.example.ru |
| Созданы локально | логин учётной записи | ivanov |
Если NameID совпадает с логином, сотрудник попадает в существующую учётную запись. Если совпадения нет, создаётся новая учётная запись с источником «SAML» и без локального пароля. Права учётной записи AD на неё не распространяются.
Пример для Keycloak с Active Directory
- В LDAP-федерации добавьте сопоставление
userPrincipalNameс атрибутом пользователя, напримерupn. - В SAML-клиенте Клавдия добавьте [User Attribute Mapper For NameID] (!) с атрибутом
upnи форматомurn:oasis:names:tc:SAML:1.1:nameid-format:unspecified. - Включите подпись ответа — [Sign documents] (!). Сертификат подписи области Keycloak укажите в настройках SAML Клавдия.
Проверьте результат
- Откройте страницу входа Клавдия и нажмите [Войти через корпоративный SSO] (!).
- Войдите на стороне IdP, включая второй фактор, если он настроен.
- После возврата проверьте логин, группы и доступные ящики. Должна использоваться та же учётная запись, что при входе паролем домена, если так настроен
NameID.
Успешный [Тест IdP] (!) проверяет метаданные, но не заменяет эту проверку полного входа.
Если вход отклонён
Проверьте причину на странице ошибки и в журнале узла:
- вход должен начинаться кнопкой Клавдия в том же браузере; вход, начатый на портале IdP, не поддерживается;
- ответ должен быть адресован этому Клавдию: значения SP Entity ID и ACS URL должны совпадать с настройками;
- подпись ответа должна проверяться сертификатом IdP;
- часы IdP и Клавдия не должны расходиться более чем на 3 минуты;
- один и тот же ответ нельзя использовать повторно. Для новой попытки начните вход заново.
Если вход выполнен, но ящики недоступны, проверьте NameID, выбранную учётную запись и {{ССЫЛКА:install.rbac|правила доступа}}.
Связанные материалы
- {{ССЫЛКА:install.ldap-sync|Синхронизация пользователей и групп}}
- {{ССЫЛКА:install.users|Пользователи Клавдия}}
- {{ССЫЛКА:install.mfa|Многофакторная аутентификация}}
Навигация по книге
- Следующая статья: {{ССЫЛКА:install.imap-service|Настройка IMAP-сервера Клавдия}}