APIトークンは、サードパーティサービスがアプリやシステムと安全に通信するための一意の識別子です。APIトークンは、Staffbaseプラットフォームとサードパーティアプリやシステム間で通信を確立する必要がある統合シナリオでよく使用されます。スタジオでAPIトークンを作成し、サードパーティサービスがStaffbaseプラットフォームと通信できるようにします。その後、トークンを使用してStaffbaseプラットフォームへのアクセスをリクエストできます。APIトークンは、異なるアクセス許可レベルで作成できます。

必要なアクセスレベルを指定してAPIトークンを作成できます。さらに、APIトークンの使用を許可する特定のIPアドレスやCIDR範囲を定義できます。この設定により、トークンの露出を制限し、不正使用のリスクを低減できます。

1. スタジオで、設定 > APIアクセスを開きます。
2. APIトークンの作成をクリックします。
   APIトークンページが開きます。
3. APIトークンの作成をクリックします。
   APIトークンの作成ダイアログが開きます。
4. トークン名フィールドに名前を入力します。

5. アクセスレベルを選択します。

   APIに必要なアクセスレベルは、ビジネスの利用ケースによって異なります。たとえば、「読み取り専用」限定アクセスはRSSフィードに十分ですが、高度な統合には管理アクセスが必要です。
6. 必要に応じて、詳細を展開し、許可されたIP範囲を定義します。
7. 許可されたIP範囲フィールドに、このトークンの使用を許可するIPアドレスまたはCIDR範囲を入力します。
8. 作成するをクリックします。
   作成されたトークンシークレットが表示されます。

9. コピーするをクリックしてトークンシークレットをコピーします。

   トークンシークレットは一度だけ表示されます。コピーする前に画面を離れると、再取得できません。

10. OKをクリックします。

APIトークンの作成と保存が完了しました。トークンシークレットを紛失した場合は、トークンを回転するか、新しいトークンを作成する必要があります。