# API キーの管理

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

キャニシニカル参照: https://flashdata.dev/ja/docs/guides/api-keys-and-permissions
レビュー: FlashData による 2026-11-04

<a id="create"></a>

## 1. キーを作成する

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

- [API Keys を開く](https://flashdata.dev/app/api-keys)
- [サインアップ前に試してみてください](https://flashdata.dev/ja/docs/guides/agent-onboarding/reference.md)

<a id="store"></a>

## 2. キーを貯えて下さい

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

### Bash · API / SDK

#### この端末のキーを設定する

```bash
# 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 · API / SDK

#### この端末のキーを設定する

```powershell
# 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
```


### CLI

隠しプロンプトでキーを貼り付けます。 名前付きプロファイルでは、--profile NAME をここに追加し、後でコマンドを実行します。 以前に設定されたプロファイルは、そのキーを置き換えるために、--replaceにログインする必要があります。

#### 鍵を保存

```bash
flashdata auth login
```

- [CLIインストール](https://flashdata.dev/ja/docs/guides/flashdata-cli/reference.md#install)


<a id="verify"></a>

## 3. アクセスの確認

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

### Bash / cURL

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

#### 口座を読む JSON

```bash
(
: "${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'
)
```


### PowerShell 7

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

#### 口座を読む JSON

```powershell
& {
  $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

保存したCLIアクセスを使用します。 名前付きプロファイルの場合は、--profile NAME を各コマンドに追加します。 これらはクエリクレジットを消費しません。

#### 無料アカウントの読み込み

```bash
flashdata auth status
```

- [キーを設定する](https://flashdata.dev/ja/docs/guides/api-keys-and-permissions/reference.md#store)


<a id="verified"></a>

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

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

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

- [最初のクエリを実行する](https://flashdata.dev/ja/docs/guides/http-quickstart/reference.md)
- [バランスと価格をチェック](https://flashdata.dev/ja/docs/guides/credits-and-billing/reference.md)

<a id="permissions"></a>

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

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

- [エージェント許可カタログ](https://flashdata.dev/ja/docs/guides/agent-onboarding/reference.md#permissions)

<a id="leak"></a>

## 鍵が露出している場合

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

- [API Keysの特長](https://flashdata.dev/app/api-keys)
- [口座利用状況](https://flashdata.dev/ja/docs/guides/usage-and-limits/reference.md#usage)

<a id="rotate"></a>

## キーを回転させる

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

### CLIキー・ペーストを隠しプロンプトに置き換える

```bash
flashdata auth login --replace
flashdata auth status
```


<a id="revoke"></a>

## アクセスを回復する

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

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

- [API Keysの特長](https://flashdata.dev/app/api-keys)
- [Connected appsの特長](https://flashdata.dev/app/settings/connections)
- [認証のトラブルシューティング](https://flashdata.dev/ja/docs/guides/headers-and-authentication/reference.md#errors)
