Можно настроить внешние приложения для использования основных функциональных возможностей Workspace ONE UEM путем интеграции API-интерфейсов REST с инфраструктурой UEM и тем самым облегчить процесс подключения. Можно также выбрать ближайший к центру обработки данных URL-адрес токена OAuth для аутентификации вызовов API-интерфейса.

Начало работы с REST API

Используя упрощенную архитектуру программного обеспечения REST, API-интерфейсы REST в Workspace ONE UEM в настоящее время поддерживают множество функций, включая организационную группу, администрирование консоли, мобильное приложение, мобильное устройство, электронную почту, пользователя для регистрации, профиль, смарт-группу и управление группами пользователей.

Использование API-интерфейсов на основе REST обеспечивает ряд преимуществ для компаний, что позволяет избавиться от затрат средств и времени на разработку приложений собственными силами. API-интерфейсы REST в Workspace ONE UEM полностью готовы к интеграции с корпоративными серверами, программами и процессами. Кроме того, API-интерфейсы REST в Workspace ONE UEM более эффективны, могут работать бесперебойно и легко настраиваются в соответствии с фирменной символикой компаний. Эти API-интерфейсы предназначены для разработчиков приложений, и в данном руководстве содержится информация о проектировании и архитектуре библиотеки API для облегчения разработки и интеграции с Workspace ONE UEM.

Доступ к документации по API-интерфейсам

Доступ к подробной документации по API-интерфейсам можно получить, перейдя на страницу справки по API-интерфейсам в Workspace ONE UEM.

Для этого в средах SaaS необходимо заменить «cn» в URL-адресе на «as», а затем добавить /api/help после .com.

Например, документация по API-интерфейсам для URL-адреса среды SaaS 
https://cn4855.awmdm.com
— 
https://as4855.awmdm.com/api/help

URL-адреса центров обработки данных и маркеров для поддержки OAuth 2.0

Workspace ONE UEM обеспечивает поддержку отраслевого стандартного протокола Oauth 2.0 для безопасной аутентификации и авторизации для вызовов REST API.

URL-адреса маркеров зависят от региона.

Табл. 1. URL-адреса маркеров, зависящие от региона
Регион Расположение центра обработки данных SaaS Workspace ONE UEM URL-адрес маркера
Огайо (США) Все среды UAT https://uat.uemauth.vmwservices.com/connect/token
Вирджиния (США) Соединенные Штаты Америки https://na.uemauth.vmwservices.com/connect/token
Вирджиния (США) Канада https://na.uemauth.vmwservices.com/connect/token
Франкфурт (Германия) Великобритания https://emea.uemauth.vmwservices.com/connect/token
Франкфурт (Германия) Германия https://emea.uemauth.vmwservices.com/connect/token
Токио (Япония) Индия https://apac.uemauth.vmwservices.com/connect/token
Токио (Япония) Япония https://apac.uemauth.vmwservices.com/connect/token
Токио (Япония) Сингапур https://apac.uemauth.vmwservices.com/connect/token
Токио (Япония) Австралия https://apac.uemauth.vmwservices.com/connect/token
Токио (Япония) Гонконг https://apac.uemauth.vmwservices.com/connect/token

Создание клиента OAuth для использования с командами API-интерфейса

Можно создать клиент OAuth, который будет использоваться для команд API в Workspace ONE UEM Console 2001 или более поздней версии. Создайте клиент OAuth, выполнив указанные ниже действия.

  1. Выберите Группы и настройки > Конфигурации.
  2. Введите OAuth в текстовом поле поиска «Введите имя или категорию».
  3. Выберите вариант Управление клиентами OAuth, который отображается в результатах. Отобразится экран Управление клиентами OAuth.
  4. Выберите клавишу Добавить.
  5. Заполните поля Имя, Описание, Организационная группа и Роль.
  6. Убедитесь, что для параметра Статус задано значение Включено.
  7. Нажмите Сохранить.
  8. ВАЖНО! Скопируйте ID клиента и Секрет клиента в буфер обмена и сохраните их, прежде чем закрыть экран. Щелкните значок буфера обмена (), чтобы отправитьСекрет клиента в буфер обмена.

    После нажатия Закрыть невозможно будет вернуться сюда, чтобы извлечь эти сведения.