APIキー

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

このガイドの内容

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

利用可能性と前提条件

• APIキー は条件付きであり、アカウントで有効になっている場合にのみ表示されます。
• キーは1つのストアではなく、個人アカウントに属します。
• 完全なキーをチャット、エージェント メモリ、スキル、スクリーンショット、ソース管理、または製品ドキュメントに入れないでください。

エントリパス

アバター → 設定 → 個人 → APIキー を選択します。エントリが見つからない場合、機能は現在のアカウントで利用できません。

コントロール

キーを生成して保存

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

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

キーを取り消す

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

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

状態と制限

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

トラブルシューティング

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

関連ガイド

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