AppとブックのMDM割り当ての改善

AppとブックのMDM割り当ての改善

Apps and Books Management APIを利用して、組織が所有するAppやブックを管理対象のユーザーやデバイスに割り当てる方法を紹介します。最新のAPIの改良点、組織内のアセット数、割り当て、登録ユーザに関する通知の購読、受信の方法についても確認します。また、非同期処理を利用することで、大規模な割り当ての際に必要なリクエスト数を大幅に削減する方法についても紹介します。

リソース
関連ビデオ

WWDC21
- Appleデバイス管理に関する新機能
ダウンロード

♪ ♪ こんにちは WWDCへようこそ私はAustin 担当は Apps and Books Management API です今回私たちがもたらした改善点をシェアします新しいバージョンのAPIについてです MDMソリューションによるAppとブックの管理これが今まで以上に迅速かつスケーラブルにできます皆さんはすでに使っているかもしれません Apps and Books Management API をこれは製品を使用する組織が Appとブックを管理できるようにするものです
組織はこれらのアセットをもう得ているかもしれません Apple School Managerや Apple Business Managerによってまた APIではアサインすることができます所有するAppとブックを組織が管理するユーザーとデバイスに今年は多くの変更を導入しました新しいApps and Books API にこのセッションではその多くの機能を紹介しますが２つの機能拡張に焦点を当てますこれによりワークフローが最も改善されますリアルタイム通知と非同期処理ですその他の変更点については新しい開発者向けのドキュメントを見てください developer.apple.com のデバイス管理の項目ですそしてこのセッションの資料を参照してくださいさあはじめましょうリアルタイムな通知機能を
リアルタイムで通知する機能をサポートしたのはアサインやアセットユーザーの状態変更などですこれらの通知を受けるには利用の承認が必要ですそうすることであなたは通知を受け取れますクライアント設定で承認したものだけを
リアルタイムの通知はついに取り去ったのです自分の状態を常に同期させる必要性を通知のタイプについてもう少し詳しく説明します最初の通知タイプはアサインです
アサインとはアセットを組織が管理するユーザーやデバイスに割り当てることです
ある確定を待たなければならないときたとえばアサインするグループ全体が正常に実行されたかなどですがその場合はユーザーが必要とするコンテンツのインストールに遅れが生じます現在ではアサインの通知によってリアルタイムで把握できますどのようなアサインがどのデバイスに適用され成功したのか
これらの情報を受け取るにはアセットマネジメントのクライアント設定で通知タイプを承認します
そしてAppleは次のいずれかによってアサインが変更されるとあなたに通知しますアセットの紐づけ紐づけの解除取り消し
こういった通知を利用することによりユーザーやデバイスに与えられたられたコンテンツへの迅速なアクセスを実現できます通知の例を見てみましょうアサインを行うとこの通知が届きますこの例でトリガーになるのはアセットを紐づけるcallです
Appleはこれらの通知をポストします認証ヘッダの共有秘密キーによってクライアント設定であなたが示した通知にはペイロードが含まれておりこれは与えられた通知タイプに固有のものです
この通知のタイプが示されているのがアセットマネジメントです通知ペイロードにはこれらが示されます状態が変更されるアサインや
一意識別子であるイベントID これはMDMがトリガーとなった非同期イベントですもう少し詳しく説明します新しいAPIの非同期性についてです
ここでは状態変化の結果について成功したか失敗したかを示しています
アサイン状態への変更タイプはここで紐づけます次の通知タイプはアセットです
アセットは組織が入手したAppとブックのことです Apple School Managerや Apple Business Managerから組織はアセットの管理やアサインができませんコンテンツの所有をMDMが確認するまではアセット通知を使用するとリアルタイムで通知されますアセットに変化が生じた場合たとえば購入や転送や払い戻しなどで MDMは常に把握しています各アセットの現在の利用可能数をクライアント設定のアセット数通知タイプをサブスクライブすることでこれらの通知を受け取ります
そして Appleはあなたへ通知を行いますアセットの状態が変化すると購入や転送や払い戻しのいずれかのイベントで
これらの通知により迅速に提供できるのですユーザーが最近入手したアセットを例を見てみましょうこの通知のこれまでのアセットの状況をふまえた上でアセットの現在の状態を取得するには "get assets" というエンドポイントを使いますこれは新しいアセットの同期エンドポイントです GETは HTTP特有のリクエストメソッドでもありバージョン管理のURIとの両方でそれがわかりますクエリパラメーターを使ってクエリを実行します adamIdとpricingParamですシングルアセットの状態を取得するために行います
現在求められるのはserver tokenやまたはsTokenをこのベアラートークン形式のすべての新しいAPIリクエストの authorizationヘッダーで提供することですこのレスポンスのアセットの配列には興味深いアセットがありますアサイン可能なものが10,000あります全体で15,000ある中で購入が発生するとこの通知を受け取りますペイロードを見てみると
入手したアセットのadamIdが含まれています
そしてこの場合デルタは正の整数となりますこれは購入または転送を表していますこのデルタでアセットの同期エンドポイントを再度呼び出すことなくカウントを更新します最後の通知タイプは登録ユーザー向けのものです展開はデバイスベースのアサインにほぼ依存しますがコンテンツをユーザーにアサインする必要があれば登録ユーザーの作成が最初のステップとなります
これらのユーザーを個人用または管理用のApple IDに紐づけすることは展開のために必要ですユーザー個人のApple IDを所定のsTokenの登録ユーザーに紐づけるにはユーザーは自分のApple IDを紐づけるための招待を承認する必要があります登録ユーザーの通知によりリアルタイムに更新されるようになりましたユーザーの最新の状態が登録ユーザーの最初の作成とその後の招待の受け入れの両方についてこれらを受け取るにはUSER MANAGEMENT と USER ASSOCIATEDの通知タイプをクライアント設定でサブスクライブしますユーザーの状態の変化でAppleから通知されますユーザーイベントの作成紐づけ更新撤退このいずれかによって
USER ASSOCIATED 通知はより適切に追跡できるようにするためのものですユーザーがApple IDとの紐づけの招待を受けた際にでは見てみましょうこれらの通知の例を以前のユーザーがどのような状態だったのか考慮しつつユーザーの現在の状態を取得するために get users エンドポイントを呼び出しますこれは新しいユーザーの同期エンドポイントです対象となるユーザーのみをフィルタリングします clientUserIdのクエリパラメータによってこれでレスポンスサイズを１ユーザーのみに制限しますここでいくつかご紹介するページ処理フィールドは私たちの同期APIに共通するものですここに示すのは現在のページインデックスサイズここではユーザーオブジェクトの数が現在のページにあり提供されたクエリの全体像です
ユーザーの配列には対象のユーザーのみが表示されておりここではステータスがassociatedではなくregisteredで招待コードがありますこのユーザーは明らかにまだ Apple IDに紐づけけられていませんすべての同期APIにはバージョン識別子が含まれ基礎となるデータに書き込みが行われるごとに変更されますこれは非常に便利なもので大規模なレスポンスをトラバーサルする際に前のページのデータが変更されている可能性を示します管理しているApple IDを登録ユーザーに紐づけるには新しい更新ユーザーのエンドポイントを使いますこの結果登録ユーザーの通知がここに表示されます通知のペイロードには次のことが表示されます状態を変更しようとしていたユーザーこのMDMトリガーによる非同期イベントの一意識別子状態変更の結果成功か失敗かユーザーの状態への変更のタイプ　ここでは更新ユーザーの配列を見てみると対象となるユーザの状態のclientUserIdに idHashとassociatedのステータスが含まれており管理しているApple IDの紐づけが成功したと結論づけていますこれを使いこのユーザーの状態を更新しますユーザー同期エンドポイントを再度呼び出すこともなくあなたが紐づけるかわりにそれが可能になります招待リンクを提供することで自分のApple IDを登録ユーザーに紐づけますここではその紐づいたユーザーの通知を見てみます通知のペイロードの中にはユーザーオブジェクトがあり関連するユーザに関する情報を含んでいます以下に限定しませんがclientUserIdや紐づけられたApple IDを示すidHash 承認した招待コード紐づけられたことを示すステータスなどですこれを使いこのユーザーの状態を更新するのですユーザー同期エンドポイントの再呼び出しは不要です
この通知を受け取るための登録方法について説明しますクライアント設定でのオプトインが必要になります管理するsTokenごとに
認証用に共有の秘密を提供するには notificationAuthTokenを使用しますそしてNotificationUrlでこれらをポストしますトークンはこれらの通知が実際にAppleから送られてきたものなのか確認するために使用されクライアント設定でいつでも更新可能です
通知を受け取った際にHTTP 200番台のレスポンスを提供することで通知が正常に配信されたと Appleに知らせることができるのです Appleは200以外のレスポンスが返された場合やタイムアウトが発生すると通知のリトライを試みます Appleの配信方式はベストエフォート型ですこの通知のリトライは通知を破棄する前に何度か行われますこれが意味するのは通知を受け取れない状態が一定期間続くと最新状態にポーリングを行う必要があるということです同期するものは限定します通知が成功しなかった結果状態が古くなるだろうと分かっているものだけですこの新しいAPIに得られた２つ目の大きな機能拡張は同期処理です
APIの初期バージョンではすべての管理は同期的に行われていましたアセットの管理のためにリクエストを行うと Appleは管理を行います同期応答を待っている間につまり並列処理を行ったのです一方非同期処理では Apple側でサーバーが強制的に並列処理を行いますこれにより処理が最適化されより大きなリクエストをより迅速に処理できるのです
順番に処理することで特定のリクエストパターンによる断続的な失敗やその後の再試行を減らすことができます
そしてそれが結果的にストレスのない大規模な展開が可能となり教育現場では新学期の再開が容易になります Appleは非同期処理で恩恵を受けています Appとブックの購入や転送において Apple School ManagerとApple Business Managerでこれにより組織は手元にある在庫を数時間ではなく数分で確認できるのです
それではこれらの要素がどのように組み合わされて新しいAppとブックの管理を実現するのか見てみましょう
たとえばあなたが管理する組織があります１万人のユーザーが各々自分のデバイスを持っていて
彼らの日常業務に欠かせない25個のAppを各デバイスにアサインするという場合
あなたに課せられるのは 25万件のアサインですこれまでのやり方を見てみましょう
あなたのサーバーはAppleに対してライセンス管理を要求します Appleは同期的に応答を返してきますこの応答には要求されたデバイスにアサインされたライセンスが含まれます
このリクエストで管理するAppは１つだけで最大10台のデバイスまでとなっており結果的に 10件のアサインしかできません
つまり最低で2万5千回のリクエストが必要となります 25万件のアサインを行うために新しいAPIではこの最低2万5千回のリクエストがわずか10回になります非同期処理に移行することでそれが可能になるのですその方法をご紹介しましょう
左側に追加されているのは通知サーバーですこれまで通りの手順でリクエストを開始します Appleにアセットの管理を依頼しますリクエストではsTokenを指定します認証ヘッダに複数のアセットを提供できるようになりました１回のリクエストで現在最大25個まで提供可能ですこの動的な制限はservice configで公開され
最大1,000台のデバイスへのアサインを実行しほかの動的な制限も同様に service configで公開されます Appleはあなたに同期して応答を返します
この応答に含まれているHTTPステータスコードはこの新しいAPIにとって重要なものですエラーには200以外の適切なステータスコードを返しますですからまず先へ進む前に応答が 200番台であることを確認してくださいそして最も重要なことは一意の識別子がこの非同期イベントにありそのステータスは新しいイベントステータスエンドポイントを呼び出すかマッチしたアサインの通知を待つことで得られますアサインが完了するとサブスクライブを前提にして Appleはあなたに通知をポストします通知にはそれぞれ要求されたアサインのサブセットがあり通知のペイロードにリストアップされていてアサインに関するメタデータが成功したのか失敗したのかそのタイプとそれに対応するイベントIDを示しますあなたは待つ必要がありますアサインが成功したという通知が来るのをそしてリストアップされたデバイスへのインストール用コマンドの送信を進めてくださいもう一つの管理用エンドポイントの利点は注文ですたとえばアセットの再アサインのリクエストがあるグループから別のグループへあった場合これを実現するには紐づけを解除した後に紐づけのリクエストを連続送信する必要がありますまず紐づけ解除のリクエストをポストしますそうすると Appleは紐づけを解除するためのイベントIDを応答しますそれから次の紐づけ用のリクエストをポストします Appleは別のイベントIDで対応しますが今回は紐づけをするためのものですあなたがサブスクライブしているという前提で紐づけの解除が完了すると Appleはあなたに通知を行いますそしてそのあと紐づけが完了すると Appleから通知がポストされるのです通知のようなAPIの大きな変更により Appleと同期した状態を維持できるようになりました最新の状態を確保するために継続的にリクエストを行う必要がなくなったのです
非同期処理によって誰もがより良い体験を得ることができます従業員や学生が必要なコンテンツにアクセス可能になります IT管理者は迅速に大規模な展開を行いあなたは組織のアセットを効率的に管理できます
現時点では既存のAPIは引き続きサポートされますなお同じトークンで新旧のAPIを併用するのは注意が必要ですこれは公式にはサポートされていません
道を切り開いたこの新しいAPI Apps and Books Managementをぜひご利用ください私たちはこの新しいAPIをできるだけ早くテストして統合しユーザーに最高のものをお届けします Apps and Books Managementの体験をより詳しい情報については最新の開発者向けドキュメントをご覧くださいお付き合いいただきありがとうございますひきつづき WWDCをお楽しみください [パーカッションの優美な音楽]

{
    "notification": {
        "assignments": [
            {
                "adamId": "408709785",
                "pricingParam": "STDQ",
                "serialNumber": "C02Y402HLCM6"
            },
            ...
        ],
        "eventId": "87cbc650-16cc-4f9e-a833-e622f377a9f7",
        "result": "SUCCESS",
        "type": "ASSOCIATE"
    },
    "notificationId": "ba8bbb23-44c2-44f6-a928-eff6ba5ffac3",
    "notificationType": "ASSET_MANAGEMENT",
    "uId": "2049025000431439"
}

4:39 - Get Assets Response

{
    "assets": [
        {
            "adamId": "408709785",
            "pricingParam": "STDQ",
            "assignedCount": 5000,
            "availableCount": 10000,
            "totalCount": 15000,
            ...
        }
    ],
    "currentPageIndex": 0,
    "size": 1,
    "totalPages": 1,
    ...
}

5:09 - Asset Count Notification

{
    "notification": {
        "adamId": "408709785",
        "countDelta": 50,
        "pricingParam": "STDQ"
    },
    "notificationId": "4a7801be-53f0-42e1-9505-81c0d1dc9da3",
    "notificationType": "ASSET_COUNT",
    "uId": "2049025000431439"
}

6:51 - Get Users Response

{
    "currentPageIndex": 0,
    "size": 1,
    "totalPages": 1,
    "users": [
        {
            "clientUserId": "client-100",
            "email": "client-100@example.com",
            "inviteCode": "f551b37da07146628e8dcbe0111f0364",
            "status": "Registered"
        }
    ],
    "versionId": "58507d60-9cd1-11eb-b916-1926dea207f9",
    ...
}

7:49 - User Management Notification

{
    "notification": {
        "users": [
            {
                "clientUserId": "client-100",
                "idHash": "leSKk3IaE2vk2KLmv2k3/200D3=",
                "status": "Associated",
                ...
            },
            ...
        ],
        "eventId": "e0def1f8-9158-4343-9c52-8dd32da50b9b",
        "result": "SUCCESS",
        "type": "UPDATE"
    },
    "notificationId": "4c0bbb9b-d5a6-4860-83ef-5cf362783c1e",
    "notificationType": "USER_MANAGEMENT",
    "uId": "2049025000431439"
}

8:33 - User Associated Notification

{
    "notification": {
        "associatedUsers": [
            {
                "clientUserId": "client-100",
                "idHash": "leSKk3IaE2vk2KLmv2k3/200D3=",
                "inviteCode": "f551b37da07146628e8dcbe0111f0364",
                "status": "Associated",
                ...
            }
        ]
    },
    "notificationId": "90b83144-fb93-4837-9c52-0ae147bdc421",
    "notificationType": "USER_ASSOCIATED",
    "uId": "2049025000431439"
}

12:25 - Associate Assets Request

{
    "assets": [
      {
        "adamId": "361309726",
        "pricingParam": "STDQ"
      },
      ...
    ],
    "serialNumbers": [
      "serial-1",
      ...
      "serial-1000"
    ]
}

12:51 - Associate Assets Response

{
    "eventId": "92467a8e-8a50-4df9-9b30-f7ff4a99dea7",
    "tokenExpirationDate": "2021-07-06T14:12:10+0000",
    "uId": "2049025000431439"
}

13:24 - Asset Management Notification

{
    "notification": {
        "assignments": [
            {
                "adamId": "361309726",
                "pricingParam": "STDQ",
                "serialNumber": "serial-1"
            },
            ...
        ],
        "eventId": "92467a8e-8a50-4df9-9b30-f7ff4a99dea7",
        "result": "SUCCESS",
        "type": "ASSOCIATE"
    },
    ...
}

特定のトピックをお探しの場合は、上にトピックを入力すると、関連するトピックにすばやく移動できます。

クエリの送信中にエラーが発生しました。インターネット接続を確認して、もう一度お試しください。

リソース

関連ビデオ

WWDC21