Skip to main content
Apple Business Manager は Apple Business になりました。Apple School Manager は変更されていません。詳細については、Introducing Apple Business および Apple Business Manager is now Apple Business を参照してください。

​
ADE トークンの管理について

Automated Device Enrollment (ADE) トークンは、デバイス登録機能を維持するために定期的な更新と管理が必要です。このプロセスにより、API による自動化を使用して複数の ADE トークンを効率的に管理でき、手作業を減らし、一貫したトークンのライフサイクル管理を実現できます。

​
仕組み

ADE トークンの管理では、Postman を通じて Iru Endpoint API を使用し、複数のトークンに対して一括操作を実行します。このプロセスには、API アクセスの構成、環境変数の設定、Apple Business または Apple School Manager からのトークンのダウンロード、自動化されたワークフローを使用したトークンの効率的な更新、変更、削除が含まれます。
このプロセスを自分で完了する自信がない場合は、Iru Endpoint サポートにお問い合わせのうえ、追加のガイダンスを受けてください。

​
前提条件

  • API トークンの作成権限を持つ Iru Endpoint へのアクセス
  • インストールおよび構成済みの Postman アプリケーション
  • Apple Business または Apple School Manager へのアクセス
  • 更新または管理が必要な複数の ADE トークン
  • API 操作と Postman のワークフローに関する基本的な理解

​
Iru Endpoint API トークンを構成する

API トークンを準備し、安全な場所に保管します。詳細については、Iru Endpoint API の記事を参照してください。すでに API トークンを準備している場合は、このセクションをスキップできます。
1

API トークンを作成または変更する

必要な権限を持つ新しい API トークンを作成するか、既存のトークンを変更します。
2

APIトークン を開く

Iru Endpoint テナントのサイドバーで アカウントメニューボタン を選択し、アクセス → APIトークン を選択します。
3

権限を構成する

API トークンを作成するか既存のトークンを変更して、Automated Device Enrollment 関連のすべての権限を含めます。

​
Postman を準備する

以降の手順のほとんどは、デバイス上の Postman アプリケーションで実行します。すでに Postman を構成している場合は、このセクションをスキップできます。
1

コレクションの構造を確認する

コレクションに Automated Device Enrollment integrations フォルダがあることを確認します。
2

API URL を定義する

API URL が未定義の場合は、コレクション上部の Iru Endpoint API フォルダで定義します。
3

環境変数を構成する

「Postman で Iru Endpoint API を設定する方法」の記事に従って、Environment 変数で API トークンを定義します。

​
Postman の環境変数を構成する

Postman の基本的な構成が完了したので、Automated Device Enrollment サーバを追跡するために、Postman でいくつかの環境変数を定義する必要があります。
1

環境変数を作成する

Postman で、左側のサイドバーの Environments タブを選択し、Create Environment を選択して新しい環境を作成します。環境に名前を付け (例: “Iru Endpoint API”)、次の変数を追加します。
  • Variable: base_url
    • Initial Value: https://<subdomain>.api.iru.com/api/v1
    • Current Value: https://<subdomain>.api.iru.com/api/v1
<subdomain> をテナントの実際のサブドメインに置き換えるか、テナントからベース URL を直接コピーしてください。テナントに表示される URL では api.kandji.io ドメインが使用されている場合があります。<subdomain>.api.iru.com と <subdomain>.api.kandji.io のどちらも変更なしで機能します。
  • Variable: token
    • Initial Value: your_api_token_here
    • Current Value: your_api_token_here
保存 を選択して環境を保存し、右上隅の環境ドロップダウンから新しく作成した環境を選択します。
2

既存の変数に追加する

すでに環境変数を構成している場合は、既存の変数に新しい項目を追加できます。
3

ADE 統合を一覧表示する

コレクションで Iru Endpoint API > Automated Device Enrollment Integrations > GET List ADE Integrations に移動します。
4

リクエストを実行する

送信 ボタンを選択してリクエストを実行します。
5

トークン ID をコピーする

結果の Body セクションで、各 Automated Device Enrollment トークンの最上位の ID をコピーします。
6

トークン変数を作成する

各トークン ID について、ade_token_1、ade_token_2 などの命名規則で、トークンごとに番号を増やして環境変数を作成します。
7

サーバ名をメモする

各トークンに関連付けられた server_name をメモしておきます。この情報は、Apple Business または Apple School Manager からトークンをダウンロードする際に必要になります。
8

変数の値を設定する

各トークンの ID 値を、対応する ade_token_# 変数 (例: ade_token_1、ade_token_2) に貼り付けます。
9

変数を保護する

変数の種類を secret に設定すると、変数の値が表示されなくなります。

​
ADE トークンをダウンロードする

1

Apple Business または Apple School Manager にアクセスする

Apple Business または Apple School Manager アカウントにサインインします。
2

デバイスタブを開く

ページ上部の デバイス タブを選択します。
3

Management を開く

左側のサイドバーで Management を選択します。
4

一致するデバイス管理サービスを選択する

Management Services リストで、先ほど Postman で作成したリストの最初の ADE 統合の server_name と名前が一致するサービスを選択します。
5

サービスのアクションメニューを開く

そのサービスの省略記号 (…) を選択します。
6

トークンをダウンロードする

Download Token を選択します。
7

すべてのトークンについて繰り返す

更新するトークンごとに、このプロセスを繰り返します。

​
Postman のフォルダテンプレートを作成する

Postman でフォルダを作成すると、Automated Device Enrollment トークンを管理しやすくなります。
1

フォルダのオプションにアクセスする

Automated Device Enrollment Integrations フォルダの横にある省略記号を選択します。
2

新しいフォルダを追加する

Add folder を選択します。
3

フォルダに名前を付ける

フォルダに ADE_Token1 という名前を付けます。
4

統合の項目を選択する

Automated Device Enrollment Integrations フォルダに移動し、Renew ADE Integration と Update ADE Integration の項目を選択します。
5

項目をコピーする

選択した項目を右クリック (または Control キーを押しながらクリック) し、コピー を選択します。
6

新しいフォルダにアクセスする

ADE_Token1 フォルダの横にある省略記号を選択します。
7

項目を貼り付ける

Paste を選択して、コピーした項目を新しいフォルダに追加します。

​
Renew 項目を変更する

1

Renew 項目を選択する

トークンフォルダから Renew ADE Integration 項目を選択します。
2

項目の名前を変更する

トークン番号に応じて、名前を Renew ADE1 Integration (または Renew ADE2 Integration など) に変更します。
3

アドレスバーを更新する

右側のセクションで、送信 ボタンの左にあるアドレスバーを選択します。
4

トークン変数を更新する

{{ade_token_ade}} 内のテキストを選択し、トークン番号に応じて {{ade_token_1}} (または {{ade_token_2}} など) に更新します。
5

Body を構成する

下にある Body タブを選択します。
6

トークンの詳細を入力する

トークンに関連付ける blueprint_id、phone、email を入力します。
7

トークンファイルを選択する

file については、現在のファイルの横にある x を選択し、Select Files ボタンを選択します。
8

P7M ファイルを選択する

この ADE トークンに対応する .p7m ファイルを選択します。
9

変更を保存する

変更を保存します。

​
Update 項目を変更する

1

更新項目を選択する

トークンフォルダから Update ADE Integration 項目を選択します。
2

項目の名前を変更する

トークン番号に応じて、名前を Update ADE1 Integration (または Update ADE2 Integration など) に変更します。
3

アドレスバーを更新する

右側のセクションで、送信 ボタンの左にあるアドレスバーを選択します。
4

トークン変数を更新する

{{ade_token_ade}} 内のテキストを選択し、トークン番号に応じて {{ade_token_1}} (または {{ade_token_2}} など) に更新します。
5

Body を構成する

下にある Body タブを選択します。
6

更新情報を入力する

ここで新しい blueprint_id、phone、email の情報を入力できます。
7

変更を保存する

変更を保存します。

​
ADE_Token フォルダを複製する

1

フォルダのオプションにアクセスする

ADE_Token1 フォルダの横にある省略記号を選択します。
2

フォルダを複製する

Duplicate を選択します。
3

フォルダの内容を更新する

上記のプロセスを使用して、フォルダの内容を更新します。
4

追加のフォルダを作成する

ADE トークンごとにフォルダの複製を作成します。

​
ADE 統合を更新する

すべての構成が完了したので、Renew コマンドを送信できます。
1

Renew コマンドを選択する

作成した特定のトークンフォルダ (例: ADE_Token1、ADE_Token2 など) に移動し、トークン番号に対応する Renew ADE1 Integration (または Renew ADE2 Integration など) 項目を選択します。
2

コマンドを実行する

Send ボタンを選択します。

​
ADE 統合を変更する

ADE 統合を変更すると、関連付けられた Blueprint ID、電話番号、メールアドレスを変更できます。
1

更新コマンドを選択する

作成した特定のトークンフォルダ (例: ADE_Token1、ADE_Token2 など) に移動し、トークン番号に対応する Update ADE1 Integration (または Update ADE2 Integration など) 項目を選択します。
2

詳細を更新する

Body セクションで更新が必要な詳細を更新します。
3

コマンドを実行する

Send ボタンを選択します。

​
現在の統合を確認する

Iru Endpoint API > Automated Device Enrollment Integrations > GET List ADE Integrations コマンドを使用すると、現在のすべての ADE 統合が返されるため、統合が正常に更新または変更されたことを確認できます。
1

List コマンドを選択する

コレクションで Iru Endpoint API > Automated Device Enrollment Integrations > GET List ADE Integrations を選択します。
2

コマンドを実行する

Send ボタンを選択します。
3

更新を確認する

Renew コマンドが成功した場合、days_left 変数は 364 になります。
4

変更を確認する

変更を確認するには、ADE トークンに関連付けられた情報をチェックして、更新されていることを確認します。

​
統合を削除する

Iru Endpoint API > Automated Device Enrollment Integrations > DEL Delete ADE Integration コマンドは、指定された ADE トークン ID に関連付けられた ADE 統合を削除します。
1

削除コマンドを選択する

コレクションで Iru Endpoint API > Automated Device Enrollment Integrations > DEL Delete ADE Integration を選択します。
2

トークン ID を設定する

ade_token_id 変数に ADE トークンの ID を入力します。
3

コマンドを実行する

Send ボタンを選択します。

​
考慮事項

  • API トークンのセキュリティ: API トークンが安全に保管され、ADE 操作に適切な権限を持っていることを確認します
  • Postman の構成: API 操作を成功させるには、Postman を適切に設定することが不可欠です
  • 環境変数: 環境変数を使用して、複数のトークン ID を効率的に管理します
  • エラー処理: API エラーやトークンの検証に関する問題のトラブルシューティングに備えておきます
  • トークンのライフサイクル: ADE トークンには有効期限があり、登録機能を維持するには定期的な更新が必要です
  • トークンファイルの管理: ダウンロードした .p7m ファイルを把握し、正しいトークン ID に関連付けます
  • Apple Business または Apple School Manager へのアクセス: ポータルにサインインしてトークンをダウンロードできることを確認します
  • 検証プロセス: 統合のステータスとトークンの有効期限を確認して、操作が成功したことを常に検証します
  • 一括操作: フォルダテンプレートを使用して、複数のトークンを効率的に管理します
  • アクセス制御: 承認された担当者のみがトークン管理操作にアクセスできるようにします
  • テスト: 一括操作を実行する前に、小規模で操作をテストします
  • 監視: トークンの有効期限と更新スケジュールを定期的に監視します
  • ドキュメント: トークンの構成と関連するサーバ名を記録しておきます
  • バックアップ戦略: トークンの構成と API 設定のバックアップを保持します