# ตัวเลือกการยืนยันตัวตนของเอเจนต์

เชื่อมต่อกับ API กุญแจหรือ MCP OAuthเพื่อตรวจสอบการเข้าถึงโดยไม่มีการสอบถามที่จ่ายเงินแล้ว และทําอีกครั้งสําหรับงานภายหลัง

อ้างอิงทางคลอง: https://flashdata.dev/th/docs/guides/agent-access
Recorder: 2026-11-05 โดย FlashData

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

## 1. เลือกและเชื่อมต่อ

เชื่อมต่อแล้ว? ตรงไปที่เช็คฟรีในสเต็ป 2 มิ ฉะนั้น ก็ เลือก วิธี ที่ คุณ หรือ ตัว แทน ต้องการ.

| คุณกําลังเชื่อมต่อ | ใช้ | ใครรักษาความเชื่อถือ? |
| --- | --- | --- |
| แอพ SDK, CLI หรือสคริปต์ที่มีกําหนด | เจ้าของ API กุญแจ | ร้านลับของเซิร์ฟเวอร์ของคุณ หรือ CLI โพรไฟล์สี |
| Codex หรือ OpenClaw เครื่องมือวิจัยName | MCP OAuth | โฮสต์หลังการอนุญาตของเบราว์เซอร์ |
| ตัวแทนพยายาม FlashData โดยไม่มีบัญชีผู้ใช้ | ชั่วคราว API กุญแจ | เจ้าหน้าที่ได้บันทึกประวัติการทดลองไว้ หลังจากนั้นเจ้าของก็อ้างว่า |

### API กุญแจ

สร้างกุญแจใน API Keys โดยมีแหล่งข้อมูลที่คุณต้องการ หรือใช้กุญแจที่มีอยู่อีกครั้ง ส่งมันให้กับ SDK หรือส่งมัน X-API-Key จากแบ็คเอนต์ของคุณ เดอะ Bash ถึง PowerShell ตรวจสอบในขั้นตอน 2 ทํางานกับ APIไม่ CLI ต้องการการติดตั้ง

- [API Keys](https://flashdata.dev/app/api-keys)
- [บันทึกกุญแจใน CLI](https://flashdata.dev/th/docs/guides/agent-access/reference.md#import-key)
- [SDK ถึง HTTP ตั้งค่ากุญแจ](https://flashdata.dev/th/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP OAuth

ใช้โฮสต์ที่ตั้งค่า FlashData OAuth แล้ว เจ้าของบัญชีลงทะเบียนหรือเข้าสู่ระบบและอนุมัติสิทธิ์ในเบราว์เซอร์ จากนั้นโฮสต์จะบันทึกโทเค็น การเชื่อมต่อนี้ไม่ได้ติดตั้งคีย์ CLI หรือผูกสิทธิ์ทดลองใช้กับบัญชี

#### โฮสต์ MCP การเชื่อมต่อ

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

- [เชื่อมต่อ Codex](https://flashdata.dev/th/docs/integrations/codex/reference.md#setup)
- [เชื่อมต่อ OpenClaw](https://flashdata.dev/th/docs/integrations/openclaw/reference.md#setup)
- [อื่นๆ MCP ลูกข่าย](https://flashdata.dev/th/docs/integrations/mcp-clients/reference.md#connect)

### การทดลองของเจ้าหน้าที่

สําหรับตัวแทนที่ไม่มีกุญแจ discover การทดลองปัจจุบันที่เข้ากันได้ก่อนที่จะทําการลงทะเบียน ใช้การทดลองและประวัติของมันอีกครั้ง YouTube Download และทํางานซ้ํากัน ต้องการสิทธิ์เป็นเจ้าของ

#### การ ค้น พบ โดย ไม่ ได้ จด ทะเบียน

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

- [เริ่มทดลองและเรียกร้องมัน](https://flashdata.dev/th/docs/guides/agent-onboarding/reference.md)
- [โพรโทคอลสําหรับการตรวจสอบสิทธิ์ของเจ้าหน้าที่](https://flashdata.dev/auth.md)


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

### แหล่ง ไหน ที่ เชื่อ ถือ ได้ เช่น นี้?

ใช้ X-API-Key เพื่อความปกติ HTTP ร้องขอและ API-โอเค MCP การเชื่อมต่อ OAuth ผู้ถือป้ายทํางานเฉพาะที่พิธีกรเท่านั้น MCP จุดปลาย YouTube Download ต้องการเจ้าของ API กุญแจพร้อม youtube_download และโกดังเก็บของ

| แปรงทาสี | แหล่งข้อมูลที่มีอยู่ |
| --- | --- |
| เจ้าของ API กุญแจ | แหล่งที่มาที่ให้กุญแจ รวมถึง youtube_download เมื่อได้รับการอนุมัติ |
| ชั่วคราว API กุญแจ | แค่ให้แหล่งทดสอบเท่านั้น กําลังอ่านค่าขอบเขตจากการตอบสนองของการแสดงตัวปัจจุบัน |
| MCP OAuth | google_search, youtube_search, youtube_metadata, youtube_transcript |


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

### บันทึกกุญแจใน CLI

ข้ามการนําเข้าหาก CLI มีการเข้าถึงหรืออุปกรณ์ผู้จัดการลับของคุณอยู่แล้ว FLASHDATA_API_KEY. ไม่ อย่าง นั้น ให้ เลือก วิธี ที่ อยู่ ข้าง ล่าง นี้ แล้ว เก็บ ข้อมูล ไว้ สําหรับ คํา สั่ง ใน ภาย หลัง. บันทึก CLI ไม่สามารถใช้ปุ่มพิมพ์ SDK หรือระบบได้โดยอัตโนมัติ MCP เซิฟเวอร์

#### เทอร์มินัลโต้ตอบ

วางกุญแจไว้ที่สัญญาณเทอร์มินัล

##### นําเข้าเมื่อ

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


#### การอัตโนมัติ as Bash

ตั้งค่า FLASHDATA_KEY_FILE ไปยังพาธของแฟ้มกุญแจที่มีการป้องกันอยู่ คําสั่งอ่านผ่าน stdinเก็บกุญแจออกจากการสนทนาและคําสั่ง

##### อ่านความลับการคุ้มครองผ่านทาง 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 การติดตั้ง](https://flashdata.dev/th/docs/guides/flashdata-cli/reference.md#install)

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

## 2. ตรวจสอบการเชื่อมต่อ

เรียกใช้การตรวจสอบฟรีในสภาพแวดล้อมที่จะทําหน้าที่นี้ CLI ถึง HTTP เช็คใช้ API กุญแจ... MCP เช็คใช้การเชื่อมต่อของโฮสต์เอง

### Bash / cURL

ต้องการ Bash ถึง cURL 7.76+. ข้ามการแจ้งเตือนคีย์ที่ซ่อน หากสภาพแวดล้อมของคุณอยู่แล้วให้บริการ FLASHDATA_API_KEY ประมวลผลคําสั่งอ่านในเทอร์มินัลเดียวกัน

#### ตั้งค่าปุ่มพิมพ์ ski ถ้าได้ปรับแต่งไว้แล้ว

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

#### บัญชีผู้ใช้ที่อ่านแล้ว 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 ได้ตั้งค่าแล้ว ประมวลผลคําสั่งอ่านในเทอร์มินัลเดียวกัน

#### ตั้งค่าปุ่มพิมพ์ ski ถ้าได้ปรับแต่งไว้แล้ว

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

#### บัญชีผู้ใช้ที่อ่านแล้ว 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

ใช้ OS ผู้ใช้, โพรไฟล์ และไดเรกทอรีของรัฐจากการล็อกอิน แทนที่การค้นหา หากคุณใช้โพรไฟล์อื่น ๆ เพิ่ม --state-dir PATH ถ้าจําเป็น FLASHDATA_API_KEY ใช้แทนปุ่มบันทึก คาด ok: true ถึง data.accessVerified: trueสืบค้นดูในสาขางานด้านล่างนี้

#### อ่านบัญชีผู้ใช้อิสระ

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

- [ตั้งค่าคีย์](https://flashdata.dev/th/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP

ส่งนี่ไปที่วาระการเชื่อมต่อใหม่ของคุณ แทนที่ google_search ด้วยแหล่งงานที่คุณต้องการ คาด หมาย ว่า เครื่อง มือ ทั้ง สอง อย่าง จะ สําเร็จ; ตรวจ สอบ ค่า เฉลี่ย และ สมดุล ต่าง หาก ก่อน จะ ทํา งาน ที่ ได้ ค่า จ้าง. แม่ข่ายรายการเท่านั้น ไม่สามารถตรวจสอบสิทธิ์ที่เข้าใช้ได้

#### ตรวจสอบการเชื่อมต่อ

```text
ใช้การเชื่อมต่อ flashdata MCP ที่มีอยู่แล้ว
เรียก get_pricing ด้วย {"source":"google_search","request_count":1}.
เรียก get_balance ด้วย {}.
รายงานว่าทั้งสองสายประสบความสําเร็จหรือไม่ ไม่ว่าแหล่งที่มีราคาที่ใช้ได้
และค่าชดเชยเครดิต ดุลยภาพศูนย์ไม่ใช่ความล้มเหลวในการตรวจสอบสิทธิ์
ไม่ต้องเรียกค้นหาหรือดาวน์โหลด สร้างการทดลอง หรือเปลี่ยนใบรับรอง
```



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

### อ่าน API- ตัวตนของคีย์

HTTP. ช่องข้อมูลเพิ่มเติมของข้อมูลบน. ใน CLI JSONอ่าน data.identity.identity และต้องการ data.accessVerified: true. HTTP 200 หรือ CLI ok: true การอยู่คนเดียวมันไม่พอ

| ตรวจสอบ | ผลลัพธ์ที่ต้องการ |
| --- | --- |
| บัญชีผู้ใช้ที่ป้อนมา | accountId ถึง apiKeyId จง ระบุ บัญชี และ กุญแจ ที่ คุณ ตั้งใจ จะ ใช้. |
| ใช้งานได้ | access: ready |
| อนุญาตให้ใช้งาน | ขอบเขตที่มีแหล่งข้อมูล เช่น google_search CLI ยังระบุแหล่งที่มาที่ได้รับอนุญาตใน data.identity.permittedSources. |
| เริ่มทํางานใหม่ | accountType: owned · installed: true · recurringAllowed: true |

- [ทําการตรวจสอบเหล่านี้อัตโนมัติก่อนกําหนดการ](https://flashdata.dev/th/docs/guides/agent-access/reference.md#recurring-check)

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

### การเชื่อมต่อที่ทํางานอยู่

สิทธิ์ทดลองใช้อาจผ่านการตรวจสอบสำหรับงานครั้งเดียว แม้ recurringAllowed จะเป็น false ตรวจสอบสิทธิ์และเวลาหมดอายุจริง แล้วผูกสิทธิ์ทดลองใช้เดิมกับบัญชีก่อนตั้งเวลาทำงาน

#### การแสดงตัวชั่วคราว

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


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

### ค้นหาการเชื่อมต่อใน Codex

รายการเซิร์ฟเวอร์ปรับแต่งแล้วให้ใช้ /mcp ในชุดใหม่ Codex เซสชั่น เรียกใช้ MCP เช็คด้านบนเพื่อตรวจสอบความเชื่อถือ

#### รายการแม่ข่าย

```bash
codex mcp list
```

- [Codex ตั้งค่าและงานแรก](https://flashdata.dev/th/docs/integrations/codex/reference.md)

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

### ตรวจสอบการเชื่อมต่อใน OpenClaw

เรียกเซิร์ฟเวอร์ที่ถูกบันทึกแล้วเรียกใช้ MCP เช็คด้านบนในการสนทนาของคุณ

#### ปรับใช้เซิร์ฟเวอร์

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

- [OpenClaw ตั้งค่าและงานแรก](https://flashdata.dev/th/docs/integrations/openclaw/reference.md)

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

## 3. ใช้สิทธิ์ในการทํางานภายหลัง

เก็บ ห้าง สรรพ สินค้า ไว้ เป็น ส่วน ตัว และ ทํา ซ้ํา อีก. ตรวจสอบสิทธิ์ในโพรเซสใหม่ ก่อนจะเปิดตัวจัดตารางของคุณ

| แปรงทาสี | สําหรับงานต่อไป |
| --- | --- |
| เจ้าของ API กุญแจ | ใช้กุญแจที่บันทึกไว้ใหม่ ไม่มี OAuth ปรับปรุงขั้น: หากหมดอายุหรือถูกยกเลิก ให้แทนที่ |
| MCP OAuth | เครื่องโฮสต์รีเฟรช 1 ชั่วโมง OAuth การเข้าใช้เครื่องหมายปรับการหมุนของตั๋ว เชื่อมต่อเมื่อ 90- การให้วันที่หมดอายุหรือถูกยกเลิก การติดตั้งแต่ละเครื่องจะมีคลังตั๋วของมัน ดังนั้น อย่าใช้ร่วมกันสร้างแฟ้มใหม่อีกครั้งระหว่างโฮสต์ |
| ชั่วคราว API กุญแจ | เจ้าของ งาน คน หนึ่ง บอก ว่า “ผม ไม่ รู้ เลย ว่า เจ้าของ บ้าน คน นั้น จะ ทํา งาน อะไร. ใช้โพรไฟล์เดิมอีกครั้ง; ไม่ต้องลงทะเบียนใหม่อีกครั้งสําหรับแต่ละการทํางาน |

- [เริ่มทํางานใหม่](https://flashdata.dev/th/docs/guides/recurring-tasks/reference.md)

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

### เช็ค CLI งานก่อนกําหนดการ

ต้องการ Bash ถึง jq. ตั้งหน่วยปฏิบัติการเฉพาะกิจ สคริปต์ใช้การค้นหาโดยปริยาย; ตั้งค่า FLASHDATA_PROFILE ถึง FLASHDATA_STATE_DIR สําหรับโพรไฟล์หรือไดเรกทอรีของรัฐอื่น ๆ ออก 0 กับการแสดงตัว JSON หมายความว่ากุญแจของเจ้าของพร้อมติดตั้ง และอนุญาตให้ใช้กับแหล่งนี้ได้ ให้ตัวกําหนดหยุดที่ทางออกอื่น ไม่มีการส่งคําร้องขอ

#### ตรวจสอบสิทธิ์เข้าใช้โพรเซสใหม่ "He 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}'
)
```

- [เพิ่มค่าความจุ, สมดุล และค่าวิ่งซ้ํา](https://flashdata.dev/th/docs/guides/recurring-tasks/reference.md#prepare)

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

### ถ้ายังเข้าถึงได้อยู่

ทำตามคู่มือทดลองใช้และผูกบัญชีโดยใช้โปรไฟล์เดิม หลังเจ้าของอนุมัติและส่งมอบข้อมูลรับรองแล้ว การตรวจสอบฟรีควรแสดงสิทธิ์แบบ owned และ recurringAllowed: true คำขอถัดไปใช้ยอดเครดิตร่วมของเจ้าของ ส่วนเครดิตทดลองใช้ที่เหลือจะไม่โอนไปด้วย การเข้าสู่ระบบ MCP OAuth เป็นการเชื่อมต่อแยกต่างหากและไม่ได้ผูกสิทธิ์ทดลองใช้นี้กับบัญชี

- [การทดลองและเรียกร้องคําสั่ง](https://flashdata.dev/th/docs/guides/agent-onboarding/reference.md)
- [auth.md](https://flashdata.dev/auth.md)

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

## การเข้าใช้ Reviok

หยุดการทํางานที่เกิดขึ้นซ้ําก่อน เรียกคืนความเชื่อถือที่เข้าคู่กันด้านล่างนี้ แล้วเรียกเช็คใหม่จากโพรเซสหรือวาระ ก่อนล้างข้อมูลการเข้าใช้งานภายใน คาดว่าจะล้มเหลวในการตรวจสอบสิทธิ์ หรือมีการขอเชื่อมต่อใหม่; อย่าอนุมัติการเชื่อมต่อใหม่ในระหว่างการตรวจสอบ การออกจากระบบภายในเท่านั้น ไม่ได้ยกเลิกการเข้าใช้งานเซิร์ฟเวอร์

| การเชื่อมต่อ | ที่ที่จะเพิกถอน |
| --- | --- |
| MCP OAuth | Settings → Connected apps ○ เงินบริจาคจากแอพ |
| ตัวแทนที่อ้างชื่อ API กุญแจ | Settings → Connected apps ○ สายสัมพันธ์ของเจ้าหน้าที่ |
| บัญชี API กุญแจ | API Keys → คีย์ที่ใช้ในการเชื่อมต่อนี้ |

- [Connected apps](https://flashdata.dev/app/settings/connections)
- [API Keys](https://flashdata.dev/app/api-keys)
- [การยิงผิดพลาด](https://flashdata.dev/th/docs/guides/troubleshooting/reference.md#credentials)

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

## การทําการตรวจสอบล้มเหลว

| ผลลัพธ์ | การกระทํา |
| --- | --- |
| accessVerified: false | อ่านเฟสและ nextCommand โพรไฟล์ชั่วคราว สามารถคืนค่าได้ ok: true ก่อนที่กุญแจจะใช้ได้ เสร็จสิ้นการลงทะเบียนหรือการอ้างสิทธิของบันทึกไว้ คงโปรไฟล์เดียวกัน |
| access: blocked | หยุดแม้ว่า HTTP การตอบรับคือ 200. ทบทวนบัญชีหรือการเชื่อมต่อในคอนโซล; อย่าถือการตอบกลับของการแสดงตัวเป็นการอนุญาตให้สอบถาม |
| accountType: temporary | ใช้สิทธิ์ทดลองใช้ที่เข้าเกณฑ์สำหรับงานครั้งเดียว ผูกกับบัญชีก่อนตั้งเวลาทำงาน การเชื่อมต่อ OAuth ใหม่ไม่ได้ผูกโปรไฟล์นี้กับบัญชี |
| installed: false | หลังจากอนุมัติเจ้าของแล้ว ให้เรียกแฟลชดาต้า auth finish --wait ด้วยประวัติต้นฉบับและไดเรกทอรีของรัฐ งั้นก็เช็คอีกที |
| 401 / invalid_grant | เชื่อมต่อค่าที่หมดอายุแล้วหรือถูกยกเลิกไว้ในเครื่องเดิม อย่าเริ่มการทดลองอีกครั้งเพื่อข้ามมัน |
| 403 / source_forbidden | ตรวจสอบขอบเขตของกุญแจหรือ OAuth รายชื่อแหล่งข่าว YouTube Download ใช้เจ้าของ API กุญแจ |
| การเข้าถึงที่ใช้ได้, สมดุลเป็นศูนย์ | การตรวจสอบสิทธิ์ได้ผล ตรวจสอบ Billing ก่อนทําการชําระเงิน; ไม่ต้องแทนที่กุญแจที่ถูกต้อง |

- [Billing](https://flashdata.dev/app/billing)
- [เรียกคืนการเชื่อมต่อที่ขัดจังหวะ](https://flashdata.dev/th/docs/guides/agent-recovery/reference.md)
