APIキー

個人用Runner APIキーを安全に生成、コピー、識別、および取り消します。

APIキーは、プログラムによるRunner アクセスのための個人的なシークレットです。信頼できるアプリケーションに対してのみ1つを作成し、安全に保存し、不要になったら取り消します。

このガイドの内容

ワンタイム シークレットを作成して保存する方法、既存のキーを公開せずに識別する方法、確認付きでキーを取り消す方法を理解します。

利用可能性と前提条件

• APIキー は条件付きであり、アカウントで有効になっている場合にのみ表示されます。
• 画面には、各キーはあなたとして動作しますと表示されます。キーは個人アカウントに属し、特定のストア専用ではありません。
• ワークスペースの一般設定にある読み取り専用の分析APIキーとは異なります。
• 完全なキーをチャット、エージェント メモリ、スキル、スクリーンショット、ソース管理、または製品ドキュメントに入れないでください。

エントリパス

設定 → アカウント名 → APIキーを選択します。項目がない場合、現在のアカウントでは利用できません。

コントロール

英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。

空の一覧は初期状態です。この例ではシークレットの生成や表示を行っていません。画像は英語の画面です。

認証情報を作成する前にダイアログを確認する

1. 新しいキーを生成を選択します。
2. 任意の名前欄を確認します。Reporting integration などの名前を付けると、後でアプリケーションを識別できます。
3. 確認だけの場合はキャンセルを選択します。キーを作成を選択するまでキーは作成されません。

以下の手順は、APIキーを利用でき、新しいシークレットを安全に保存する準備ができた場合に行います。

キーを生成して保存

1. アカウント名 → APIキーを開きます。
2. 新しいキーを生成 を選択します。
3. アプリケーションまたは環境など、説明的な名前を入力します。シークレットを名前に入れないでください。
4. キーを作成 を選択します。
5. APIキーが生成されました で、必要な場合のみキーを公開し、コピーを選択します。
6. 信頼できるシークレット マネージャーに保存します。
7. 保存しました を選択する前に、保存された値を確認します。
8. テーブル プレフィックスを使用して、完全な値を公開せずに後でキーを識別します。

Runnerは、完全なキーが再度表示されないことを警告します。ダイアログを保存せずに閉じた場合は、そのキーを取り消し、シークレットを回復しようとするのではなく、置き換えを作成してください。

キーを取り消す

1. 名前とプレフィックスで目的のキーを照合します。
2. その削除アイコンを選択します。
3. 取り消す 確認を確認します。
4. 依存するアプリケーションが使用を停止する準備ができている場合にのみ、取り消す を選択します。
5. APIキーが取り消されました を確認し、アプリケーションから古いシークレットを削除します。

取り消しは破壊的であり、元に戻すことはできません。アクセスが再度必要な場合は、新しいキーを作成します。

状態と制限

• APIキーはまだありません は通常の空の状態です。
• 新しいキーの完全な値は、成功ダイアログにのみ表示されます。
• 既存の行は、回復可能なキーではなく、プレフィックスと使用日を表示します。
• 最後に使用した の下の なし は、Runnerがそのキーのリクエストを記録していないことを意味します。
• 作成ボタンと取り消しボタンは進行状況を表示し、繰り返し送信しないでください。

トラブルシューティング

• APIキーが見つからない場合は、コピーされた直接リンクを使用しないでください。機能はこのアカウントで無効になっています。
• クリップボード コピーが失敗した場合は、新しい値を公開し、安全なシークレット マネージャーに手動でコピーしてから、再度非表示にします。
• 完全なキーを失った場合は、その行を取り消し、置き換えを生成します。
• 取り消し後にアプリケーションが機能しなくなった場合は、新しく作成されたキーで更新してください。古いキーは復元できません。
• 間違ったキーが選択された場合は、確認をキャンセルし、名前とプレフィックスを再度比較してください。

関連ガイド

• セキュリティとセッション
• 個人設定とワークスペース
• メモリ安全性