# Quản lý khóa API

Tạo khóa cho ứng dụng hoặc tác nhân. Lưu khóa, kiểm tra quyền truy cập và quản lý vòng đời của khóa.

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

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

## 1. Tạo một phím

1. Ký vào tài khoản đã kiểm tra và mở API Keys. Dùng lại chìa khóa có thẩm quyền nếu bạn đã có rồi.
2. Hãy đặt tên cho ứng dụng và môi trường, chọn một bản expiry và chọn những nguồn cần thiết. Chọn Google Search cho ví dụ tìm kiếm đầu tiên.
3. Tạo chìa khóa và lưu nó dưới đây. Cho các tác nhân độc lập và ứng dụng sản xuất riêng biệt để bạn có thể thu hồi chúng riêng lẻ.

- [Mở API Keys](https://flashdata.dev/app/api-keys)
- [Thử trước khi đăng ký](https://flashdata.dev/vi/docs/guides/agent-onboarding/reference.md)

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

## 2. Lưu phím

Hãy chọn con đường mà bạn sẽ đi. FlashData. API và SDK Ví dụ đọc FLASHDATA_API_KEY; các CLI có thể lưu lại chìa khóa trong hồ sơ được bảo vệ. Trong sản xuất, hãy tiêm giấy phép từ cửa hàng bí mật của anh.

### Bash · API / SDK

#### Đặt chìa khóa cho thiết bị cuối này

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

#### Đặt chìa khóa cho thiết bị cuối này

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

Dán chìa khóa tại dấu nhắc ẩn. Đối với một hồ sơ tên, phụ --profile NAME ở đây và sau đó lệnh. Một hồ sơ đã cấu hình trước cần thiết đăng nhập --replace để thay thế chìa khóa.

#### Lưu chìa khóa

```bash
flashdata auth login
```

- [CLI cài đặt](https://flashdata.dev/vi/docs/guides/flashdata-cli/reference.md#install)


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

## 3. Truy cập kiểm tra

Chạy kiểm tra miễn phí trong cùng một thiết bị cuối hoặc hồ sơ CLI. Dùng thẻ tương ứng với cách bạn cất giữ khóa.

### Bash / cURL

Dùng lại FLASHDATA_API_KEY từ lần kiểm tra trước trong cùng một thiết bị cuối.

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

Dùng lại FLASHDATA_API_KEY từ lần kiểm tra trước trong cùng một thiết bị cuối.

#### 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 khả năng truy cập CLI đã lưu. Đối với một hồ sơ tên, phụ --profile NAME cho mỗi lệnh. Những câu này không dùng các tài liệu truy vấn.

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

```bash
flashdata auth status
```

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


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

### Xác nhận tài khoản và nguồn

HTTP trả lại trực tiếp các trường này. Với CLI JSONTìm chúng ở dưới data.identity.identity và cũng yêu cầu data.accessVerified: true.

| Kiểm tra | Mong đợi |
| --- | --- |
| accountId | Tài khoản sở hữu số lượng công việc này. |
| access | ready |
| scopes | Bao gồm google_search cho lần tìm kiếm đầu tiên. |
| recurringAllowed | true trước khi chủ sở hữu lịch làm việc. |

- [Chạy yêu cầu đầu tiên của bạn](https://flashdata.dev/vi/docs/guides/http-quickstart/reference.md)
- [Kiểm tra số dư và giá trị](https://flashdata.dev/vi/docs/guides/credits-and-billing/reference.md)

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

### Quyền hạn mã nguồn hoạt động như thế nào

Một chiếc chìa khóa chỉ có thể sử dụng những nguồn được ban cho. Sản phẩm được lựa chọn riêng biệt với giá cả: mỗi chìa khóa trong tài khoản tiêu dùng chung, bao gồm cả tín dụng được mua. Chìa khóa giới hạn không có nắp chi tiêu riêng. Những sản phẩm tương lai cần một khoản trợ cấp rõ ràng.

- [Danh mục tác nhân cho phép](https://flashdata.dev/vi/docs/guides/agent-onboarding/reference.md#permissions)

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

## Nếu phím đã được phơi bày

1. Thu hồi chìa khóa đã được phơi bày ngay lập tức trong trang điều khiển tương ứng bên dưới, và ngăn chặn những người gọi của nó theo lịch.
2. Tạo một thay thế với các quyền hạn cần thiết, cài đặt nó trong mỗi cửa hàng bí mật của người gọi, và chạy kiểm tra miễn phí trên.
3. ôn lại History và sử dụng tài khoản cho các hoạt động bất ngờ. Loại bỏ bí mật khỏi tập tin không thu hồi nó.

- [API Keys](https://flashdata.dev/app/api-keys)
- [Tài khoản sử dụng](https://flashdata.dev/vi/docs/guides/usage-and-limits/reference.md#usage)

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

## Xoay một phím

1. Tạo một thay thế với các nguồn cần thiết và cài đặt nó vào môi trường đích.
2. Lặp lại sự xác nhận miễn phí ở trên, rồi chuyển đổi chương trình ứng dụng hay lịch trình. Cập nhật mỗi cuộc gọi có chủ đích.
3. Thu hồi lại chìa khóa cũ sau khi người gọi đã đổi. Một tin cập nhật bí mật về laptop của bạn không cập nhật dịch vụ triển khai.

### Thay thế a CLI phím · paste vào dấu nhắc ẩn

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


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

## Thu hồi truy cập

Dừng cuộc gọi, thu hồi các phím hoặc kết nối khớp dưới đây, sau đó lặp lại việc xác thực miễn phí với các khe hở cũ. Nên từ chối. Đăng nhập vào địa phương không thu hồi truy cập máy phục vụ.

| Kiểu truy cập | Nơi để thu hồi |
| --- | --- |
| Phím API bình thường | API Keys |
| Đã xác nhận phím tác nhân | Settings → Connected apps → Agent connections |
| MCP OAuth Cung cấp | Settings → Connected apps |

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