# Opsi otentikasi agen

Hubungkan dengan API kunci atau MCP OAuth, verifikasi akses tanpa kuiri dibayar, dan gunakan lagi untuk tugas kemudian.

Referensi kanonikal: https://flashdata.dev/id/docs/guides/agent-access
Diulang: 2026-11-05 oleh FlashData

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

## 1. Pilih dan hubungkan

Sudah terhubung? Pergi langsung ke cek gratis di langkah 2. Jika tidak, pilih akses yang dibutuhkan atau agen anda.

| Anda sedang menyambung | Gunakan | Siapa yang menjaga kredensial? |
| --- | --- | --- |
| Aplikasi, SDK, CLI atau skrip yang dijadwalkan | Kunci pemilik API | Penyimpanan rahasia server Anda atau profil CLI |
| Codex atau OpenClaw alat penelitian | MCP OAuth | Host setelah persetujuan peramban |
| Seorang agen mencoba FlashData tanpa akun | Kunci sementara API | Agen apos; s profil pengadilan disimpan, kemudian pemilik akses setelah mengklaim |

### kunci API

Buat kunci dalam API Keys dengan sumber yang diperlukan tugas Anda, atau gunakan kembali kunci yang telah ada. Pasokan ke SDK Anda atau kirim sebagai X-API-Key dari backend Anda. Bash dan PowerShell cek 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/id/docs/guides/agent-access/reference.md#import-key)
- [SDK dan pengaturan kunci HTTP](https://flashdata.dev/id/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP OAuth

Gunakan host yang dikonfigurasi untuk FlashData OAuth. Pemilik akun melengkapi pendaftaran atau tandatangan dan persetujuan dalam peramban; host menyimpan token. Koneksi ini tidak menginstal kunci CLI atau mengklaim percobaan.

#### Sambungan host MCP

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

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

### Agen Trial

Untuk seorang agen tanpa kunci, discover percobaan saat ini eligibilitas sebelum mendaftar. Gunakan ulang percobaan yang ada dan profilnya. YouTube Download dan tugas yang berulang memerlukan akses pemilik.

#### Temukan tanpa mendaftar

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

- [Mulai sidang dan klaim itu](https://flashdata.dev/id/docs/guides/agent-onboarding/reference.md)
- [Protokol otentikasi Agen](https://flashdata.dev/auth.md)


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

### Sumber mana yang bisa digunakan kredensial ini?

Gunakan X-API-Key untuk permintaan HTTP normal dan sambungan APIQ-kunci MCP normal. OAuth pembawa token hanya bekerja di titik akhir MCP yang diselenggarakan. YouTube Download membutuhkan pemilik kunci API dengan youtube_download dan penyimpanan tujuan.

| Kredensial | Sumber tersedia |
| --- | --- |
| Kunci pemilik API | Sumber diberikan ke kunci, termasuk youtube_download ketika disetujui. |
| Kunci sementara API | Hanya diberikan trial - sumber yang memenuhi syarat. Baca scopes dari respon identitas saat ini. |
| MCP OAuth | google_search, youtube_search, youtube_metadata, youtube_transcript |


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

### Simpan kunci di CLI

Abaikan impor jika CLI sudah memiliki akses atau persediaan manajer rahasia Anda FLASHDATA_API_KEY. Jika tidak, pilih metode di bawah ini dan tetap sama profil penelitian untuk perintah kemudian. Kunci CLI yang disimpan tidak secara otomatis tersedia untuk SDK atau server lokal MCP.

#### Terminal interaktif

Tempelkan kunci pada prompt terminal tersembunyi.

##### Impor sekali

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


#### Automatisasi Bash

Set FLASHDATA_KEY_FILE ke lokasi dari berkas kunci yang telah ada. Perintah membacanya melalui stdin; menjaga kunci keluar dari percakapan dan argumen perintah.

##### Baca 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"
```


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

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

## 2. Verifikasi sambungan

Jalankan pemeriksaan gratis di lingkungan yang akan melakukan tugas. CLI dan HTTP cek menggunakan kunci API; cek MCP menggunakan sambungan sendiri yang disimpan oleh host.

### Bash / cURL

Membutuhkan Bash dan cURL 7.76 +. Lewati prompt kunci tersembunyi jika lingkungan anda sudah menyediakan FLASHDATA_API_KEY. Jalankan perintah baca di terminal yang sama.

#### Atur kunci bila 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
```

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

Lewati prompt kunci tersembunyi jika FLASHDATA_API_KEY telah diset. Jalankan perintah baca di terminal yang sama.

#### Atur kunci bila 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
```

#### Baca akun 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 pengguna OS, profil, dan status direktori dari login. Gantikan penelitian jika Anda menggunakan profil lain; tambahkan --state-dir PATH jika diperlukan. FLASHDATA_API_KEY menimpa kunci yang disimpan. Mengharapkan ok: true dan data.accessVerified: true, kemudian memeriksa bidang identitas di bawah ini.

#### Rekening bebas dibaca

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

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

### MCP

Kirim ini ke sesi baru dari agen anda yang terhubung. Ganti google_search dengan sumber kebutuhan tugas Anda. Berharap kedua alat tersebut sukses; periksa harga dan keseimbangan secara terpisah sebelum dibayar. Sebuah server terdaftar saja tidak memverifikasi akses.

#### Pemeriksaan koneksi

```text
Gunakan flashdata yang ada koneksi MCP.
Call get_pricing dengan {"source":"google_search","request_count":1}.
Call get_balance dengan {}.
Laporkan apakah kedua panggilan berhasil, apakah sumber memiliki harga yang tersedia,
dan saldo kredit yang tersedia. Sebuah keseimbangan nol bukan sebuah kegagalan otentikasi.
Jangan jalankan pencarian atau unduh, buat uji coba, atau ubah kredensial.
```



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

### Baca API-key identitas

HTTP bidang identitas berada di tingkat atas. Dalam CLI JSON, dibaca data.identity.identity dan membutuhkan data.accessVerified: true. HTTP 200 atau CLI ok: true sendirian tidak cukup.

| Periksa | Hasil yang diperlukan |
| --- | --- |
| Akun yang ditambahkan | accountId dan apiKeyId mengidentifikasi akun dan kunci yang Anda maksud untuk digunakan. |
| Akses yang dapat digunakan | access: ready |
| Izin tugas | scopes berisi sumber, seperti google_search. CLI juga daftar sumber yang diijinkan dalam data.identity.permittedSources. |
| Mengulang tugas | accountType: owned · installed: true · recurringAllowed: true |

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

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

### Persidangan aktif adalah koneksi yang valid

Sebuah percobaan dapat melewati satu-off-tugas cek sementara recurringAllowed adalah false. Baca pandangan sebenarnya dan kadaluarsa; klaim percobaan yang ada sebelum penjadwalan bekerja.

#### Identitas sementara

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


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

### Temukan koneksi dalam Codex

Daftar server yang dikonfigurasi, lalu gunakan /mcp dalam sesi Codex yang baru. Jalankan MCP cek di atas untuk memverifikasi kredensial.

#### Daftar server

```bash
codex mcp list
```

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

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

### Periksa sambungan dalam OpenClaw

Probe server disimpan, kemudian jalankan MCP cek di atas dalam percakapan aktif Anda.

#### Probe server

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

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

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

## 3. Gunakan kembali akses untuk tugas selanjutnya

Menjaga swasta credential toko dan gigih di seluruh proses memulai kembali. Periksa ulang akses dalam proses baru sebelum mengaktifkan penjadwal Anda.

| Kredensial | Untuk tugas berikutnya |
| --- | --- |
| Kunci pemilik API | Gunakan kembali kunci yang disimpan. Tidak ada OAuth langkah refresh; menggantinya jika kadaluarsa atau dicabut. |
| MCP OAuth | Host menyegarkan satu-jam token akses OAuth menggunakan token refresh berputar. Rekonnect ketika 90-day hibah berakhir atau dicabut. Setiap instalasi memiliki toko token nya; jangan berbagi segar-token berkas antara host. |
| Kunci sementara API | Selesai pemilik mengklaim dan dokumen handoff sebelum recurring bekerja. Gunakan kembali profil asli; jangan mendaftar lagi untuk setiap dijalankan. |

- [Mengulang alur kerja tugas](https://flashdata.dev/id/docs/guides/recurring-tasks/reference.md)

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

### Periksa tugas CLI sebelum penjadwalan

Membutuhkan Bash dan jq. Atur SOURCE ke sumber tugas. Skrip menggunakan riset secara baku; set FLASHDATA_PROFILE dan FLASHDATA_STATE_DIR untuk profil atau direktori negara yang berbeda. Keluar 0 dengan identitas JSON berarti kunci pemilik siap, terpasang dan diijinkan untuk sumber ini. Apakah penjadwalan Anda berhenti pada setiap pintu keluar lain. Tak ada permintaan yang diajukan.

#### Pemeriksaan akses proses baru 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}'
)
```

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

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

### Jika akses masih percobaan

Lengkap sidang dan mengklaim panduan dengan profil asli. Setelah pemilik persetujuan dan surat perlindungan, cek gratis harus menunjukkan akses yang dimiliki dan recurringAllowed: true. Permintaan terus-menerus menggunakan keseimbangan berbagi pemilik; kredit pengadilan tidak digunakan tidak transfer. MCP OAuth adalah sambungan terpisah dan tidak mengklaim sidang ini.

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

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

## Menghilangkan akses

Jeda tugas yang berulang dulu. Mengembalikan kredensial yang cocok di bawah ini, kemudian ulangi cek gratis dari proses yang segar atau sesi sebelum membersihkan akses lokal. Mengharapkan kegagalan otentikasi atau permintaan reconnect; jangan menyetujui koneksi baru selama pemeriksaan. Logout lokal saja tidak mencabut akses server.

| Koneksi | Dimana untuk mencabut |
| --- | --- |
| MCP OAuth | SettingsQ Connected apps Hibah aplikasi. |
| Agen yang diklaim kunci API | SettingsQ Connected apps Agen koneksi. |
| Kunci Akun API | API KeysQ kunci yang digunakan oleh integrasi ini. |

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

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

## Perbaiki pengecekan gagal

| Hasil | Aksi |
| --- | --- |
| accessVerified: false | Baca fase dan nextCommand. Profil yang tertunda dapat kembali ok: true sebelum kunci dapat digunakan. Selesaikan pendaftaran yang disimpan atau klaim; pertahankan profil yang sama. |
| access: blocked | Hentikan bahkan jika respon HTTP adalah 200. Tinjau akun atau koneksi dalam konsol; jangan perlakukan respon identitas sebagai hak untuk query. |
| accountType: temporary | Gunakan pengadilan yang memenuhi syarat untuk satu pekerjaan. Klaim sebelum penjadwalan; koneksi OAuth baru tidak mengklaim profil ini. |
| installed: false | Setelah persetujuan pemilik, jalankan data kilas auth finish --wait dengan profil asli dan direktori keadaan. Kemudian ulangi cek. |
| 401 / invalid_grant | Rekonnect yang kadaluwarsa atau dicabut kredensial di tuan rumah aslinya. Jangan memulai percobaan lain untuk melewatinya. |
| 403 / source_forbidden | Periksa data kunci atau daftar sumber OAuth. YouTube Download menggunakan pemilik API kunci. |
| Akses yang valid, keseimbangan nol | Otentikasi berhasil. Periksa Billing sebelum pekerjaan yang dibayar; jangan ganti kunci yang valid. |

- [Billing](https://flashdata.dev/app/billing)
- [Mengembalikan sambungan yang terputus](https://flashdata.dev/id/docs/guides/agent-recovery/reference.md)
