ドキュメントを探す
はじめに
アプリやエージェントのキーを作成します。 保管し、アクセスを確認し、ライフサイクルを管理します。
このページの内容
1. キーを作成する
- 確認済みのアカウントにサインインし、API Keysを開きます。 既に1つを持っている場合は、認証されたキーを再利用します。
- アプリと環境で名前を付け、expiry を選択し、必要なソースを選択します。 最初の検索例に Google Search を選択します。
- キーを作成し、以下に保存します。 独立したエージェントとプロダクションアプリを別々のキーで、個別にそれらを取り消すことができます。
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# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey隠しプロンプトでキーを貼り付けます。 名前付きプロファイルでは、--profile NAME をここに追加し、後でコマンドを実行します。 以前に設定されたプロファイルは、そのキーを置き換えるために、--replaceにログインする必要があります。
flashdata auth login3. アクセスの確認
同じターミナルかCLIのプロフィールの自由な点検を実行して下さい。 キーを格納する方法にマッチするタブを使用します。
FLASHDATA_API_KEYを同一ターミナルの初期チェックから再利用します。
(
: "${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'
)FLASHDATA_API_KEYを同一ターミナルの初期チェックから再利用します。
& {
$ErrorActionPreference = 'Stop'
if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
throw 'Set FLASHDATA_API_KEY first'
}
$flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
$flashdataBase = 'https://api.flashdata.dev/v2'
$flashdataUri = "$flashdataBase/api-access/identity"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}保存したCLIアクセスを使用します。 名前付きプロファイルの場合は、--profile NAME を各コマンドに追加します。 これらはクエリクレジットを消費しません。
flashdata auth statusアカウントとソースの確認
HTTPは、これらのフィールドを直接返します。 CLI JSONでは、data.identity.identityでそれらを見つけ、またdata.accessVerified: trueを要求します。
| インフォメーション | 期待される |
|---|---|
| accountId | このワークロードを所有するアカウント。 |
| access | ready |
| scopes | google_search は最初の検索に含まれています。 |
| recurringAllowed | true 予定の所有者の仕事の前に。 |
ソースの権限が機能する方法
キーは付与されたソースだけを利用できます。ソースの選択と料金は別です。同じアカウントのキーはすべて、購入済みクレジットを含む共有残高を使います。権限を制限したキーにも個別の支出上限はありません。将来の製品には明示的な権限付与が必要です。
鍵が露出している場合
- 該当するコンソールページですぐに露出したキーを再読み込みし、スケジュールされた発信者を停止します。
- 必要な権限で置換を作成し、各発信者の秘密ストアにインストールし、上記の無料検証を実行します。
- History と予期しないアクティビティのアカウント使用量を見直します。 ファイルを解凍しないで秘密を取消す。
キーを回転させる
- 必要なソースで置換を作成し、ターゲット環境にインストールします。
- 上記の無料検証を繰り返し、アプリケーションまたはスケジューラを切り替えます。 それぞれの意図した呼び出し者を更新します。
- 呼び出し元が切り替わった後、古いキーを呼び戻します。 ノートパソコンに更新された秘密は、デプロイされたサービスを更新しません。
flashdata auth login --replace
flashdata auth statusアクセスを回復する
スケジュールされた発信者を停止し、マッチングキーまたは下の接続を再開し、古いクレデンシャルで無料の検証を繰り返します。 拒否する必要があります。 ローカルでログアウトすると、サーバーアクセスを再開しません。
| アクセスタイプ | どこをリムークする |
|---|---|
| 通常のAPIキー | API Keys |
| クレームエージェントキー | Settings → Connected apps → Agent connections |
| MCP OAuthの付与 | Settings → Connected apps |