# API キーの管理

API キーは認証に使用される一意の識別子であり、ユーザー、開発者、またはプログラムが API に安全にアクセスできるようにします。API キーは API の使用状況を追跡および制御するために不可欠であり、不正使用を防止して、安全な通信を確保するのに役立ちます。

[Managing API keys in Qlik Cloud](https://play.vidyard.com/FY9N3NwFQKALEcSBp3Bxy6)

## API キーを使用してQlik Cloud API に接続する

API キーを使用して、Qlik REST API リファレンスと対話できます。API アクセスには、Postman や qlik-cli などのツールを使用できます。詳細については、「[Qlik API の概要](https://qlik.dev/apis)と [qlik-cli](https://qlik.dev/toolkits/qlik-cli)」を参照してください。

情報メモ

API 資格情報は Qlik Cloud への直接的なプログラムによるアクセスを提供し、ユーザー インターフェイスで利用可能なワークフローに限定されません。最小権限の原則を使用して、ロールと OAuth スコープを割り当てます。サービス アカウントと API 資格情報は、管理者資格情報と同じレベルで慎重に取り扱ってください。詳細については、「[API アクセス制御と信頼境界](https://qlik.dev/manage/access-control/api-trust-boundaries/)」を参照してください。

例: Postman を使用して Qlik API に接続する

次の手順を実行します。

1. Postmanを開始します。

2. HTTP メソッドを GET に設定します。

3. Qlik Cloud API エンドポイントの URL を入力します。

   たとえば、テナント内のすべてのスペースを一覧表示するには、次を実行します。

   `https://your-tenant.eu.qlikcloud.com/api/v1/spaces`

4. [認証] タブで、 [認証タイプ] として [ベアラー トークン] を選択します。

5. [トークン] フィールドに API キーを入力します。

6. [Send] (送信)をクリックします。

リクエストが成功すると、API は JSON 応答を返します。この例では、応答にスペースのリストが含まれます。

## API キー設定の構成

次の手順を実行します。

1. 管理 アクティビティ センターで、 [設定] ページに移動します。

2. [セキュリティ] タブを選択します。

3. [API キー] セクションで、必要に応じて次の設定を調整します。

   * トークンの最大有効期限を変更: 新しく生成された API トークンの有効期限を設定します。既存の API キーは、元の有効期限値を保持します。この値に上限はありません。

   * ユーザーごとのアクティブ API キーの最大数を変更: ユーザーが持つことのできる API キーの上限を設定します。この制限は新しいキーにのみ適用されます。上限に達すると、ユーザーは追加のキーを作成できなくなります。最大値は 1000 です。

変更が個人用設定ページの API キー セクションに反映されることを確認するには、ブラウザを更新する必要がある場合があります。

## API キーの生成と管理

### API キーの生成

新しい API キーを生成するには、 [API キーを管理] 権限を持つカスタム ロールを持っているか、デフォルトの権限で許可されている必要があります。

次の手順を実行します。

1. ユーザー プロファイル アイコンをクリックして、 [設定] を選択します。

2. [API キー] セクションに移動して、 [新規キーの生成] をクリックします。

3. API キーの説明を入力して、有効期限を設定します。

4. [生成] をクリックしてキーを作成します。

5. 生成された API キーをコピーして、安全に保管します。後でキーを取得することはできませんのでご注意ください。

### API キーの編集

API キーの名前は、作成後に変更できます。

### API キーの削除

情報メモAPI キーの削除は永続的であり、元に戻すことはできません。このアクションにより、キーに依存する進行中のプロセスや統合が中断されないことを確認してください。

次の手順を実行します。

1. ユーザー プロファイル アイコンをクリックして、 [設定] を選択します。

2. [API キー] セクションに移動します。

3. 削除する API キーの隣にある the 詳細 icon をクリックし、 [削除] を選択します。

4. すべてのキーを削除するには、キーのリストの上部にある [すべて削除] をクリックします。

## API キーの監視と取り消し

アクティビティ センターの [API キー管理] セクションで、テナントに関連付けられているすべての API キーを表示できます。名前、ID、または所有者でキーを検索できます。

### API キーのステータス

API キーには次のステータスがあります。

* アクティブ: API キーは現在使用されています。
* 期限切れ: 有効期限が切れています。
* 取り消し済み: API キーは取り消されており、使用できなくなります。

### API キーの取り消し

テナント管理者として、API キーのアクティビティを積極的に監視することは、セキュリティを維持するために不可欠です。不審なアクティビティが検出された場合は、API キーを取り消すことができます。

情報メモAPI キーを取り消すと、そのキーはすぐに無効化され、そのキーに依存する進行中のプロセスや統合に影響します。取り消しを元に戻すことはできず、取り消された API キーを再度有効にすることはできません。

次の手順に従ってください:

1. 管理 アクティビティ センターで、 [イベント] に移動します。

2. 特定の API キーの過剰な使用など、不審なアクティビティがないか探してください。

3. イベントの横にある the 下向き矢印 icon をクリックして詳細を展開し、API キー ID をコピーします。

4. API キー セクションに移動し、その ID を使用して API キーを検索します。

5. キーの横にある the 詳細 icon をクリックし、[取り消し] を選択します。ステータスがアクティブのキーのみを取り消すことができます。

6. 複数の API キーを取り消すには、表内で API キーを選択し、右上隅にある [取り消し] をクリックします。

### API キー管理のベスト プラクティス

* キーの機密性を保つ: API キーを安全に保存し、パブリック コード リポジトリに公開されないようにします。

* 定期的に再生成する: セキュリティを強化するために、API キーを定期的に再生成します。

* 使用状況を監視する: API キーのアクティビティを定期的にチェックし、不審な動作を特定します。