Kandji API

Kandji APIとは何ですか?

Kandji APIは、組織内のAppleデバイスの管理とセキュリティ保護を支援するために設計された堅牢なツールです。これにより、タスクを自動化したり、他のサービスと統合したり、ユーザーインターフェイスを超えてKandjiの機能を強化したりできます。

API トークンの生成

特定のユースケースごとに、一意のAPIトークンを作成いただくことをお勧めします。簡単に識別できるように、 Kandji Web アプリ内で明確でわかりやすい名前を割り当てることを検討してください。

Kandji は、テナントレベルのベアラートークンを使用して API へのアクセスを制御します。

生成するには:

  1. ログインして[設定]をクリックします。

  2. [アクセス] タブをクリックします。

  3. [Add API Token] ボタンをクリックして、新しい API キーを作成します。 

  4. API トークンの [名前 ] と [説明] を入力します。

  5. [作成] をクリックします 

  6. Kandji API トークンを含むモーダルが表示されます。表示記号をクリックして表示するか、[トークンのコピー] ボタンを使用して API トークンをクリップボードにコピーし、安全な場所に格納します。 注:トークンの詳細を再び表示することはできません。

  7. 「次へ」をクリックします

  8. [構成] をクリックしてこの特定のトークンの API アクセス許可を管理するか、[ スキップ] をクリックして後で変更します。 

  9. 変更を加えたら、[保存] をクリックします。

  10. 最初のトークンを作成すると、テナント固有の API URL が表示されます

API トークンの検査、変更、または取り消し

API トークンを作成した後で Kandji Web アプリからトークンを作成した管理者ユーザーを削除すると、API トークンも削除されます。

テナントのAPIトークンを作成した後、その名前とアクセス許可を変更したり、取り消してそれ以上のアクセスを防止したりできます。 

トークンの検査または変更

  1. トークンの横にある縦 の省略記号 をクリックします。 

  2. [表示] をクリックすると、トークンに関連付けられているアクセス許可など、トークンに関する情報が表示されます。このページでは、次のオプションを使用できます。

    1. 「権限」タブをクリックして、トークンに関連付けられた権限を編集します。 

    2. [アクティビティ] タブをクリックして、次のような API トークンのアクティビティを表示します。

      • トークン作成

      • トークン名の変更

      • トークンのアクセス許可編集

トークンの取り消し

  1. 右下隅にある [編集] をクリックして、トークンの名前を編集します。

  2. 取り消し」をクリックして、API トークンを無効にし、それ以上使用されないようにします。トークンを取り消すと、テナントの API トークンの一覧に表示されなくなります。 

APIドキュメント 

API エンドポイントの完全なドキュメントは、 api-docs.kandji.io よりご確認いただけます。この記事では、 Kandji テナント内で API トークンを生成する手順について説明します。

API レート制限

現在、 Kandji API の API レート制限は、テナントあたり 1 時間あたり 10,000 リクエストです。