2. Аутентификация в клиентском портале из интерфейса Wialon
Ещё один из реализованных сценариев интеграции — возможности сквозной аутентификации контактных лиц в клиентском портале Okdesk прямо из интерфейса Wialon.
Проблематика. Зачем и кому нужна сквозная аутентификация в Okdesk из Wialon?
Многие компании-интеграторы систем мониторинга транспорта (СМТ) используют в своем бизнесе платформу Wialon. Клиенты интеграторов следят и управляют своим автопарком непосредственно из клиентского интерфейса системы мониторинга. Для подачи заявок на обслуживание контактным лицам клиента необходимо использовать одну из следующих возможностей:
- клиентский портал, то есть переходить в интерфейс Okdesk и вводить свой логин и пароль для того чтобы оставить заявку на обслуживание или добавить уточнения по ранее поданным заявкам;
- отправить заявку на электронную почту (Okdesk автоматически по "умному" алгоритму зарегистрирует эту заявку в привязке к клиенту);
- мобильное приложение для заявителей;
- позвонить диспетчеру (в случае наличия у интегратора горячей линии), а он через готовую интеграцию Okdesk и АТС зарегистрирует заявку;
- Telegram-бот для клиентов.
Клиентский портал по нашей статистике один из самых популярных способов подачи заявки в службу поддержки у клиентов наших клиентов. И именно этот способ хочется сделать еще проще и удобнее. Что если исключить необходимость введения логина и пароля в Okdesk? Ведь пользователь уже "залогинен" в Wialon-е. Если Okdesk научится "доверять" Wialon-у, то пользователю достаточно будет в интерфейсе Wialon-а кликнуть на ссылку “Перейти в Okdesk” чтобы оказаться в клиентском портале Okdesk-а. Именно это мы и сделали!Как это работает?
В Wialon есть возможность создавать собственные приложения. В самом простом виде, приложение — это ссылка в интерфейсе пользователя, которая ведёт на заданный адрес и передает в ссылке заданную информацию. Например, можно передать в ссылке имя пользователя в Wialon и аутентификационный код, по которому внешняя система может удостовериться, что в настоящий момент времени пользователь с переданным именем аутентифицирован в Wialon.
Так и работает сквозная аутентификация пользователей из Wialon в Okdesk. Вы создаете приложение, и при клике на это приложениев интерфейсе Wialon-а пользователь переходит по ссылке в Okdesk, при этом сама ссылка содержит служебную информацию из Wialon (имя пользователя и аутентификационный токен):
- Okdesk проверяет, что переданное имя пользователя есть в базе логинов контактных лиц (подчеркнем, что аутентификация работает только для контактных лиц);
- Okdesk проверяет, что контактное лицо с таким логином аутентифицировано в Wialon-е (по переданному аутентификационному токену);
- Если все проверки прошли успешно — пользователь оказывается в клиентском портале Okdesk, может создать новую заявку или оставить дополнение к ранее поданным.
Как настроить интеграцию между Wialon и Okdesk
Создайте приложение “Клиентский портал Okdesk” в Wialon
Общую инструкцию по созданию приложений, необходимых прав и подключенных сервисов можно найти в документации Wialon.
При создании приложения “Клиентский портал Okdesk” необходимо задать следующие настройки:
- URL https://адрес_аккаунта/wialonauth (в качестве адреса аккаунта указывается либо название_аккаунта.okdesk.ru, либо припаркованный домен);
- В дополнительных параметрах необходимо выбрать:
- Current user;
- Base URL;
- Authorize hash.
Остальные параметры не влияют на работу приложения, но влияют на то, кому из пользователей Wialon оно будет доступно.
Настройка аутентификации на стороне Okdesk
Ещё раз напомним, что аутентификация работает только для контактных лиц. При этом, поиск нужного контактного лица осуществляется по имени пользователя — а значит для аутентификации контактных лиц из Wialon в Okdesk, база логинов в двух системах должна быть одинаковой. Добавить или отредактировать логин контактному лицу в Okdesk-е можно на карточке контактного лица, а сделать это может пользователь с правами Администратора.
Для того, чтобы разрешить аутентификацию через Wialon, необходимо в разделе настройки интеграции включить соответствующую опцию (если у вас не подключен раздел интеграции с Wialon, обратитесь в техподдержку):
При этом, должно быть добавлено и успешно авторизовано соответствующее подключение из Okdesk к Wialon (подробнее об авторизации в Wialon в инструкции 1. Загрузка данных по объектам (ТС) и датчикам из Wialon).
После настройки сквозной аутентификации, пользователи Wialon смогут без лишних кликов переходить в клиентских портал Okdesk, оставлять новые заявки, выбирая при необходимости связь с конкретным ТС и даже датчиком, и добавлять уточнения по ранее поданным обращениям.
Загрузка данных...