API キーの管理

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

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

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

例: 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. [送信] をクリックします。

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

テナントでの API キーの有効化

既定では、API キーの生成は無効になっています。テナント管理者は、ユーザーが API キーを生成できるように、テナント内で API キーを有効にする必要があります。

次の手順を実行します。

1. Administration アクティビティ センターで、 [設定] に移動します。
2. [API キー] で [API キーを有効にする] を選択します。

3. 必要に応じて、次の設定を調整します。

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

   • ユーザーごとのアクティブな API キーの最大数を変更: この制限は新しい API キーにのみ適用されます。制限に達すると、追加の API キーの作成は拒否されます。設定できる最大値は 1000 です。
   情報メモ変更がユーザー プロファイル ページの API キー セクションに反映されることを確認するには、ブラウザを更新する必要がある場合があります。

4. API キーの生成を開始するには、 [新規生成] をクリックします。ユーザー プロファイルの API キー セクションにリダイレクトされます。

API キーの生成と管理

API キーの生成

新しい API キーを生成するには、開発者ロールが必要です。テナント管理者はユーザーにこのロールを割り当てることができます。

次の手順を実行します。

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

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

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

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

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

API キーの編集

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