複数の自動デバイス登録トークンを更新、アップデート、または削除する

  • hC
  • EF

自動デバイス登録トークンを追加する必要がある場合は、 複数の自動デバイス登録トークンの設定 の記事をご覧ください。

このプロセスをご自身で完了することに不安な場合は、 Kandji サポート に連絡してサポートを受けてください。

Kandji API トークンの構成

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

  1. 既存の API トークンを作成または変更します。

  2. Kandji テナントで、[設定] > [アクセス > API トークン] に移動します。

  3. 既存の API トークンを作成または変更して、すべての自動デバイス登録関連の権限を含めます。

Postmanを準備する

基本的な構成については、 Postman で Kandji API を設定する方法に関する 記事を参照してください。この後の手順のほとんどは、デバイスのPostmanアプリケーション内で実行されます。Postman がすでに構成されている場合は、このセクションをスキップできます。

  1. コレクションで Automated Device Enrollment integrations フォルダーを確認します。

  2. このフォルダが見つからない場合は、 api-docs.kandji.io に移動し、[Postmanで実行]ボタンをクリックして、手順に従って新しいAPIバージョンをインポートします。

  3. コレクションの上部にある Kandji API フォルダーで未定義の場合は、API URL を定義します。

  4. 「Postman で Kandji API を設定する方法」の記事に従って、環境変数で API トークンを定義します。

Postman 環境変数の設定

Postman の基本を構成したので、自動デバイス登録サーバーを管理するために、Postman でいくつかの環境変数を定義する必要があります。

  1. 「Postman で Kandji API を設定する方法」の記事の環境変数の設定セクションの指示に従ってください。

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

  3. コレクション内でKandji API > Automated Device Enrollment Integrations > GET List ADE Integrationsを選択します。

  4. [送信] ボタンをクリックします。 

  5. 結果の [ボディ] セクションで、各自動デバイス登録トークンの最上位の ID をコピーします。

  6. これらの ID ごとに、例えば「ade_token_1」などの名前付け規則を使用して環境変数を作成し、トークンごとに末尾の番号を増やします。

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

  8. 各トークンの ID 値をマシンの "ade_token_#" 変数の値に貼り付けます。

  9. 変数のタイプをシークレットに設定して、変数の値が表示されないようにすることができます。 

ADEトークンのダウンロード

  1. Apple Business Managerアカウントにログインします。

  2. 左下のプロフィールをクリックし、[設定]を選択します。 

  3. 以前に作成したリストの最初のADEトークンに一致する最初の MDM サーバーをクリックします。

  4. 「MDMサーバートークンのダウンロード」をクリックします。 

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

Postmanフォルダテンプレートの作成

Postmanでフォルダを作成すると、自動デバイス登録トークンの管理が容易になります。

  1. 「Automated Device Enrollment Integrations」フォルダの横にある省略記号をクリックします。

  2. [フォルダを追加] をクリックします。 

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

  4. Automated Device Enrollment Integrationsフォルダの「Renew ADE Integration」および「Update ADE Integration」の項目を選択します。

  5. それらを右クリックして、[コピー]を選択します。

  6. ADE_Token1フォルダの横にある円をクリックします。

  7. [貼り付け] をクリックします。

更新アイテムの変更

  1. Automated Device Enrollment Integrations項目を選択します。

  2. 名前を「Renew ADE1 Integration」に変更します。

  3. 右側のセクションで、[送信]ボタンの左側にあるアドレスバーをクリックします。

  4. {{ade_token_ade}} 内のテキストを選択し、{{ade_token_1}} に更新します。

  5. 下の「本文」タブをクリックします。

  6. トークンに関連付けるblueprint_id、phone、およびemailを入力します。 

  7. ファイルの場合は、現在のファイルの横の [x] をクリックし、[ファイルの選択] をクリックします。

  8. この ADE トークンに一致する .p7m ファイルを選択します。

  9. 変更を保存します。

更新項目の変更

  1. Automated Device Enrollment Integrations項目を選択します。

  2. 名前を「Update ADE1 Integration」に変更します。

  3. 右側のセクションで、[送信]ボタンの左側にあるアドレスバーをクリックします。

  4. {{ade_token_ade}} 内のテキストを選択し、{{ade_token_1}} に更新します。

  5. 下の「本文」タブをクリックします。

  6. ここでは、新しいblueprint_id、phone、およびemailの情報を入力できます。 

  7. 変更を保存します。

ADE_Tokenフォルダの複製

  1. ADE_Token1フォルダの横にある３点マークをクリックします。

  2. [Duplicate] を選択します。 

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

  4. 各 ADE トークンのフォルダーを複製します。

ADE統合の更新

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

  1. Kandji API > [Automated Device Enrollment Integrations] > ADE_Token# を選択し> [Renew ADE# Integration] を選択します。

  2. [送信] ボタンをクリックします。 

ADE 統合のアップデート

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

  1. [ Kandji API] > [Automated Device Enrollment Integrations > ADE_Token# > Update ADE# Integration] を選択します。

  2. 更新が必要な [本文] セクションの詳細を更新します。

  3. [送信] ボタンをクリックします。 

現在の統合を確認する

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

  1. [ Kandji API] > [Automated Device Enrollment Integrations] を選択し> GET でコレクション内の ADE 統合を一覧表示します。

  2. [送信] ボタンをクリックします。

  3. Renew コマンドが成功した場合、days_left変数は 364 である必要があります。 

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

統合の削除

Kandji API > 自動デバイス登録統合 > DEL [ADE 統合の削除] コマンドは、指定された ADE トークン ID に関連付けられている ADE 統合を削除します。

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

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

  • [送信] ボタンをクリックします。