15. Настройка единого входа (SSO) в Okdesk через SAML
В Okdesk можно настроить единый вход (SSO), чтобы сотрудники и контакты использовали корпоративные учетные записи вместо отдельного логина и пароля Okdesk. Для этого Okdesk подключают к системе, которая проверяет учетные данные пользователей, — провайдеру удостоверений (IdP). Системы обмениваются данными по протоколу SAML.
Okdesk поддерживает подключение к трем провайдерам удостоверений: Keycloak, Microsoft Entra ID и AD FS. Ниже рассказали как настроить вход за 4 шага.
Шаг 1. Подготовьте подключение в Okdesk
Шаг 2. Настройте провайдера удостоверений
Шаг 3. Завершите подключение в Okdesk
Шаг 4. Включите SSO и проверьте вход
Как работает единый вход
Когда вы настроите SSO, на странице входа в Okdesk появится кнопка с названием подключения. Пользователь нажимает ее и переходит на страницу корпоративного провайдера удостоверений. Провайдер проверяет учетные данные пользователя и отправляет в Okdesk подтверждение успешного входа. Okdesk находит его учетную запись и предоставляет доступ в соответствии с назначенной ролью.
Как Okdesk определяет пользователя. Okdesk ищет учетную запись по полю «Логин» в карточке сотрудника или контакта. Значение, которое передает провайдер удостоверений, должно совпадать с логином в Okdesk. Регистр букв не имеет значения. Поле «Email» в карточке Okdesk для сопоставления учетных записей не используется.
Кому доступен единый вход. Вы сами определяете, кто будет входить в Okdesk через SSO. Можно разрешить единый вход всем сотрудникам, всем контактам, только контактам выбранной компании или одновременно сотрудникам и контактам.
Как настроить единый вход
Для настройки понадобятся права администратора Okdesk и доступ к настройкам корпоративного провайдера удостоверений.
Подключение настраивается последовательно в двух системах. Сначала вы начинаете подключение в Okdesk и получаете данные, которые нужны корпоративному провайдеру удостоверений. Затем настраиваете провайдера по инструкции для своей системы и получаете от него URL входа и сертификат. Эти данные нужно перенести обратно в Okdesk, чтобы завершить подключение. Ниже подробно разберем все этапы настройки единого входа: от подготовки подключения до проверки авторизации.
Важно. Не закрывайте форму настройки подключения в Okdesk до создания подключения. Настройку провайдера выполняйте в отдельной вкладке браузера. Если закрыть форму, введенные данные не сохранятся, а автоматически сформированный URL ответа (ACS) при повторном открытии может измениться.
Шаг 1. Подготовьте подключение в Okdesk
Откройте «Настройки» → «Провайдеры SSO» и нажмите «Добавить».
В форме «Новое SSO подключение» заполните основные поля.
Поле Что указать Название Название подключения, которое появится на кнопке входа в Okdesk. Например, «Корпоративный вход». Протокол Оставьте SAML. Тип провайдера удостоверений Выберите Keycloak, Microsoft Entra ID или Active Directory Federation Services. Разрешен вход для пользователей Выберите сотрудников, контактов или обе группы. Для контактов можно ограничить вход выбранной компанией.
Остальные поля пока не заполняйте. Часть данных Okdesk сформирует автоматически, остальные вы получите при настройке провайдера удостоверений.
Получите данные для настройки провайдера
Для подключения провайдеру понадобятся идентификатор Okdesk, URL ответа (ACS) и, в случае Keycloak, сертификат Okdesk. Все данные доступны в открытой форме.
1. Скопируйте идентификатор. В разделе «Настройки провайдера удостоверений (IdP)» найдите поле «Идентификатор (Entity ID / Issuer URL)». Okdesk заполняет его автоматически. Скопируйте значение поля и сохраните в текстовом документе. По этому идентификатору провайдер распознает Okdesk как подключенное приложение.
2. Скопируйте URL ответа (ACS). В разделе «Настройки приложения (SP)» найдите поле «URL ответа (ACS)». Okdesk формирует этот адрес автоматически. Скопируйте его с помощью кнопки справа от поля и сохраните в том же текстовом документе. На этот адрес провайдер будет отправлять ответ после проверки пользователя.
3. Экспортируйте сертификат Okdesk, если подключаете Keycloak. В разделе «Настройки приложения (SP)» нажмите «Экспортировать сертификат». Браузер скачает файл
sp_cert.crt. Сертификат нужен Keycloak для проверки подписи запросов Okdesk. В инструкциях для Microsoft Entra ID и AD FS загрузка этого сертификата не предусмотрена.Теперь у вас есть данные для настройки провайдера удостоверений. Пока не нажимайте «Добавить» и не закрывайте форму. Для создания подключения нужно заполнить еще два обязательных поля: «URL запроса (SSO Endpoint)» и «Сертификат». Эти данные вы получите от провайдера на следующем шаге.
Шаг 2. Настройте провайдера удостоверений
Теперь настройте подключение на стороне корпоративного провайдера удостоверений. Для этого используйте идентификатор и URL ответа, которые получили в Okdesk на шаге 1. Если подключаете Keycloak, дополнительно понадобится экспортированный сертификат Okdesk. Выберите инструкцию для своей системы и выполните описанные в ней действия. Подробная настройка каждого провайдера приведена в отдельном файле:
В каждой инструкции подробно описано, как настроить провайдера для работы с Okdesk, обеспечить передачу логина пользователя и получить данные для завершения подключения. Результат настройки — URL входа (SSO Endpoint) и сертификат провайдера удостоверений. Эти данные понадобятся в Okdesk. Сохраните их и вернитесь к форме подключения, которую оставили открытой на первом шаге.
Шаг 3. Завершите подключение в Okdesk
После настройки провайдера у вас есть URL входа и сертификат. Осталось передать эти данные в Okdesk и создать подключение. Вернитесь к форме «Новое SSO подключение», которую оставили открытой на первом шаге. В разделе «Настройки провайдера удостоверений (IdP)» заполните два поля:
Поле Что указать URL запроса (SSO Endpoint) Адрес входа, полученный при настройке провайдера удостоверений. По этому адресу Okdesk будет направлять пользователей для входа. Сертификат Сертификат провайдера удостоверений, полученный при настройке. Он нужен Okdesk для проверки подписи SAML-ответов.
Нажмите «Добавить». Подключение появится в списке «Провайдеры SSO» в выключенном состоянии. Пока оно выключено, пользователи не смогут входить через него.
Шаг 4. Включите SSO и проверьте вход
Чтобы пользователи могли входить через корпоративные учетные записи, включите созданное подключение. В списке «Провайдеры SSO» найдите подключение, включите переключатель рядом с ним и подтвердите действие кнопкой «Включить».
Важно. После включения SSO пользователи, которым разрешен вход через это подключение, больше не смогут входить по логину и паролю Okdesk. Если подключение разрешено всем сотрудникам, ограничение затронет и администраторов. Не завершайте текущий сеанс администратора, пока не проверите новый способ входа.
Проверьте вход через SSO
- Откройте страницу входа Okdesk в другом браузере или режиме инкогнито.
- Нажмите кнопку с названием подключения в блоке «или войти через».
- На странице провайдера удостоверений введите логин и пароль корпоративной учетной записи.
- Убедитесь, что после авторизации открылся Okdesk под нужной учетной записью.
Если вход разрешен всем сотрудникам и всем контактам, форма для ввода логина и пароля Okdesk на странице входа не отображается. Пользователи увидят только кнопку входа через SSO. Если вход не работает, вернитесь к открытой сессии администратора и выключите подключение в списке «Провайдеры SSO». Проверьте настройки провайдера и повторите попытку.
Загрузка данных...