SAML / SSO
Клавдий поддерживает SAML 2.0 в роли поставщика услуг (Service , Provider,ProviderSP)SP (!)). В качестве пПоставщикаом удостоверений (Identity , Provider,ProviderIdP)IdP (!)) может быть ADFS, Microsoft Entra ID, Keycloak, Okta или другая SAML-совместимая система.
Пользователь начинает вход в Клавдии, переходит на страницу IdP и после проверки возвращается в архив. Если требуется второй фактор, его проверяет IdP: Клавдий не запрашивает TOTP из профиля при входе через SAML.
Перед началом
- Определите, какие учётные записи должны использовать
ADFS, Microsoft Entra ID (Azure AD), Keycloak, Okta и дсотругдниеки.SAML-сСм. {{ССЫЛКА:install.corporate-sign-in|Ковмесрпоратимвные системы.Прий входе:Клавдийыборперенаправляетспользсобователя на IdP. После успешнойаутентификации}}. - Подготовьте адрес вхо
звда и сертификащает подписи IdP. - Синхронизируйте ча
ннсыйSAML-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-ответа; его можно получитьиз метаданных IdP; -
[Маппинг атрибутов] — соответствие атрибутов SAML почтовому адресу и отображаемому имени
пользователя. Если настройка не задана, используетсяNameID.
-
[URL IdP для входа (SSO)] (!) — адрес службы
- Нажмите [Тест IdP] (!).
Клавдий запПроверяетсия доступность метаданные IdPх ипроверитналичие службыSingleSignOnService. - Включите конфигурацию и сохраните её.
- На стороне IdP зарегистрируйте Клавдий как доверяющую сторону
(relying party(!)):- укажите
- фактический ACS URL
—иhttps://klvd.example.ru/saml/acs; - Entity ID
— значениеиз метаданных SP/saml/metadata.
- фактический ACS URL
- Настройте передачу имени пользователя и подпись ответа, как описано ниже.
После настройки на странице входа появиляется кнопка [Войти через корпоративный 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-сервера Клавдия
}}