# Pengurusan kunci API

Buat kunci untuk aplikasi atau agenmu. Toko itu, cek akses dan mengatur daur hidupnya.

Referensi boonical: https://flashdata.dev/ms/docs/guides/api-keys-and-permissions
Diulas: 2026-11-04 oleh FlashData

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

## 1. Cipta kunci

1. Tanda tangan ke rekeningmu dan buka API Keys. Anda telah memiliki kunci yang sah jika Anda sudah punya.
2. Nama itu untuk aplikasi dan lingkungan, memilih sebuah ekspiriat dan memilih sumber yang dibutuhkan. Pilih Google Search untuk contoh pencarian pertama.
3. Buat kuncinya dan simpan di bawah. Berikan agen independen dan aplikasi produksi kunci terpisah sehingga Anda dapat mencabutnya secara individu.

- [Buka API Keys](https://flashdata.dev/app/api-keys)
- [Cobalah sebelum mendaftar](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md)

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

## 2. Kedai kunci

Pilih cara Anda akan menjalankan FlashData. Contoh API dan SDK contoh baca FLASHDATA_API_KEY; CLI dapat menyimpan kunci dalam profil terlindunginya. Dalam produksi, inject kelayakan dari toko rahasia Anda.

### Bash · API / SDK

#### Ketikkan kunci terminal ini

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

#### Ketikkan kunci terminal ini

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

Tempelkan kunci pada prompt tersembunyi. Untuk profil bernama, tambahkan --profile NAME di sini dan di kemudian perintah. Sebuah profil yang telah dikonfigurasi sebelumnya membutuhkan login --replace untuk menggantikan kuncinya.

#### Simpan kuncinya

```bash
flashdata auth login
```

- [Pemasangan CLI](https://flashdata.dev/ms/docs/guides/flashdata-cli/reference.md#install)


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

## 3. Akses tentusah

Anda harus menjalankan cek gratis di terminal yang sama atau CLI profile. Gunakan tab yang cocok dengan bagaimana Anda menyimpan kunci.

### Bash / cURL

Gunakan ulang FLASHDATA_API_KEY dari pemeriksaan sebelumnya di terminal yang sama.

#### akun baca 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

Gunakan ulang FLASHDATA_API_KEY dari pemeriksaan sebelumnya di terminal yang sama.

#### akun baca 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

Gunakan CLI yang disimpan. Untuk profil bernama, tambahkan --profile NAMA ke setiap perintah. Bacaan ini tidak menghabiskan kredit pertanyaan.

#### Akun gratis dibaca

```bash
flashdata auth status
```

- [Sediakan kunci](https://flashdata.dev/ms/docs/guides/api-keys-and-permissions/reference.md#store)


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

### Konfirmasikan akun dan sumber

HTTP mengembalikan bidang ini secara langsung. Dengan CLI JSON, temukan mereka di bawah data.identity.identity dan juga membutuhkan data.accessVerified: true.

| Periksa | Diharapkan |
| --- | --- |
| accountId | Akun yang memiliki beban kerja ini. |
| access | ready |
| scopes | Transklusi google_search untuk pencarian pertama. |
| recurringAllowed | ¡true sebelum pekerjaan pemilik terjadwal. |

- [Jalankan pertanyaan pertama Anda](https://flashdata.dev/ms/docs/guides/http-quickstart/reference.md)
- [Periksa keseimbangan dan harga](https://flashdata.dev/ms/docs/guides/credits-and-billing/reference.md)

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

### Bagaimana hak-hak sumber bekerja

Kunci A hanya dapat menggunakan sumber yang diberikan. Seleksi Produk Produk product dipisah dari harga: setiap kunci pada rekening yang dikeluarkan dari saldo bersama, termasuk kredit yang dibeli. Kunci terbatas tidak memiliki topi pengeluaran sendiri. Produk masa depan membutuhkan hibah izin eksplisit.

- [Katalog izin agen](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md#permissions)

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

## Jika kunci terkena

1. Beritahu kembali kunci yang terekspos segera dalam halaman konsol yang cocok di bawah ini, dan hentikan penelepon terjadwalnya.
2. \") Menciptakan pengganti dengan izin yang dibutuhkan, memasangnya di setiap toko rahasia penelepon, dan menjalankan verifikasi bebas di atas.
3. Tinjau History dan penggunaan akun untuk aktivitas yang tidak terduga. Membuang rahasia dari berkas tidak mencabutnya.

- [API Keys](https://flashdata.dev/app/api-keys)
- [Penggunaan akun](https://flashdata.dev/ms/docs/guides/usage-and-limits/reference.md#usage)

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

## Memputar sebuah kunci

1. Afeksi membuat pengganti dengan sumber yang diperlukan dan memasangnya di lingkungan target.
2. XOW mengulangi verifikasi bebas di atas, kemudian beralih aplikasi atau penjadwal. Memutakhirkan setiap penelepon yang ditujukan.
3. Membatalkan kunci lama setelah penelepon telah beralih. Sebuah rahasia yang diperbarui di laptop Anda tidak memperbarui layanan dikerahkan.

### Menggantikan sebuah kunci CLI · tempel ke dalam prompt tersembunyi

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


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

## Akses Relorge

Pemanggil terjadwal berjadwal bertanggal, mencabut kunci atau koneksi yang cocok di bawah, kemudian mengulangi verifikasi bebas dengan kredensial lama. Ini harus ditolak. Mengelog secara lokal tidak mencabut akses server.

| Tipe akses access type | Di mana harus membatalkan |
| --- | --- |
| Kunci API oridinary | API Keys |
| Kunci agen yang diklaim oleh Tuntutan Klaim | Settings → Connected apps → Agent connections |
| hibah MCP OAuth | Settings → Connected apps |

- [API Keys](https://flashdata.dev/app/api-keys)
- [Connected apps](https://flashdata.dev/app/settings/connections)
- [Pencarian masalah Pencarian Kerja Pencarian](https://flashdata.dev/ms/docs/guides/headers-and-authentication/reference.md#errors)
