コンテンツへスキップ
JA
APIキーを取得する
ドキュメントを探す

はじめに

API キーの管理

アプリやエージェントのキーを作成します。 保管し、アクセスを確認し、ライフサイクルを管理します。

このページの内容

1. キーを作成する

  1. 確認済みのアカウントにサインインし、API Keysを開きます。 既に1つを持っている場合は、認証されたキーを再利用します。
  2. アプリと環境で名前を付け、expiry を選択し、必要なソースを選択します。 最初の検索例に Google Search を選択します。
  3. キーを作成し、以下に保存します。 独立したエージェントとプロダクションアプリを別々のキーで、個別にそれらを取り消すことができます。

2. キーを貯えて下さい

FlashDataを実行する方法を選択します。 API と SDK の例では、FLASHDATA_API_KEY が読み込まれています。CLI は、保護されたプロファイルでキーを保存できます。 生産では、あなたの秘密ストアから認証情報を注入します。

この端末のキーを設定する
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY

3. アクセスの確認

同じターミナルかCLIのプロフィールの自由な点検を実行して下さい。 キーを格納する方法にマッチするタブを使用します。

FLASHDATA_API_KEYを同一ターミナルの初期チェックから再利用します。

口座を読む JSON
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/identity' || exit
printf '\n'
)

アカウントとソースの確認

HTTPは、これらのフィールドを直接返します。 CLI JSONでは、data.identity.identityでそれらを見つけ、またdata.accessVerified: trueを要求します。

インフォメーション期待される
accountIdこのワークロードを所有するアカウント。
accessready
scopesgoogle_search は最初の検索に含まれています。
recurringAllowedtrue 予定の所有者の仕事の前に。

ソースの権限が機能する方法

キーは付与されたソースだけを利用できます。ソースの選択と料金は別です。同じアカウントのキーはすべて、購入済みクレジットを含む共有残高を使います。権限を制限したキーにも個別の支出上限はありません。将来の製品には明示的な権限付与が必要です。

鍵が露出している場合

  1. 該当するコンソールページですぐに露出したキーを再読み込みし、スケジュールされた発信者を停止します。
  2. 必要な権限で置換を作成し、各発信者の秘密ストアにインストールし、上記の無料検証を実行します。
  3. History と予期しないアクティビティのアカウント使用量を見直します。 ファイルを解凍しないで秘密を取消す。

キーを回転させる

  1. 必要なソースで置換を作成し、ターゲット環境にインストールします。
  2. 上記の無料検証を繰り返し、アプリケーションまたはスケジューラを切り替えます。 それぞれの意図した呼び出し者を更新します。
  3. 呼び出し元が切り替わった後、古いキーを呼び戻します。 ノートパソコンに更新された秘密は、デプロイされたサービスを更新しません。
CLIキー・ペーストを隠しプロンプトに置き換える
flashdata auth login --replace
flashdata auth status

アクセスを回復する

スケジュールされた発信者を停止し、マッチングキーまたは下の接続を再開し、古いクレデンシャルで無料の検証を繰り返します。 拒否する必要があります。 ローカルでログアウトすると、サーバーアクセスを再開しません。

アクセスタイプどこをリムークする
通常のAPIキーAPI Keys
クレームエージェントキーSettings → Connected apps → Agent connections
MCP OAuthの付与Settings → Connected apps