# Tùy chọn xác thực tác nhân

Kết nối với một API Khóa hay MCP OAuthđể xác minh quyền truy cập mà không cần yêu cầu trả tiền, và tái sử dụng nó cho các nhiệm vụ sau này.

Tài liệu tham khảo chính điển: https://flashdata.dev/vi/docs/guides/agent-access
Xem lại: 2026-11-05 by FlashData

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

## 1. Chọn và kết nối

Đã kết nối rồi à? Đi thẳng đến kiểm tra miễn phí trong bước 2. Nếu không, hãy chọn truy cập vào đơn hoặc tác nhân của bạn cần.

| Bạn đang kết nối | Dùng | Ai giữ thẻ tín dụng? |
| --- | --- | --- |
| Một ứng dụng, SDK, CLI hay lịch làm việc | Sở hữu khóa API | Cửa hàng bí mật của máy phục vụ của bạn hoặc CLI hồ sơ |
| Codex hay OpenClaw Công cụ nghiên cứu | MCP OAuth | Máy sau khi trình duyệt cho phép |
| Một tác nhân đang cố gắng. FlashData không có tài khoản | Phím API tạm thời | Tác nhân đã lưu hồ sơ thử nghiệm, sau đó chủ sở hữu truy cập sau khi tuyên bố |

### Phím API

Tạo một phím vào API Keys với các nguồn mà bạn cần, hoặc sử dụng lại một phím đã có. Cung cấp nó cho bạn SDK hoặc gửi nó như X-API-Key từ backend của anh. Hạt Bash và PowerShell kiểm tra trong bước 2 làm việc trực tiếp với các API; không CLI yêu cầu cài đặt.

- [API Keys](https://flashdata.dev/app/api-keys)
- [Lưu một chìa khóa vào CLI](https://flashdata.dev/vi/docs/guides/agent-access/reference.md#import-key)
- [SDK và HTTP Thiết lập phím](https://flashdata.dev/vi/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP OAuth

Dùng máy đã cấu hình cho FlashData OAuth. Chủ tài khoản đã đăng ký hoặc đăng nhập và đồng ý trong trình duyệt; máy đó lưu các biểu tượng. Kết nối không được cài đặt CLI Chìa khóa hoặc đòi xét xử.

#### Máy MCP kết nối

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

- [Kết nối Codex](https://flashdata.dev/vi/docs/integrations/codex/reference.md#setup)
- [Kết nối OpenClaw](https://flashdata.dev/vi/docs/integrations/openclaw/reference.md#setup)
- [Khác MCP Khách](https://flashdata.dev/vi/docs/integrations/mcp-clients/reference.md#connect)

### Phiên tòa tác nhân

Đối với một tác nhân không có chìa khóa, discover Phiên tòa xét xử hiện tại, trước khi đăng ký. Dùng lại một thử nghiệm và hồ sơ đã có. YouTube Download và việc lặp lại cần thiết quyền truy cập chủ sở hữu.

#### Phát hiện mà không đăng ký

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

- [Bắt đầu một phiên tòa và tuyên bố nó](https://flashdata.dev/vi/docs/guides/agent-onboarding/reference.md)
- [Giao thức xác thực tác nhân](https://flashdata.dev/auth.md)


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

### Nguồn tin nào có thể được xác nhận này?

Dùng X-API-Key chuẩn HTTP yêu cầu và API-key MCP kết nối. OAuth Mang theo vật kỷ niệm chỉ làm việc ở chỗ chủ nhà MCP điểm cuối. YouTube Download Cần một chủ nhân API phím với youtube_download và lưu trữ địa điểm.

| Nhận diện | Các nguồn sẵn sàng |
| --- | --- |
| Sở hữu khóa API | Các nguồn được cấp cho chìa khóa, bao gồm youtube_download khi được chấp thuận. |
| Phím API tạm thời | Chỉ được cấp những nguồn có thể thử nghiệm. Đọc phạm vi từ phản ứng nhận dạng hiện thời. |
| MCP OAuth | google_search, youtube_search, youtube_metadata, youtube_transcript |


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

### Lưu một chìa khóa vào CLI

Bỏ qua mục nhập nếu bị tắt CLI Đã có quyền truy cập hoặc nguồn cung cấp cho người quản lý bí mật FLASHDATA_API_KEY. Nếu không, hãy chọn một phương pháp bên dưới và giữ hồ sơ nghiên cứu tương tự cho các lệnh sau. Được cứu CLI Khóa không tự động sẵn sàng cho SDKs hay cục bộ MCP Máy chủ.

#### Trình lệnh tương tác

Dán chìa khóa tại dấu nhắc thiết bị cuối bị ẩn.

##### Nhập một lần

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


#### Tự động hoá # Bash

Đặt FLASHDATA_KEY_FILE tới đường dẫn của một tập tin khóa đã được bảo vệ. Chỉ huy đọc nó qua stdin; giữ phím ra khỏi các đối số trò chuyện và lệnh.

##### Đọc một bí mật được bảo vệ qua 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 cài đặt](https://flashdata.dev/vi/docs/guides/flashdata-cli/reference.md#install)

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

## 2. Kiểm tra kết nối

Chạy kiểm tra miễn phí trong môi trường sẽ thực hiện nhiệm vụ này. CLI và HTTP Kiểm tra dùng a API Chìa khóa; MCP Kiểm tra sử dụng kết nối đã lưu của máy.

### Bash / cURL

Yêu cầu Bash và cURL 7.76+. Bỏ qua dấu nhắc phím bị ẩn nếu môi trường của bạn đã cung cấp FLASHDATA_API_KEY. Chạy lệnh đọc trong cùng một thiết bị cuối.

#### Đặt phím · nhảy qua nếu đã cấu hình rồi

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

#### Tài khoản đọc 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

Bỏ qua dấu nhắc khoá bị ẩn nếu FLASHDATA_API_KEY đã được thiết lập. Chạy lệnh đọc trong cùng một thiết bị cuối.

#### Đặt phím · nhảy qua nếu đã cấu hình rồi

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

#### Tài khoản đọc 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

Sử dụng OS người dùng, hồ sơ và thư mục tiểu dụng từ việc đăng nhập. Thay thế nghiên cứu nếu bạn sử dụng hồ sơ khác; thêm --state-dir PATH nếu cần thiết. FLASHDATA_API_KEY Ghi đè phím đã lưu. Mong đợi ok: true và data.accessVerified: true; sau đó kiểm tra các lĩnh vực danh tính bên dưới.

#### Tài khoản miễn phí đọc

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

- [Thiết lập phím](https://flashdata.dev/vi/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP

Gửi cái này cho một phiên họp mới của đại lý kết nối của anh. Thay thế google_search bằng nguồn mà bạn cần. Mong đợi cả hai công cụ đều thành công; kiểm tra từng bên giá trị và sự số dư trước khi được trả lương. Chỉ một máy phục vụ liệt kê không xác minh quyền truy cập.

#### Kiểm tra kết nối

```text
Dùng kết nối Flashdata MCP đã có.
Gọi get_pricing với {"source":"google_search","request_count":1}.
Gọi get_balance với {}.
Báo cáo xem cả hai cuộc gọi có thành công không, liệu nguồn tin có giá cả không,
và số tiền tín dụng sẵn có. Một số không số dư không không phải là một thất bại xác thực.
Đừng chạy tìm kiếm hay tải về, tạo một thử nghiệm, hoặc thay đổi giấy ủy nhiệm.
```



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

### Đọc danh tính API-key

HTTP Các trường nhận dạng ở cấp độ cao nhất. Vào CLI JSONĐọc data.identity.identity và yêu cầu data.accessVerified: true. HTTP 200 hay CLI ok: true cô đơn là không đủ.

| Kiểm tra | Cần kết quả |
| --- | --- |
| Tài khoản đã sửa | accountId và apiKeyId nhận ra lời tường thuật và chìa khóa mà bạn định dùng. |
| Truy cập có thể dùng | access: ready |
| Cho phép tác vụ | Phạm vi chứa nguồn, như google_search. CLI cũng liệt kê các nguồn cho phép trong data.identity.permittedSources. |
| Đang đệ lại tác vụ | accountType: owned · installed: true · recurringAllowed: true |

- [Tự động hoá các kiểm tra này trước khi lên lịch](https://flashdata.dev/vi/docs/guides/agent-access/reference.md#recurring-check)

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

### Name

Một phiên tòa có thể vượt qua một lần kiểm tra nhiệm vụ trong khi recurringAllowed là false. Hãy đọc các phạm vi và lời giải phẫu đã có trước khi lên kế hoạch.

#### Trường nhận diện tạm thời

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


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

### Tìm kết nối trong Codex

Liệt kê các máy phục vụ đã cấu hình, rồi dùng /mcp trong một cái mới Codex phiên họp. Kiểm tra MCP ở trên để xác minh xác nhận dấu vết.

#### Liệt kê máy phục vụ

```bash
codex mcp list
```

- [Codex nhiệm vụ thiết lập và đầu](https://flashdata.dev/vi/docs/integrations/codex/reference.md)

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

### Kiểm tra kết nối OpenClaw

Probe máy phục vụ đã lưu, sau đó chạy các MCP kiểm tra trên đây trong cuộc nói chuyện tích cực của bạn.

#### Probe máy phục vụ

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

- [OpenClaw nhiệm vụ thiết lập và đầu](https://flashdata.dev/vi/docs/integrations/openclaw/reference.md)

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

## 3. Dùng lại quyền truy cập các tác vụ sau

Giữ cửa hàng chứng nhận riêng và bền bỉ trong quá trình khởi động lại. Kiểm tra lại truy cập trong tiến trình mới trước khi bật trình lên lịch.

| Nhận diện | Cho nhiệm vụ tiếp theo |
| --- | --- |
| Sở hữu khóa API | Dùng lại chìa khóa đã lưu. Nó không có OAuth Bước cập nhật; thay thế nếu đã quá hạn hoặc bị thu hồi. |
| MCP OAuth | Người dẫn chương trình cập nhật một giờ. OAuth Bảng điều khiển truy cập bằng cách xoay bảng hiệu cập nhật. Tái kết nối khi 90- trợ cấp hàng ngày hết hạn hoặc bị thu hồi. Mỗi bản cài đặt sở hữu cửa hàng tượng trưng của nó; không chia sẻ các tập tin đã được cập nhật giữa các máy. |
| Phím API tạm thời | Hoàn tất liên kết với chủ tài khoản và bàn giao thông tin xác thực trước khi chạy tác vụ định kỳ. Dùng lại hồ sơ ban đầu; không đăng ký lại cho mỗi lần chạy. |

- [Name](https://flashdata.dev/vi/docs/guides/recurring-tasks/reference.md)

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

### Kiểm tra một CLI tác vụ trước khi lên lịch

Yêu cầu Bash và jq. Đặt dấu hiệu của nhiệm vụ. Văn lệnh dùng việc nghiên cứu theo mặc định; thiết lập FLASHDATA_PROFILE và FLASHDATA_STATE_DIR cho một hồ sơ hay thư mục tiểu dụng khác. Thoát 0 có nhân dạng JSON có nghĩa là chìa khóa sở hữu đã sẵn sàng, được cài đặt và cho phép sử dụng nguồn này. Hãy cho lịch trình dừng lại ở bất kỳ lối ra nào khác. Không có truy vấn nào được gửi đi.

#### Kiểm tra truy cập xử lý mới 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}'
)
```

- [Thêm giá trị, số dư và một người chạy tiếp](https://flashdata.dev/vi/docs/guides/recurring-tasks/reference.md#prepare)

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

### Nếu truy cập vẫn còn là một phiên tòa

Hoàn thành hướng dẫn dùng thử và liên kết tài khoản bằng hồ sơ ban đầu. Sau khi chủ tài khoản phê duyệt và thông tin xác thực được bàn giao, phép kiểm tra miễn phí phải hiển thị quyền truy cập owned và recurringAllowed: true. Các yêu cầu tiếp theo dùng số dư chung của chủ tài khoản; tín dụng dùng thử chưa dùng không được chuyển sang. Đăng nhập MCP OAuth là kết nối riêng và không liên kết bản dùng thử này.

- [Lệnh xét xử và tuyên bố](https://flashdata.dev/vi/docs/guides/agent-onboarding/reference.md)
- [auth.md](https://flashdata.dev/auth.md)

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

## Thu hồi truy cập

Tạm dừng việc làm lại trước. Thu hồi lại các dấu chấm bên dưới, sau đó lặp lại việc kiểm tra miễn phí từ một tiến trình hoặc phiên chạy mới trước khi xóa bỏ truy cập địa phương. Mong đợi việc xác thực bị lỗi hoặc yêu cầu tái kết nối; không chấp nhận kết nối mới trong khi kiểm tra. Chỉ đăng xuất cục bộ thôi không thể thu hồi truy cập máy phục vụ.

| Kết nối | Nơi để thu hồi |
| --- | --- |
| MCP OAuth | Settings → Connected apps Tiền trợ cấp của ứng dụng. |
| Tác nhân đã xác nhận API Khóa | Settings → Connected apps Các mối liên hệ của tác nhân. |
| Phím API | API Keys chìa khóa được sử dụng bởi sự tích hợp này. |

- [Connected apps](https://flashdata.dev/app/settings/connections)
- [API Keys](https://flashdata.dev/app/api-keys)
- [Lỗi truy cập vấn đề](https://flashdata.dev/vi/docs/guides/troubleshooting/reference.md#credentials)

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

## Sửa một kiểm tra lỗi

| Kết quả | Hành động |
| --- | --- |
| accessVerified: false | Đọc giai đoạn và nextCommand. Name ok: true Trước khi chìa khóa được sử dụng. Hoàn tất giấy đăng ký lưu hoặc yêu cầu; giữ cùng hồ sơ. |
| access: blocked | Dừng lại ngay cả khi HTTP Trả lời là 200. Xem lại tài khoản hoặc kết nối trong bảng điều khiển; đừng xem phản ứng nhận diện là quyền truy vấn. |
| accountType: temporary | Dùng thử nghiệm thích hợp cho công việc một lần. Hãy khẳng định điều đó trước khi lên kế hoạch; một điều mới OAuth kết nối không đòi hỏi hồ sơ này. |
| installed: false | Sau khi được chủ sở hữu chấp thuận, chạy flashdata auth finish --wait với hồ sơ gốc và thư mục tiểu dụng. Vậy thì nhắc lại đi. |
| 401 / invalid_grant | Kết nối lại thời gian đã hết hạn hoặc bị thu hồi trong máy gốc của nó. Đừng bắt đầu một thử nghiệm khác để vượt qua nó. |
| 403 / source_forbidden | Kiểm tra phạm vi của khóa hoặc OAuth Danh sách nguồn. YouTube Download sử dụng chủ sở hữu API Chìa khóa. |
| Truy cập hợp lệ, số không số dư | Xác thực đã thành công. Kiểm tra Billing trước khi trả tiền, đừng thay thế một khóa hợp lệ. |

- [Billing](https://flashdata.dev/app/billing)
- [Name](https://flashdata.dev/vi/docs/guides/agent-recovery/reference.md)
