【休息日】Workspace ONE UEM の REST API をひとつひとつ試していく - 03

 

折り紙で作成した兜(2025/4/5撮影)
5月５日はこどもの日です。子供が困難から守られるように、鎧や兜などの防具を飾るようになったそうです。

前回、前々回までで、アプリケーションの割り当てを確認するためのAPIエンドポイントを一つずつ実行して、その結果を見てきました。結果として、どのAPIエンドポイントもアプリの割り当てに使用されたスマートグループを返答してくれました。

ところで、Workspace ONE UEMでは、アプリの割り当てにスマートグループだけでなく、組織グループも使用することができます
※「スマートグループや組織グループってなに？」という方は、本ブログでも解説記事を記載していますので、こちらもご参照くださいますと幸いです。

設定方法はとても簡単で、アプリの割り当ての時に、マウスオーバーすると出てくるリストの中から組織グループを選択するだけです。

前回と前々回試したAPIのレスポンスでは、アプリの割り当て対象として選択されたグループはすべてスマートグループとして返答されましたが、組織グループを割り当てたときはどのような形で返されるのでしょうか。少しだけ気になります。

まずは「/apps/{applicationUuid}/assignment-rules」です。なお、今回は「assignment_04」として、組織グループ「01_test_company」を使用した割り当てを追加しています。


{
  "assignments": [
    {
      "priority": 0,
      "distribution": {
        "name": "assignment_01",
        "description": "",
        "smart_groups": [
          "9f097342-3882-402c-9686-ab5080840f9d"
        ],
        "bsp_assignments": {
          "smart_groups_online_licenses": [],
          "smart_groups_offline_licenses": []
        },
        "app_delivery_method": "ON_DEMAND",
        "pre_release_version": 0,
        "auto_update_devices_with_previous_versions": false,
        "display_in_app_catalog": false,
        "requires_approval": false,
        "hide_notifications": false,
        "application_transforms": [],
        "installer_deferral_allowed": false,
        "installer_deferral_interval": 0,
        "installer_deferral_exit_code": "",
        "is_default_assignment": true,
        "keep_app_updated_automatically": false
      },
      "restriction": {
        "remove_on_unenroll": false,
        "prevent_application_backup": false,
        "make_app_mdm_managed": false,
        "managed_access": false,
        "desired_state_management": false,
        "prevent_removal": false
      },
      "tunnel": {},
      "application_configuration": [],
      "application_attributes": [],
      "is_dynamic_template_saved": false,
      "is_apple_education_assignment": false,
      "is_android_enterprise_config_template": false,
      "app_profiles_mapping": []
    },
    {
      "priority": 1,
      "distribution": {
        "name": "assignment_02",
        "description": "",
        "smart_groups": [
          "b0edde14-0b08-44bf-97e9-9b30bb67af31"
        ],
        "bsp_assignments": {
          "smart_groups_online_licenses": [],
          "smart_groups_offline_licenses": []
        },
        "app_delivery_method": "AUTO",
        "pre_release_version": 0,
        "auto_update_devices_with_previous_versions": false,
        "display_in_app_catalog": false,
        "requires_approval": false,
        "hide_notifications": false,
        "application_transforms": [],
        "installer_deferral_allowed": false,
        "installer_deferral_interval": 0,
        "installer_deferral_exit_code": "",
        "is_default_assignment": false,
        "keep_app_updated_automatically": false
      },
      "restriction": {
        "remove_on_unenroll": false,
        "prevent_application_backup": false,
        "make_app_mdm_managed": false,
        "managed_access": false,
        "desired_state_management": false,
        "prevent_removal": false
      },
      "tunnel": {},
      "application_configuration": [],
      "application_attributes": [],
      "is_dynamic_template_saved": false,
      "is_apple_education_assignment": false,
      "is_android_enterprise_config_template": false,
      "app_profiles_mapping": []
    },
    {
      "priority": 2,
      "distribution": {
        "name": "assignment_03",
        "description": "",
        "smart_groups": [
          "89067e85-e24f-45c7-b31c-8c0a75456d9f"
        ],
        "bsp_assignments": {
          "smart_groups_online_licenses": [],
          "smart_groups_offline_licenses": []
        },
        "app_delivery_method": "ON_DEMAND",
        "pre_release_version": 0,
        "auto_update_devices_with_previous_versions": false,
        "display_in_app_catalog": false,
        "requires_approval": false,
        "hide_notifications": false,
        "application_transforms": [],
        "installer_deferral_allowed": false,
        "installer_deferral_interval": 0,
        "installer_deferral_exit_code": "",
        "is_default_assignment": false,
        "keep_app_updated_automatically": false
      },
      "restriction": {
        "remove_on_unenroll": false,
        "prevent_application_backup": false,
        "make_app_mdm_managed": false,
        "managed_access": false,
        "desired_state_management": false,
        "prevent_removal": false
      },
      "tunnel": {},
      "application_configuration": [],
      "application_attributes": [],
      "is_dynamic_template_saved": false,
      "is_apple_education_assignment": false,
      "is_android_enterprise_config_template": false,
      "app_profiles_mapping": []
    },
    {
      "priority": 3,
      "distribution": {
        "name": "assignment_04",
        "description": "organization group",
        "smart_groups": [
          "1007e50a-aaa7-497c-8cc6-c82883e86332"
        ],
        "bsp_assignments": {
          "smart_groups_online_licenses": [],
          "smart_groups_offline_licenses": []
        },
        "app_delivery_method": "ON_DEMAND",
        "pre_release_version": 0,
        "auto_update_devices_with_previous_versions": false,
        "display_in_app_catalog": false,
        "requires_approval": false,
        "hide_notifications": false,
        "application_transforms": [],
        "installer_deferral_allowed": false,
        "installer_deferral_interval": 0,
        "installer_deferral_exit_code": "",
        "is_default_assignment": false,
        "keep_app_updated_automatically": false
      },
      "restriction": {
        "remove_on_unenroll": false,
        "prevent_application_backup": false,
        "make_app_mdm_managed": false,
        "managed_access": false,
        "desired_state_management": false,
        "prevent_removal": false
      },
      "tunnel": {},
      "application_configuration": [],
      "application_attributes": [],
      "is_dynamic_template_saved": false,
      "is_apple_education_assignment": false,
      "is_android_enterprise_config_template": false,
      "app_profiles_mapping": []
    }
  ],
  "excluded_smart_groups": [],
  "application_msi_deployment_params": {}
}

次に、「/apps/search」です。


{
  "Application": [
    {
      "ApplicationName": "Google Chrome",
      "BundleId": "com.google.chrome.ios",
      "AppType": "Public",
      "Status": "Active",
      "Platform": 2,
      "AssignmentStatus": "Assigned",
      "ApplicationSize": "252.93 MB",
      "CategoryList": {
        "Category": []
      },
      "SmartGroups": [
        {
          "Id": 3898,
          "Name": "01_test_smart_group"
        },
        {
          "Id": 3899,
          "Name": "02_test_smart_group"
        },
        {
          "Id": 3900,
          "Name": "03_test_smart_group"
        },
        {
          "Id": 3897,
          "Name": "01_test_company"
        }
      ],
      "Comments": "",
      "IsReimbursable": false,
      "ApplicationUrl": "https://apps.apple.com/us/app/google-chrome/id535886823",
      "ApplicationSource": 1,
      "LocationGroupId": 1987,
      "RootLocationGroupName": "01_test_company",
      "OrganizationGroupUuid": "5db9ba20-04af-4572-af19-70218bab3445",
      "LargeIconUri": "https://dsXXXX.awmdm.com/DeviceServices/publicblob/8d4dc459-01f3-4909-91ce-98346d9d9b6f/BlobHandler.pblob",
      "MediumIconUri": "https://dsXXXX.awmdm.com/DeviceServices/publicblob/8d4dc459-01f3-4909-91ce-98346d9d9b6f/BlobHandler.pblob",
      "SmallIconUri": "https://dsXXXX.awmdm.com/DeviceServices/publicblob/8d4dc459-01f3-4909-91ce-98346d9d9b6f/BlobHandler.pblob",
      "PushMode": 0,
      "AppRank": 0,
      "AssignedDeviceCount": 0,
      "InstalledDeviceCount": 0,
      "NotInstalledDeviceCount": 0,
      "AutoUpdateVersion": false,
      "EnableProvisioning": false,
      "IsDependencyFile": false,
      "ContentGatewayId": 0,
      "Id": {
        "Value": 3063
      },
      "Uuid": "5789e907-5a5c-4b53-b508-572946a6be8d"
    }
  ],
  "Page": 0,
  "PageSize": 500,
  "Total": 1
}

どちらのAPIエンドポイントも、割り当てに使用した組織グループ「01_test_company」をスマートグループとして返答してきました。「01_test_company」については組織グループとして割り当てグループの一覧内には表示されていますが、スマートグループとしてきちんと取り扱われるようです。

次回は、スマートグループの詳細をREST APIでクエリ可能か、試してみたいと思います。
※まだ対応するAPIエンドポイントを探せていませんが。。

このブログの人気の投稿

Microsoft Graph PowerShellモジュールでMicrosoft 365の認証をWorkspace ONE Accessにフェデレーションする

イメージ
耐寒マツバギク(2024/5/18撮影) タンポポに似て、円形に細い花弁を持っていることや、その名前からキクの仲間と思ったところ、調べてみると違う植物の仲間だそうです。 マツバギクという名称なのでなんとなくアジア原産かと思っていたら、南アフリカ原産でした。 New-MgDomainFederationConfiguration コマンドというコマンドがあるそうです。 以下URLを見てみると、 前回のブログエントリ で使用した Set-MsolDomainAuthentication コマンドの後継コマンドだそうです。どうやら、Microsoftは将来的にSet-MsolDomainAuthenticationをはじめとしたコマンドの一式を非サポートとするようです。 Find Azure AD PowerShell and MSOnline cmdlets in Microsoft Graph PowerShell 今回私は、近い将来来る変化に備えて、New-MgDomainFederationConfiguration コマンドを使用してMicrosoft 365の認証をWorkspace ONE Accessに委任する方式を試してみました。 本ブログエントリは2024年5月18日時点で筆者が確認できた情報をもとに作成しております。本ブログエントリを参考に同様の手順を実行する場合、その時々の各製品、サービスの提供元の公式情報をご確認ください。 【2024年12月15日更新： このMicrosoft日本チームのブログ記事 を見ると、2025年3月30日をもってMSOLコマンドのサポートが完全に提供されなくなるようです】 ■目次 Microsoft.Graph.Identity.DirectoryManagement モジュールのインストール Microsoft 365に接続 Microsoft 365に存在するドメインのリスト表示 New-MgDomainFederationConfiguration コマンドによるフェデレーション設定 ログイン確認 その他躓いたこと ①Microsoft.Graph.Identity.DirectoryManagement モジュールのインストール Set-MsolDomainAuthentication コマンドは MSOnlin...
Read more »

■Workspace ONE UEM API Explorerについて

イメージ
この投稿は、 vExperts Advent Calendar 2019 - Adventar の 12日目の記事 です。 今年初めて vExperts Advent Calendar に参加させていただきます。どうぞ宜しくお願い致します。 今回の記事のテーマは、 「Workspace ONE UEM(以下UEM)の持つREST APIの動作確認をしてみること」 です。 VMware製品の持つAPIの多くは、以下のページでどのようなものがあるかを確認することが可能です。 VMware API Explorer ただ、 UEM のAPI については上記ページに記載はなく、UEMホストそのものに同様のページが設けられています。具体的には各UEMホストの、以下のURLに準備されています。 https://<UEMのFQDN>/api/help/#!/apis ※2020/9/25 追記：確認する範囲では <UEMのFQDN>でもAPI Explorerにはアクセス可能ですが、 多くのSaaS共有環境では、API のURLは普段管理コンソールとして利用するcnXXX.awmdm.comの先頭二文字のcnをasに入れ替えた値となります(API ExplorerのFQDNも本来はこちらになります)。 UAGなどでTunnelやContent Gatewayなどの構成要件として APIとの通信が必要な 場合は、 <UEMのFQDN>ではなく、 asXXX.awmdm.comなどのような、API用URL をご確認の上、通信を許可してください。なお 管理者権限にもよりますが、 API用URLについては SaaS共有環境であれば[グループと設定]＞[すべての設定]＞[システム]＞[高度な設定]＞[サイトURL]で確認可能です(2020/9/25時点)。    REST API用のURLの確認画面。 ※画像はConsole Administrator権限で確認した際のもの 上記URLにアクセスすると、 Workspace ONE UEM API Explorer が表示されます。 REST APIの動作確認というと、 postmanなどのREST Clientをインストール したり、 FireF...
Read more »

●久々にESXiのカスタムISOをつくってみた

ブログのタイトルに仮想化という言葉がはいっているのですが、ここ2-3年ESXiなどにちゃんと触れていないことに気づき、後ろめたい気持ちがあったので、久々に仮想化について記載いたします。 今回は自作PCをくみ上げ、ESXi 6.7をインストールしてみました。 ※7じゃなくて6.7な理由は、自作パソコンをくみ上げた後にオンボードnicがRealtekさんだったことに気づいたためです。 ESXi 6.7までは有志の方が作ったRealtekのドライバを使うことができたようなのですが、7では使えないらしく、泣く泣くこの選択になりました。。。 参考： Homelab considerations for vSphere 7 そのため、インストールではなく、カスタムイメージの作成から始まります。 ※というかインストールはいろんな人がすでにブログで書いており、現状ほぼ自分も迷わないので、忘備録としてカスタムISOの作成だけを記載します。。汗 普段Workspace ONEに触れている私は、ESXiのカスタムイメージを作成する機会が滅多になく、作成のたびに2時間程度調べて格闘しなければいけなかったので、この機会に忘備録として記載してしまいます。。 なお、必要なイメージやVIBなどは以下を利用しました。 Net55-r8168 - V-Front VIBSDepot Wiki VMware vSphere Hypervisor (ESXi) 6.7U3b(オフラインバンドル) 手順は主に以下を参考にしました。 Using vSphere ESXi Image Builder to create an installable ISO that is not vulnerable to Heartbleed Using the vSphere ESXi Image Builder CLI ●ESXiのカスタムイメージ作成をやる前に、概念をぼんやり思い出そう 今回のESXiカスタムイメージ作成では、以下二つの概念が出てきます。 ソフトウェアデポ これはVIBなどのソフトウェアモジュールをプールしたモノのようです。ESXiのオフラインバンドルや拡張VIBモジュールのzipを入手したら、Add-EsxSoftwareDepotコマンドレットを使用して、とりあえずソフトウェアデポに追加していきます...
Read more »