> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Iru API を使用して ADE トークンを更新、変更、削除する

> Iru Endpoint API で Automated Device Enrollment トークンを更新、変更、削除し、有効期限切れを防いで Apple Business との接続を維持します。

<Note title="Apple Business の名称変更">
  **Apple Business Manager** は **Apple Business** になりました。**Apple School Manager** は変更されていません。詳細については、[Introducing Apple Business](https://www.apple.com/newsroom/2026/03/introducing-apple-business-a-new-all-in-one-platform-for-businesses-of-all-sizes/) および [Apple Business Manager is now Apple Business](https://support.apple.com/guide/apple-business-manager/apple-business-manager-is-now-apple-business-axmd79d79dea/web) を参照してください。
</Note>

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

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

### 仕組み

ADE トークンの管理では、Postman を通じて Iru Endpoint API を使用し、複数のトークンに対して一括操作を実行します。このプロセスには、API アクセスの構成、環境変数の設定、Apple Business または Apple School Manager からのトークンのダウンロード、自動化されたワークフローを使用したトークンの効率的な更新、変更、削除が含まれます。

<Warning>
  このプロセスを自分で完了する自信がない場合は、[Iru Endpoint サポート](/ja/iru/iru-support/access-to-iru-support)にお問い合わせのうえ、追加のガイダンスを受けてください。
</Warning>

### 前提条件

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

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

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

<Steps>
  <Step title="API トークンを作成または変更する">
    必要な権限を持つ新しい API トークンを作成するか、既存のトークンを変更します。
  </Step>

  <Step title="APIトークン を開く">
    Iru Endpoint テナントのサイドバーで [**アカウントメニューボタン**](/ja/iru/platform-overview/account-menu) を選択し、**アクセス** → **APIトークン** を選択します。
  </Step>

  <Step title="権限を構成する">
    API トークンを作成するか既存のトークンを変更して、Automated Device Enrollment 関連のすべての権限を含めます。
  </Step>
</Steps>

### Postman を準備する

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

<Steps>
  <Step title="コレクションの構造を確認する">
    コレクションに Automated Device Enrollment integrations フォルダがあることを確認します。
  </Step>

  <Step title="API URL を定義する">
    API URL が未定義の場合は、コレクション上部の Iru Endpoint API フォルダで定義します。
  </Step>

  <Step title="環境変数を構成する">
    「Postman で Iru Endpoint API を設定する方法」の記事に従って、Environment 変数で API トークンを定義します。
  </Step>
</Steps>

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

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

<Steps>
  <Step title="環境変数を作成する">
    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`

    <Note>`<subdomain>` をテナントの実際のサブドメインに置き換えるか、テナントからベース URL を直接コピーしてください。テナントに表示される URL では `api.kandji.io` ドメインが使用されている場合があります。`<subdomain>.api.iru.com` と `<subdomain>.api.kandji.io` のどちらも変更なしで機能します。</Note>

    * **Variable**: `token`
      * **Initial Value**: `your_api_token_here`
      * **Current Value**: `your_api_token_here`

    **保存** を選択して環境を保存し、右上隅の環境ドロップダウンから新しく作成した環境を選択します。
  </Step>

  <Step title="既存の変数に追加する">
    すでに環境変数を構成している場合は、既存の変数に新しい項目を追加できます。
  </Step>

  <Step title="ADE 統合を一覧表示する">
    コレクションで **Iru Endpoint API** > **Automated Device Enrollment Integrations** > **GET List ADE Integrations** に移動します。
  </Step>

  <Step title="リクエストを実行する">
    **送信** ボタンを選択してリクエストを実行します。
  </Step>

  <Step title="トークン ID をコピーする">
    結果の **Body** セクションで、各 Automated Device Enrollment トークンの最上位の ID をコピーします。
  </Step>

  <Step title="トークン変数を作成する">
    各トークン ID について、`ade_token_1`、`ade_token_2` などの命名規則で、トークンごとに番号を増やして環境変数を作成します。
  </Step>

  <Step title="サーバ名をメモする">
    各トークンに関連付けられた `server_name` をメモしておきます。この情報は、Apple Business または Apple School Manager からトークンをダウンロードする際に必要になります。
  </Step>

  <Step title="変数の値を設定する">
    各トークンの ID 値を、対応する `ade_token_#` 変数 (例: `ade_token_1`、`ade_token_2`) に貼り付けます。
  </Step>

  <Step title="変数を保護する">
    変数の種類を secret に設定すると、変数の値が表示されなくなります。
  </Step>
</Steps>

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

<Steps>
  <Step title="Apple Business または Apple School Manager にアクセスする">
    [Apple Business](https://business.apple.com) または [Apple School Manager](https://school.apple.com) アカウントにサインインします。
  </Step>

  <Step title="デバイスタブを開く">
    ページ上部の **デバイス** タブを選択します。
  </Step>

  <Step title="Management を開く">
    左側のサイドバーで **Management** を選択します。
  </Step>

  <Step title="一致するデバイス管理サービスを選択する">
    **Management Services** リストで、先ほど Postman で作成したリストの最初の ADE 統合の `server_name` と名前が一致するサービスを選択します。
  </Step>

  <Step title="サービスのアクションメニューを開く">
    そのサービスの省略記号 (**…**) を選択します。
  </Step>

  <Step title="トークンをダウンロードする">
    **Download Token** を選択します。
  </Step>

  <Step title="すべてのトークンについて繰り返す">
    更新するトークンごとに、このプロセスを繰り返します。
  </Step>
</Steps>

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

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

<Steps>
  <Step title="フォルダのオプションにアクセスする">
    Automated Device Enrollment Integrations フォルダの横にある省略記号を選択します。
  </Step>

  <Step title="新しいフォルダを追加する">
    Add folder を選択します。
  </Step>

  <Step title="フォルダに名前を付ける">
    フォルダに ADE\_Token1 という名前を付けます。
  </Step>

  <Step title="統合の項目を選択する">
    **Automated Device Enrollment Integrations** フォルダに移動し、**Renew ADE Integration** と **Update ADE Integration** の項目を選択します。
  </Step>

  <Step title="項目をコピーする">
    選択した項目を右クリック (または Control キーを押しながらクリック) し、**コピー** を選択します。
  </Step>

  <Step title="新しいフォルダにアクセスする">
    ADE\_Token1 フォルダの横にある省略記号を選択します。
  </Step>

  <Step title="項目を貼り付ける">
    **Paste** を選択して、コピーした項目を新しいフォルダに追加します。
  </Step>
</Steps>

### Renew 項目を変更する

<Steps>
  <Step title="Renew 項目を選択する">
    トークンフォルダから **Renew ADE Integration** 項目を選択します。
  </Step>

  <Step title="項目の名前を変更する">
    トークン番号に応じて、名前を **Renew ADE1 Integration** (または **Renew ADE2 Integration** など) に変更します。
  </Step>

  <Step title="アドレスバーを更新する">
    右側のセクションで、**送信** ボタンの左にあるアドレスバーを選択します。
  </Step>

  <Step title="トークン変数を更新する">
    `{{ade_token_ade}}` 内のテキストを選択し、トークン番号に応じて `{{ade_token_1}}` (または `{{ade_token_2}}` など) に更新します。
  </Step>

  <Step title="Body を構成する">
    下にある Body タブを選択します。
  </Step>

  <Step title="トークンの詳細を入力する">
    トークンに関連付ける `blueprint_id`、phone、email を入力します。
  </Step>

  <Step title="トークンファイルを選択する">
    file については、現在のファイルの横にある x を選択し、Select Files ボタンを選択します。
  </Step>

  <Step title="P7M ファイルを選択する">
    この ADE トークンに対応する .p7m ファイルを選択します。
  </Step>

  <Step title="変更を保存する">
    変更を保存します。
  </Step>
</Steps>

### Update 項目を変更する

<Steps>
  <Step title="更新項目を選択する">
    トークンフォルダから **Update ADE Integration** 項目を選択します。
  </Step>

  <Step title="項目の名前を変更する">
    トークン番号に応じて、名前を **Update ADE1 Integration** (または **Update ADE2 Integration** など) に変更します。
  </Step>

  <Step title="アドレスバーを更新する">
    右側のセクションで、**送信** ボタンの左にあるアドレスバーを選択します。
  </Step>

  <Step title="トークン変数を更新する">
    `{{ade_token_ade}}` 内のテキストを選択し、トークン番号に応じて `{{ade_token_1}}` (または `{{ade_token_2}}` など) に更新します。
  </Step>

  <Step title="Body を構成する">
    下にある Body タブを選択します。
  </Step>

  <Step title="更新情報を入力する">
    ここで新しい `blueprint_id`、phone、email の情報を入力できます。
  </Step>

  <Step title="変更を保存する">
    変更を保存します。
  </Step>
</Steps>

### ADE\_Token フォルダを複製する

<Steps>
  <Step title="フォルダのオプションにアクセスする">
    ADE\_Token1 フォルダの横にある省略記号を選択します。
  </Step>

  <Step title="フォルダを複製する">
    Duplicate を選択します。
  </Step>

  <Step title="フォルダの内容を更新する">
    上記のプロセスを使用して、フォルダの内容を更新します。
  </Step>

  <Step title="追加のフォルダを作成する">
    ADE トークンごとにフォルダの複製を作成します。
  </Step>
</Steps>

### ADE 統合を更新する

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

<Steps>
  <Step title="Renew コマンドを選択する">
    作成した特定のトークンフォルダ (例: **ADE\_Token1**、**ADE\_Token2** など) に移動し、トークン番号に対応する **Renew ADE1 Integration** (または **Renew ADE2 Integration** など) 項目を選択します。
  </Step>

  <Step title="コマンドを実行する">
    Send ボタンを選択します。
  </Step>
</Steps>

### ADE 統合を変更する

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

<Steps>
  <Step title="更新コマンドを選択する">
    作成した特定のトークンフォルダ (例: **ADE\_Token1**、**ADE\_Token2** など) に移動し、トークン番号に対応する **Update ADE1 Integration** (または **Update ADE2 Integration** など) 項目を選択します。
  </Step>

  <Step title="詳細を更新する">
    Body セクションで更新が必要な詳細を更新します。
  </Step>

  <Step title="コマンドを実行する">
    Send ボタンを選択します。
  </Step>
</Steps>

### 現在の統合を確認する

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

<Steps>
  <Step title="List コマンドを選択する">
    コレクションで Iru Endpoint API > Automated Device Enrollment Integrations > GET List ADE Integrations を選択します。
  </Step>

  <Step title="コマンドを実行する">
    Send ボタンを選択します。
  </Step>

  <Step title="更新を確認する">
    Renew コマンドが成功した場合、`days_left` 変数は 364 になります。
  </Step>

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

### 統合を削除する

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

<Steps>
  <Step title="削除コマンドを選択する">
    コレクションで Iru Endpoint API > Automated Device Enrollment Integrations > DEL Delete ADE Integration を選択します。
  </Step>

  <Step title="トークン ID を設定する">
    `ade_token_id` 変数に ADE トークンの ID を入力します。
  </Step>

  <Step title="コマンドを実行する">
    Send ボタンを選択します。
  </Step>
</Steps>

### 考慮事項

<AccordionGroup>
  <Accordion title="API のセキュリティ、Postman、環境の設定">
    * **API トークンのセキュリティ**: API トークンが安全に保管され、ADE 操作に適切な権限を持っていることを確認します
    * **Postman の構成**: API 操作を成功させるには、Postman を適切に設定することが不可欠です
    * **環境変数**: 環境変数を使用して、複数のトークン ID を効率的に管理します
    * **エラー処理**: API エラーやトークンの検証に関する問題のトラブルシューティングに備えておきます
  </Accordion>

  <Accordion title="トークン、ファイル、Apple ポータルへのアクセス">
    * **トークンのライフサイクル**: ADE トークンには有効期限があり、登録機能を維持するには定期的な更新が必要です
    * **トークンファイルの管理**: ダウンロードした .p7m ファイルを把握し、正しいトークン ID に関連付けます
    * **Apple Business または Apple School Manager へのアクセス**: ポータルにサインインしてトークンをダウンロードできることを確認します
    * **検証プロセス**: 統合のステータスとトークンの有効期限を確認して、操作が成功したことを常に検証します
  </Accordion>

  <Accordion title="一括操作とアクセス制御">
    * **一括操作**: フォルダテンプレートを使用して、複数のトークンを効率的に管理します
    * **アクセス制御**: 承認された担当者のみがトークン管理操作にアクセスできるようにします
  </Accordion>

  <Accordion title="テスト、監視、継続性">
    * **テスト**: 一括操作を実行する前に、小規模で操作をテストします
    * **監視**: トークンの有効期限と更新スケジュールを定期的に監視します
    * **ドキュメント**: トークンの構成と関連するサーバ名を記録しておきます
    * **バックアップ戦略**: トークンの構成と API 設定のバックアップを保持します
  </Accordion>
</AccordionGroup>