REST API と UEM インフラストラクチャを統合し、接続を容易にすることで、Workspace ONE UEM の主要な製品機能を使用するよう外部アプリケーションを構成できます。また、データセンターに最も近い OAuth トークン URL を選択して、API 呼び出しを認証することもできます。

REST API の使用を開始する

現在、Workspace ONE UEM REST API はシンプルな REST ソフトウェア アーキテクチャ使用して、組織グループ、コンソール管理、モバイル アプリ、モバイル デバイス、E メール、加入ユーザー、プロファイル、スマート グループ、ユーザー グループ管理など、さまざまな機能をサポートしています。

REST ベースの API を使用することで、社内でのアプリケーション開発にかかるコストの削減や時間の短縮など、企業にいくつかのメリットを提供できます。Workspace ONE UEM REST API は、エンタープライズ サーバ、プログラム、プロセスと統合できるようになりました。また、Workspace ONE UEM REST API は効率性に優れており、スムーズに実行でき、企業は簡単にブランド化することができます。これらの API はアプリケーション開発者を対象としています。このガイドでは、カスタム開発と Workspace ONE UEM との統合を容易にする API ライブラリの設計とアーキテクチャについて説明します。

API ドキュメントへのアクセス

Workspace ONE UEM API のヘルプ ページに移動して、詳細な API ドキュメントにアクセスします。

これを SaaS 環境で実行するには、URL の「cn」を「as」に置き換え、.com の後に /api/help を追加します。

たとえば、SaaS 環境の URL の API ドキュメント
https://cn4855.awmdm.com
は次が該当します
https://as4855.awmdm.com/api/help

OAuth 2.0 をサポートするデータセンターとトークンの URL

Workspace ONE UEM は、REST API コールの認証と承認を安全に行うために、業界標準の OAuth 2.0 プロトコルをサポートしています。

トークン URL は地域固有です。

表 1. 地域固有のトークン URL
地域 Workspace ONE UEM SaaS データセンターの場所 トークン URL
オハイオ (米国) すべての UAT 環境 https://uat.uemauth.vmwservices.com/connect/token
バージニア (米国) United States 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

API コマンドに使用する OAuth クライアントの作成

Workspace ONE UEM Console バージョン 2001 以降で API コマンドに使用する OAuth クライアントを作成できます。OAuth クライアントを作成するには、次の手順を実行します。

  1. [グループと設定] > [構成] の順に移動します。
  2. 「名前またはカテゴリを入力します」というラベルの付いた検索ボックスに「OAuth」と入力します。
  3. 検索結果に表示される [OAuth クライアント管理] を選択します。[OAuth ライアント管理] 画面が表示されます。
  4. [追加] ボタンを選択します。
  5. [名前][説明][組織グループ][役割] を入力します。
  6. [ステータス][有効] になっていることを確認します。
  7. [[保存]] を選択します。
  8. [重要:] [クライアント ID][クライアント シークレット] をクリップボードにコピーして、保存してからこの画面を閉じます。クリップボード アイコン()を選択して [クライアント シークレット ] をクリップボードに送信します。

    [閉じる] を選択すると、後で情報を参照するために、この表示に戻ることはできません。