00. Документация по настройкам и возможностям Okdesk
00. Как обратиться к тех. поддержку?
01. С чего начать?
1. Введение в Okdesk
1. Какие задачи можно решать с Okdesk?
2. Учет и выполнение поступающих клиентских заявок
3. Платные заявки и планово-профилактические регламентные работы
4. Создание документов по шаблонам
5. Модуль CRM: ведем справочники всех клиентов и договоров в едином месте
6. Объекты обслуживания и оборудование: инвентаризация обслуживаемой инфраструктуры
7. Работа "в полях": мобильное рабочее место инженера и отображение заявок на карте
8. Планирование загрузки сотрудников: календарь
9. Ещё больше возможностей Okdesk!
2. Быстрый старт
Шаг 1. Регистрация новой заявки
Шаг 2: Заполняем базу клиентов
Шаг 3: Подключаем к работе коллег
Шаг 4: Настраиваем обработку писем от клиентов
Шаг 5: Настраиваем оповещения по заявкам
Шаг 6: Автоматическое назначение ответственных (маршрутизация)
Шаг 7. Ознакомьтесь с расширенными возможностями списка заявок (видео)
02. Заявки и регламентные работы
1. Бизнес-процессы обработки заявок
1. Начало работы с бизнес-процессами
1. Стандартный бизнес-процесс в Okdesk
2. Как бизнес-процессы помогают организовать обработку заявок
3. Как описать процесс обработки заявок до настройки в Okdesk
2. Подготовка элементов бизнес-процесса
1. Типы заявок
1. Что такое типы заявок
2. Как настроить типы заявок
2. Статусы заявок
1. Что такое статусы заявок
2. Как настроить статусы заявок
4. Дополнительные атрибуты заявок
1. Что такое дополнительный атрибут заявки
2. Как настроить дополнительный атрибут заявки
5. Приоритеты заявок
1. Что такое приоритет заявки
2. Как настроить приоритет заявки
6. Графики обслуживания
1. Что такое график обслуживания
2. Как настроить график обслуживания
3. Настройка бизнес-процесса
1. Как создать бизнес-процесс
2. Как добавить статусы, переходы и кнопки переходов
3. Как использовать атрибуты в бизнес-процессе
4. Как настроить маршрутизацию заявок
5. Как настроить нормативы обработки заявки (SLA)
4. Дополнительные элементы бизнес-процессов
1. Чек-листы
2. Права доступа
3. Оценка качества выполнения заявок
4. Запрет на совершение действий, если сотрудник не на объекте
2. Email-переписка по заявкам
1. Сквозная аутентификация в Okdesk по ссылкам из Email-уведомлений
2. Кто получает email-уведомления по заявке?
3. Реквизиты отправителя, внешний вид и содержание писем
4. Переписка по заявкам: настройка подключения к почтовому серверу
5. Алгоритм обработки входящих писем
6. Зацикливание переписки и попадание в СПАМ: как с этим бороться?
7. "Черные списки" на отправку и на прием почты
Основные поля в карточке заявки
Повторяющиеся заявки
Спецификация работ и материалов в заявке
Тиражирование однотипных заявок (массовое создание заявок)
Трудозатраты на выполнение заявок
03. Клиенты, сервисные договоры и инфраструктура
1. Карточки компаний
2. Контактные лица клиентов
3. Клиентский портал и клиентское приложение для подачи заявок
4. Объекты обслуживания и оборудование
5. Интерактивный план
6. Договоры и сервисные периоды
04. Обслуживание оборудования
Планы ТО
Как настроить плановое ТО
01. Типы, производители и модели оборудования
2. Карточка оборудования
3. Регламентное обслуживание оборудования
4. Список оборудования
5. Использование QR-кодов и NFC-меток для обслуживания оборудования и инфраструктуры
6. Публичные QR-метки для оборудования. Подача заявок без регистрации и мобильного приложения.
05. Склад запчастей, расходных материалов, оборудования и инструментов
1. Номенклатура запчастей и расходных материалов
2. Список складов и остатков
3. Оприходование, перемещение и списание запчастей и расходных материалов
4. Списание запчастей и расходных материалов в заявке
5. Складской учет оборудования и инструментов
6. Движение оборудование со склада и на склад в рамках заявки
06. Сотрудники и группы
1. Добавление и деактивация сотрудников
2. Группы сотрудников
3. Роли и права доступа
4. Просмотр маршрута сотрудников за день
5. Двухфакторная аутентификация сотрудников
07. Отчеты и аналитика
Встроенные отчеты и аналитика
Готовые отчеты в Microsoft Power BI
Готовые отчеты и коннектор к Яндекс DataLens
08. Дополнительные возможности
1. Печатные формы
2. Подпись клиента на экране смартфона
3. Обмен заявками с партнером
4. Автоматические программируемые сценарии
Список контекстных переменных
09. Интеграции Okdesk с другими системами
Интеграции с АТС (телефония)
1. Интеграция с АТС через сервис "Простые Звонки"
2. Интеграция с АТС через REST API
Интеграция с Wialon
1. Загрузка данных по объектам (ТС) и датчикам из Wialon
2. Аутентификация в клиентском портале из интерфейса Wialon
01. Интеграция с платформой Albato
02. Интеграция с МАХ
03. Telegram-бот для клиентов
04. Интеграция с Navixy
05. Интеграция с ГЛОНАССсофт
06. Интеграция с мониторингом Streletz-Cloud (АРГУС-СПЕКТР)
07. Интеграция с охранной системой Bolid
08. Интеграция с PRO32Connect (ex. GetScreen)
09. Интеграция с центром охраны C.Nord
10. Интеграция с MS Active Directory
11. SMS-оповещения (Интеграция с SMS-шлюзами)
11. Интеграция с Camkeeper
13. Интеграция с Axenta
14. Интеграция с Omnicomm Online
15. Настройка единого входа (SSO) в Okdesk через SAML
10. REST API & SQL API
REST API
SQL API
Вебхуки
Онлайн-школа Okdesk
Курс 1. Знакомство с Okdesk
Урок 1. Okdesk: интерфейс и возможности
Урок 2. Как создать заявку в Okdesk
Урок 3. Как добавить сотрудников и объединить их в группы
Урок 4. Как работать в мобильном приложении инженера
Урок 5. Как добавить заявителей в Okdesk
Урок 6. Как организовать переписку с заявителями по e-mail
Урок 7. Как подключить Telegram-бот для заявителей
Урок 8. Клиентский портал и мобильное приложение для заявтелей
Курс 2. Список заявок. Настройка под себя.
Урок 1. Как работать со списком заявок и настраивать его под свои задачи
Урок 2. Как разобраться в устройстве списка заявок и настроить столбцы
Урок 3. Как определять состояние заявки прямо из списка
Урок 4. Как выполнять действия с заявкой прямо из списка
Урок 5. Как применять фильтры для отбора нужных заявок
Урок 6. Как организовать работу со списком с помощью вкладок
Урок 7. Как выгрузить список заявок при необходимости
Урок 8. Как использовать уведомления, поиск и сортировку для ежедневной работы
Урок 9. Скринкаст
Курс 3. Работа в мобильном приложении инженера
Урок 1. Как мобильное приложение Okdesk помогает выполнять заявки на выезде
Урок 2. Как работать со списком заявок
Урок 3. Как создать заявку в мобильном приложении
Урок 4. Как работать с заявкой в мобильном приложении
Урок 5. Как работать с оборудованием
Урок 6. Как работать с заявителями, адресами и выездами
Урок 7. Как работать в мобильном приложении без интернета
Урок 8. Как использовать дополнительные возможности мобильного приложения
Урок 9. Скринкаст
Курс 4. Работа с базой знаний
Урок 1. Что такое база знаний и зачем она нужна
Урок 2. Как создать структуру разделов
Урок 3. Как создать и оформить статью
Урок 4. Как настроить права доступа
Урок 5. Как создать приватный раздел для заявителя
Урок 6. Как использовать базу знаний при работе с заявками
Урок 7. Как поддерживать базу знаний в актуальном состоянии
Урок 8. Скринкаст: как работать с Базой знаний
Курс 5. Разделение контуров видимости заявок
Урок 1. Как разделить заявки между отделами
Урок 2. Как разделить заявки между сотрудниками по заявителям
Урок 3. Как добавить подрядчика на платформу и ограничить доступ
Ответы на типовые вопросы
Выявление причин неработоспособности Okdesk
Импорт с помощью REST API
Интерфейс для интеграции с системами построения отчетов и аналитики (BI), SQL API
Информация по ошибке при проблеме с телефонией
Как редактировать текст и внешний вид email-оповещений
Как скачать файл из заявки с помощью API?
Как удалить доп. атрибут
Клиенту не пришло email-оповещение о добавлении комментария
Надо ли отображать клиентам трудозатраты?
Настройка Oauth2 для обработки почты с сервисов Gmail
Настройка Oauth2 для обработки почты с сервисов Microsoft
Не приходят sms-оповещения
Не работает интеграция с телефонией
Обработки для 1С
Отправка писем от публичных адресов (@mail.ru, @gmail.com и т.д.)
Ошибки при выполнении API-запросов
Ошибки при проверке подключения к почтовому серверу
Ошибки при проверке подключения к почтовому серверу SMTP
Парковка домена
Письма от Okdesk попадают в Spam
Подключение отчетов Okdesk в Yandex DataLens
Проблемы с кодировкой в скаченных файлах
Проверка корректности API-запросов
Работа глобального поиска
Разделение доп. атрибутов по столбцам в MS Power BI
Скачивание писем при подключении по IMAP
Советы по решению проблемы с добавлением файлов на телефонах Huawei/Honor
Советы по решению проблемы с добавлением файлов на телефонах Realme
Советы по решению проблемы с добавлением файлов на телефонах Samsung
Советы по решению проблемы с добавлением файлов на телефонах Xiaomi
Стилизация печатных форм
Требования к логотипу
Чем отличаются статусы "Решена" и "Закрыта"
Что такое "автоматические правила"?
Шаблоны для импорта
Шаблоны отчетов для MS Power BI
Содержание статьи
Файлы (3)

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. Выберите инструкцию для своей системы и выполните описанные в ней действия. Подробная настройка каждого провайдера приведена в отдельном файле:

Keycloak

Microsoft Entra ID

AD FS

В каждой инструкции подробно описано, как настроить провайдера для работы с Okdesk, обеспечить передачу логина пользователя и получить данные для завершения подключения. Результат настройки — URL входа (SSO Endpoint) и сертификат провайдера удостоверений. Эти данные понадобятся в Okdesk. Сохраните их и вернитесь к форме подключения, которую оставили открытой на первом шаге.

Шаг 3. Завершите подключение в Okdesk

После настройки провайдера у вас есть URL входа и сертификат. Осталось передать эти данные в Okdesk и создать подключение. Вернитесь к форме «Новое SSO подключение», которую оставили открытой на первом шаге. В разделе «Настройки провайдера удостоверений (IdP)» заполните два поля:

Поле Что указать
URL запроса (SSO Endpoint) Адрес входа, полученный при настройке провайдера удостоверений. По этому адресу Okdesk будет направлять пользователей для входа.
Сертификат Сертификат провайдера удостоверений, полученный при настройке. Он нужен Okdesk для проверки подписи SAML-ответов.


Нажмите «Добавить». Подключение появится в списке «Провайдеры SSO» в выключенном состоянии. Пока оно выключено, пользователи не смогут входить через него.

Шаг 4. Включите SSO и проверьте вход

Чтобы пользователи могли входить через корпоративные учетные записи, включите созданное подключение. В списке «Провайдеры SSO» найдите подключение, включите переключатель рядом с ним и подтвердите действие кнопкой «Включить».

Важно. После включения SSO пользователи, которым разрешен вход через это подключение, больше не смогут входить по логину и паролю Okdesk. Если подключение разрешено всем сотрудникам, ограничение затронет и администраторов. Не завершайте текущий сеанс администратора, пока не проверите новый способ входа.

Проверьте вход через SSO

  1. Откройте страницу входа Okdesk в другом браузере или режиме инкогнито.
  2. Нажмите кнопку с названием подключения в блоке «или войти через».
  3. На странице провайдера удостоверений введите логин и пароль корпоративной учетной записи.
  4. Убедитесь, что после авторизации открылся Okdesk под нужной учетной записью.

Если вход разрешен всем сотрудникам и всем контактам, форма для ввода логина и пароля Okdesk на странице входа не отображается. Пользователи увидят только кнопку входа через SSO. Если вход не работает, вернитесь к открытой сессии администратора и выключите подключение в списке «Провайдеры SSO». Проверьте настройки провайдера и повторите попытку.

Загрузка данных...