"Интеграция с SSO" (ModSSOService)

Owned by Anna Gorovaya (Unlicensed)
Last updated: Apr 25, 2024 by Александр Исобаев
4 min read

Позволяет работать с сервисом Single Sign On.

Кому будет полезен этот мод:

Это клиентский мод. Он доступен для подключения и использования только клиентам.

Он будет полезен клиентам, желающим использовать сервис SSO Corteos

Подключение мода:

Для подключения мода необходимо перейти в раздел “Marketplace”

 

Настройка МОДа:

Для перехода к настройке SSO необходимо перейти на prd.sso.corteos.ru

  • Для ознакомления с типами доступных протоколов необходимо нажать на название протокола в выделенном разделе.

 

  • Для ознакомления с рекомендуемым процессом создания подключения необходимо нажать “Learn More” в разделе WorkFlow.

 

  • Для начала работы необходимо войти в сервис SSO.

 

Для авторизации необходимо указать:

  • Email тревел менеджера

  • Пароль тревел менеджера

  • ID компании для API (необходимо уточнить у сотрудника агента)

И пройти проверку reCAPTCHA.

После регистрации необходимо указать SSO-параметры на вкладке Edit SSO parameters:

  • Type - тип используемого протокола (SAML или SAPLT)

  • User redirect link - ссылка переадресации. Например: “https://domain.com/Mods/SSOEntance/Go”

  • User for callbacks - почта для отправки коллбэков. Необязательное поле

  • Serial Number - серийный номер (Номер сертификата, выпускаемый на стороне клиента)

Для подтверждения и сохранения изменений необходимо нажать “Save”

Дополнительной на портале является вкладка Customized errors.

На данной вкладке можно настроить кастомный вид ошибок, которые могут возникнуть у пользователя при использовании SSO.

Например, при попытке перехода пользователем, у которого отсутствует учетная запись, стандартный вид ошибки:

На вкладке кастомизации ошибок можно настроить нужный вам текст, а также вставить изображение, например:

Для того, чтобы кастомизировать ошибку, на вкладке Customized errors требуется нажать на кнопку “Create”.

Далее требуется заполнить параметры ошибки:

Error name - имя ошибки, должно строго соответствовать и не быть пустым, иначе кастомизация не сработает. Например “AccessViolationException”.

Error image - изображение ошибки. Для загрузки изображения требуется нажать “Choose File…”

Изображение всегда идет перед текстом (в случае его наличия), максимально возможный размер - 100 килобайт, ширина - 600 px.

Рекомендуется загружать изображения в формате png.

Error text - текст ошибки. Для ввода текста используется редактор html.

Разрешенные в редакторе теги: <b>, <i>, <u>, <strong>, <em>, <br>, <hr>, <p>.

<b>, <strong> - жирное выделение текста

<i>, <em> - выделение текста курсивом

<u> - подчеркнутый текст

<br> - перенос строки

<hr> - горизонтальная линия, разделяющая текст

<p> - абзац

Текст ошибки имеет ограничение в 1000 символов.

Можно вставить либо изображение, либо текст, либо изображение и текст вместе.

После заполнения параметров требуется нажать кнопку “Save”.

Наполненный пример:

Вызываемая кастомизированная ошибка:

Разные типы ошибок могут содержать разный текст, рекомендуем кастомизировать их более обширно, чтобы не вводить в заблуждение пользователей.

Админка мода

В настройках мода есть возможность настроить две опции:

  • Назначать коды командировки при входе в систему

  • Пропускать страницу установки кодов. (При включенном переключателе происходит принудительное автосохранение кодов. )

 

Работа с модом

После подключения этот мод позволяет работать в сервисе SSO Corteos.
При использовании SSO Corteos пользователи будут иметь возможность перемещаться с внутреннего портала компании в онлайн кабинет и обратно без использования дополнительной аутентификации.