# Pilihan otentikasi agen agon

Berhubung dengan API Kunci atau kunci MCP OAuth, verifikasi akses tanpa pertanyaan yang terbayar, dan gunakan lagi untuk tugas-tugas selanjutnya.

Referensi boonical: https://flashdata.dev/ms/docs/guides/agent-access
Diulas: 2026-11-05 oleh FlashData

<a id="access"></a>

## 1. Pilih dan sambungkan

Sudah terhubung? Pergi langsung ke pemeriksaan bebas dalam langkah 2. Jika tidak, pilihlah akses aplikasi atau kebutuhan agenmu.

| Kau sedang menyambung | Guna | Siapa yang menyimpan buktinya? |
| --- | --- | --- |
| Sebuah aplikasi, SDK, CLI atau skrip terjadwal | Kunci API Pemilik Aus | Toko rahasia server anda atau profil CLI |
| Alat penelitian Codex atau OpenClaw | MCP OAuth | Host setelah persetujuan browser |
| Agen agen agen frenia mencoba FlashData tanpa akun | Kunci Sementara API | Agen itu menyelamatkan profil pengadilan, kemudian akses pemilik setelah mengklaim |

### Kunci API

Achieved Buat kunci dalam API Keys dengan sumber yang anda butuhkan, atau gunakan kembali kunci yang ada. Kirimkan ke SDK-mu atau kirim sebagai X-API-Key dari belakangmu. Pemeriksaan Bash dan PowerShell dalam langkah 2 bekerja langsung dengan API; tidak ada instalasi CLI yang diperlukan.

- [API Keys](https://flashdata.dev/app/api-keys)
- [Simpan kunci di CLI](https://flashdata.dev/ms/docs/guides/agent-access/reference.md#import-key)
- [SDK Dan HTTP Masukan kunci](https://flashdata.dev/ms/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP OAuth

Use a host dikonfigurasi untuk FlashData OAuth. Pemilik akun telah menyelesaikan pendaftaran atau pendaftaran dan persetujuan dalam browser; pembawa acara menyimpan token. Koneksi ini tidak memasang kunci CLI atau mengklaim pengadilan.

#### Sambungan MCP ber Hosles

```text
URL: https://data.flashdata.dev/mcp
Transport: Streamable HTTP
Authentication: OAuth
Scope: mcp:research
```

- [Gnect Codex](https://flashdata.dev/ms/docs/integrations/codex/reference.md#setup)
- [Gnect OpenClaw](https://flashdata.dev/ms/docs/integrations/openclaw/reference.md#setup)
- [Klien MCP Lainnya](https://flashdata.dev/ms/docs/integrations/mcp-clients/reference.md#connect)

### Pengadilan Agen Agen Keislaman

Untuk agen tanpa kunci, discover, kemungkinan percobaan saat ini sebelum mendaftar. Dia menggunakan kembali percobaan dan profilnya. PULAU YouTube Download dan tugas yang berulang memerlukan akses pemilik.

#### Discogne tanpa mendaftar

```bash
flashdata discover --profile research --json
```

- [\"Mulailah pengadilan dan klaim\"](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md)
- [Protokol pengesahan agen AEGE](https://flashdata.dev/auth.md)


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

### Sumber mana yang dapat digunakan secara kredensial ini?

Use X-API-Key untuk permintaan HTTP normal dan API-key MCP koneksi. token pembawa OAuth hanya bekerja di titik akhir MCP yang dihos. YouTube Download kebutuhan kebutuhan seorang pemilik API Kunci dengan youtube_download Tempat penyimpanan dan destinasi.

| Bukti Bukti Bukti Kelayakan | Sumber yang ada |
| --- | --- |
| Kunci API Pemilik Aus | Sumber-sumber diberikan ke kunci, termasuk youtube_download ketika disetujui. |
| Kunci Sementara API | Dia hanya diberikan sumber-sumber yang memenuhi syarat. Skop baca dari tanggapan identitas saat ini. |
| MCP OAuth | google_search, youtube_search, youtube_metadata, youtube_transcript |


<a id="import-key"></a>

### Simpan kunci di CLI

Skip skip impor jika CLI sudah memiliki akses atau persediaan manajer rahasia Anda FLASHDATA_API_KEY. Jika tidak, pilihlah metode di bawah ini dan simpanlah profil penelitian yang sama untuk perintah di kemudian hari. Kunci CLI tersimpan tidak tersedia secara otomatis untuk SDK atau server MCP lokal.

#### Terminal berinteraktif

Tempelkan kunci di terminal tersembunyi.

##### Pernah mengimpor sekali

```bash
flashdata auth login --profile research
```


#### Otomasi · Bash

FLASHDATA_KEY_FILE Set ke jalan dari file kunci terlindungi yang sudah ada. Perintah tersebut membacanya melalui stdin; menjaga kunci dari chat dan argumen perintah.

##### ¡Membaca rahasia yang dilindungi melalui stdin

```bash
: "${FLASHDATA_KEY_FILE:?Set the path to your protected API-key file}"
flashdata auth login --profile research --api-key-stdin --non-interactive \
  < "$FLASHDATA_KEY_FILE"
```


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

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

## 2. Simak sambungannya

Anda harus menjalankan cek gratis di lingkungan yang akan melakukan tugas. CLI Dan HTTP Periksa menggunakan sebuah API Kuncinya; MCP Pemeriksaan wanji menggunakan sambungan yang disimpan oleh host sendiri.

### Bash / cURL

Kemudia membutuhkan Bash dan cURL 7.76+. Skip key propt tersembunyi jika lingkungan Anda sudah memasok FLASHDATA_API_KEY. Jalankan perintah baca di terminal yang sama.

#### Tetapkan kata kunci · skip jika sudah dikonfigurasi

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

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

Skip key prompt tersembunyi jika FLASHDATA_API_KEY sudah ditetapkan. Jalankan perintah baca di terminal yang sama.

#### Tetapkan kata kunci · skip jika sudah dikonfigurasi

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

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

Guna pengguna OS, profil dan direktori keadaan dari log masuk. Gantikan riset jika menggunakan profil lain; tambahkan --state-dir PATH jika diperlukan. FLASHDATA_API_KEY membatalkan kunci yang disimpan. Expect ok: true dan data.accessVerified: true; kemudian menginspeksi medan identitas di bawah.

#### Akun gratis dibaca

```bash
flashdata auth status --profile research --json --non-interactive
```

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

### MCP

Kirim ini ke sesi baru agenmu yang terhubung. Gantikan google_search dengan sumber yang dibutuhkan tugas anda. Exporex mengharapkan kedua panggilan alat untuk berhasil; memeriksa pricing dan saldo secara terpisah sebelum pekerjaan dibayar. Pengguna server yang terdaftar sendiri tidak memverifikasi akses.

#### Semak sambungan

```text
Guna koneksi flashdata MCP yang sudah ada.
Panggil get_pricing dengan {"source":"google_search","request_count":1}.
Panggil get_balance dengan {}.
Laporan apakah kedua panggilan berhasil, apakah sumber memiliki harga yang tersedia,
Dan saldo kredit yang tersedia. Keseimbangan nol bukanlah kegagalan autentikasi.
Jangan jalankan pencarian atau download, buat sidang, atau ubah kredensial.
```



<a id="identity-result"></a>

### Baca identitas kunci API

Bidang identitas HTTP berada di tingkat teratas. CLI JSON, baca data.identity.identity dan membutuhkan data.accessVerified: true. HTTP 200 OR atau ORANG CLI ok: true Hanya saja tidak cukup.

| Periksa | Hasil yang dibutuhkan |
| --- | --- |
| Akun yang Diintended | accountId dan apiKeyId mengidentifikasi akun dan kunci yang ingin anda gunakan. |
| Akses yang dapat digunakan | access: ready |
| Diizinkan oleh: | Skop Skop mengandung sumber, seperti google_search. CLI juga mencantumkan sumber yang diizinkan dalam data.identity.permittedSources. |
| Tugas yang berulang | accountType: owned · installed: true · recurringAllowed: true |

- [Otomosi pemeriksaan ini sebelum penjadwalan](https://flashdata.dev/ms/docs/guides/agent-access/reference.md#recurring-check)

<a id="trial-result"></a>

### Uji coba aktif adalah koneksi yang valid

Uji coba A dapat melewati pemeriksaan satu-off tugas sementara recurringAllowed adalah false. CONCANA membaca lingkup dan ekspira yang sebenarnya; klaim pengadilan yang ada sebelum pekerjaan penjadwalan.

#### Identitas sementara · lapangan ilustrasi

```json
{
  "accountType": "temporary",
  "access": "ready",
  "installed": false,
  "recurringAllowed": false,
  "scopes": [
    "google_search"
  ]
}
```


<a id="codex"></a>

### Cari koneksi dalam Codex

Senaraikan server yang dikonfigurasi, kemudian gunakan /mcp dalam sesi Codex segar. Jalankan pemeriksaan MCP di atas untuk memverifikasi kelayakan.

#### Daftar server

```bash
codex mcp list
```

- [XOCodex setup dan tugas pertama](https://flashdata.dev/ms/docs/integrations/codex/reference.md)

<a id="openclaw"></a>

### Periksa koneksi dalam OpenClaw

Iaquina Probe server tersimpan, kemudian jalankan pemeriksaan MCP di atas dalam percakapan aktif Anda.

#### AKAN server

```bash
openclaw mcp doctor flashdata --probe
```

- [XOOpenClaw setup dan tugas pertama](https://flashdata.dev/ms/docs/integrations/openclaw/reference.md)

<a id="refresh"></a>

## 3. Memulihkan kembali akses untuk tugas-tugas selanjutnya

Tetap simpan secara kredensial dan persisten sepanjang proses start ulang. Periksa kembali akses dalam proses baru sebelum mengaktifkan penjadwalan Anda.

| Bukti Bukti Bukti Kelayakan | Untuk tugas berikutnya |
| --- | --- |
| Kunci API Pemilik Aus | Gunakan kembali kunci yang disimpan. Ini tidak memiliki langkah penyegaran OAuth; menggantinya jika sudah habis atau dicabut. |
| MCP OAuth | Most me-refresh satu jam OAuth token akses menggunakan refresh token berputar. Putuskan kembali ketika hibah 90-hari berakhir atau dicabut. Setiap instalasi memiliki toko tokennya; jangan berbagi berkas-berkas yang disegarkan di antara host. |
| Kunci Sementara API | Penghapusan owner yang mengaku dan pengalihan kredensial sebelum pekerjaan berulang. Anda menggunakan kembali profil asli; jangan mendaftar lagi untuk setiap lari. |

- [Aliran kerja tugas yang berulang](https://flashdata.dev/ms/docs/guides/recurring-tasks/reference.md)

<a id="recurring-check"></a>

### Periksa tugas CLI sebelum penjadwalan

Kemudia membutuhkan Bash dan jq. Kami sudah menetapkan sumber tugas. script menggunakan penelitian secara default; set FLASHDATA_PROFILE dan FLASHDATA_STATE_DIR untuk profil atau direktori negara yang berbeda. Exit 0 dengan identitas JSON berarti kunci pemilik sudah siap, terpasang dan diizinkan untuk sumber ini. Apakah jadwal Anda berhenti di jalan keluar lain. Tidak ada pertanyaan yang diajukan.

#### Pemeriksaan akses fresh-proses · Bash

```bash
(
set -euo pipefail
SOURCE=google_search
args=(--profile "${FLASHDATA_PROFILE:-research}" --json --non-interactive)
if [[ -n "${FLASHDATA_STATE_DIR:-}" ]]; then
  args+=(--state-dir "$FLASHDATA_STATE_DIR")
fi

flashdata auth status "${args[@]}" |
  jq -e --arg source "$SOURCE" '
    select(.ok == true and .data.accessVerified == true)
    | .data.identity as $auth
    | $auth.identity
    | select(.accountType == "owned" and .access == "ready"
        and .installed == true and .recurringAllowed == true
        and ((.scopes // []) | index($source) != null)
        and (($auth.permittedSources // []) | index($source) != null))
    | {accountId, apiKeyId, scopes, recurringAllowed, expiresAt}'
)
```

- [Percepatan, keseimbangan, dan pelari yang berulang](https://flashdata.dev/ms/docs/guides/recurring-tasks/reference.md#prepare)

<a id="claim"></a>

### Jika akses masih pengadilan

Melengkapi persidangan dan mengklaim panduan dengan profil asli. Setelah persetujuan pemilik dan pemberian kredensial, cek gratis harus menunjukkan akses yang dimiliki dan recurringAllowed: true. Permintaan yang diteruskan menggunakan saldo bersama pemilik; kredit pengadilan yang tidak digunakan tidak dipindahkan. Log masuk MCP OAuth adalah sambungan terpisah dan tidak mengklaim pengadilan ini.

- [Keadiladilan dan klaim perintah](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md)
- [auth.md](https://flashdata.dev/auth.md)

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

## Akses Relorge

Pekerjaan yang berulang pertama kali berulang kali tidak berulang. Membatalkan kredensial yang cocok di bawah ini, kemudian ulangi cek bebas dari proses atau sesi baru sebelum membersihkan akses lokal. Kegagalan pengesahan yang diharapkan oleh purgen atau permintaan sambung kembali; tidak menyetujui sambungan baru selama pemeriksaan. Logkeluar lokal logkeluar sendiri tidak mencabut akses server.

| Sambungan | Di mana harus membatalkan |
| --- | --- |
| MCP OAuth | Settings → Connected apps → hibah aplikasi. |
| Kunci agen API yang diklaim oleh THE | Settings → Connected apps → Hubungan Agen. |
| Akun API Kuncinya adalah | API Keys → kunci yang digunakan oleh integrasi ini. |

- [Connected apps](https://flashdata.dev/app/settings/connections)
- [API Keys](https://flashdata.dev/app/api-keys)
- [Kesalahan akses questifestjoirshooting](https://flashdata.dev/ms/docs/guides/troubleshooting/reference.md#credentials)

<a id="fixes"></a>

## Fix sebuah pemeriksaan gagal

| Hasil | Aksi |
| --- | --- |
| accessVerified: false | Fasa baca dan nextCommand. Profil yang tertunda dapat mengembalikan ok: true sebelum kunci dapat digunakan. Finish pendaftaran atau klaim yang disimpan; mempertahankan profil yang sama. |
| access: blocked | Stop bahkan jika respon HTTP adalah 200. Tinjau kembali akun atau koneksi dalam konsol; jangan anggap tanggapan identitas sebagai izin untuk bertanya. |
| accountType: temporary | Gunakan pengadilan yang memenuhi syarat untuk satu pekerjaan. Klaim klaimnya sebelum penjadwalan; koneksi OAuth baru tidak mengklaim profil ini. |
| installed: false | Setelah persetujuan pemilik, jalankan flashdata auth finish --wait dengan profil dan direktori negara asli. Kalau begitu ulangi ceknya. |
| 401 / invalid_grant | Putuskan kembali kredensial yang telah luput atau dicabut dalam tuan rumah aslinya. Jangan memulai percobaan lain untuk melewatinya. |
| 403 / source_forbidden | Periksa skop kunci atau daftar sumber OAuth. YouTube Download menggunakan kunci API pemilik. |
| Akses sah, keseimbangan nol | Autentifikasi AVE bekerja. Periksa Billing sebelum pekerjaan berbayar; jangan ganti kunci yang sah. |

- [Billing](https://flashdata.dev/app/billing)
- [Pulihkan kembali sambungan terganggu](https://flashdata.dev/ms/docs/guides/agent-recovery/reference.md)
