こんにちは。メダカと一緒に育てている姫睡蓮が花を咲かせました。
tkです。
前回に引き続きAPIに関連する検証です。
「Postman」を使ってWorkspace ONE を操作したいと思います！
タイトルはWorkspace ONE UEM となっていますが、実際はAccess中心です（笑）
【Postman とは】
有名なAPIテストツールです。
リクエストから認証、テストなどの機能が搭載されており、APIを開発する作業を簡素化、作業効率を向上させることができます。
APIに詳しくないインフラエンジニアの私でも簡単に使うことができます。
ダウンロードはこちらから↓↓
Download Postman | Get Started for Free
【Workspace ONE Hub 通知をAPIで実施】
以下VMware Tech Zoneにて、Postmanを使ったHub通知について紹介されています。
Automating Notifications: Workspace ONE Operational Tutorial | VMware
上記記事の大まかな流れとしては以下の通りです。
①Workspace ONE Access でサービスクライアントトークンの作成
②Postmanの構成
③PostmanからAPIを実行
今回はこの記事の内容を検証していきます。
Hubサービスの通知については本ブログにも記事がありますので、ぜひそちらもご一読ください。（リンク）
【Access：サービスクライアントトークンの作成】
APIの認証で使うトークンの設定を行います。
①Workspace ONE Accessにログインし、[カタログ] > [設定] をクリックする。
②「クライアントを作成」をクリックする。
③「クライアントを作成」画面で以下を設定する。
アクセスの種類：サービスクライアントトークン
クライアントID：任意の名前を設定
共有シークレット：「共有シークレットを生成」をクリック。
→あとから確認できないため、シークレットはコピーして残しておくこと
設定したクライアントIDと共有シークレットはあとで使います。
【Postman：Workspace ONE 環境構成】
①以下URLからWorkspace ONEのAPIコレクションと環境変数定義をダウンロードする。
Automating Notifications: Workspace ONE Operational Tutorial | VMware
②PostmanのWorkspaceでコレクションを選択し、「import」をクリックする。
③ダウンロードしたAPIコレクションと環境変数定義を選択し、「import」をクリックする。
④Postmanの右上からインポートした環境変数定義を選択する。
⑤目のアイコンをクリックし、「Edit」をクリックする。
【APIによるWorkspace ONE Hub通知】
トークン取得
Accessの認証トークンを取得します。
①[WS1 Notification APIs] > [Authentication] > [Get Access Token] をクリックする。
②「Send」をクリックする。実行結果が下部に表示される。
Workspace ONE AccessのID取得
Hub通知をAPIで作成するには、送信先となるAccessユーザーのIDが必要です。
Workspace ONE Access のユーザー情報を取得し、IDを確認します。
①[WS1 Notification APIs] > [Query Users and Devices] > [Access | Find User IDs (All Users)] をクリックする。
②「Send」をクリックする。実行結果が下部に表示される。
実行結果をテキストなどにコピーし、「id」を確認する。
（External IDはUEM上のID。）
Workspace ONE Hub 通知の作成
Hub通知ではリンクや動画の埋め込みなど様々可能です。
もちろんAPIでもできますが、今回はシンプルな通知を実行してみます。
①[WS1 Notification APIs] > [Notifications] > [Send Single-User Notifications] > [Users] > [Send Standard Notification to User] をクリックする。
②『{USER_UUID}』部分をAccessのIDに置き換える。
『:USER_UUID』とするとパス変数として指定できるようになる。
③通知内容となる「Body」を編集する。タイトルや本文などを適宜変更する。
④「Send」をクリックして通知を作成し、実行結果を確認する。
【まとめ】
Postman を使ったAPIによるHub通知についてまとめました。
Hub通知やID検索はVMwareがコレクションを用意してくれているので、簡単に実施することができます。
当然デフォルトで用意されていないコマンドも実行できます。
Workspace ONE UEM Explorerとコレクションにあるコマンドを参考にすると簡単にできるので、ぜひ皆さんもやってみてください！
次回はWindows PowerShell です！
