---
title: "Bảo mật API key LLM: biến môi trường, xoay vòng, IP | BroadRouter"
description: "Giữ API key LLM ngoài code và log, cấp key riêng cho từng workload, xoay vòng định kỳ, khóa key vào IP server và thu hồi key bị lộ chỉ trong vài giây."
url: https://broadrouter.com/vi/blog/llm-api-key-security/
lang: vi
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Được dịch từ tiếng Anh với sự hỗ trợ của AI. [Đọc bản gốc tiếng Anh](https://broadrouter.com/blog/llm-api-key-security/) (cập nhật ngày 2026-11-15).

# Bảo mật API key LLM: lưu trữ, xoay vòng và danh sách IP cho phép

Đội ngũ BroadNet Inference · 6 phút đọc · Đăng ngày 2026-11-14 · Cập nhật 2026-11-15

Hãy lưu API key LLM trong secret manager, không bao giờ trong code hay trình duyệt. Cấp cho mỗi ứng dụng hoặc agent một key riêng, xoay vòng định kỳ, và khóa key vào server bằng danh sách IP cho phép. Theo BroadNet Inference, danh sách cho phép nhận 32 mục, thu hồi chặn request mới trong vòng năm giây, và key có hiệu lực một năm.

## Ý chính

-   Đừng bao giờ đưa key vào trình duyệt hay ứng dụng di động; hãy gọi LLM từ server của bạn.
-   Mỗi workload một key: tối đa 10 key đang hoạt động trên mỗi tài khoản BroadNet giúp dễ khoanh vùng khi bị lộ.
-   Danh sách IP cho phép khiến key bị đánh cắp không dùng được ở nơi khác. BroadNet nhận tối đa 32 mục IPv4, IPv6 hoặc CIDR.
-   Trên BroadNet Inference, việc thu hồi key và thay đổi danh sách cho phép có hiệu lực trong vòng năm giây.
-   Key hết hạn một năm sau khi tạo, nên xoay vòng phải là việc thường lệ, không phải xử lý khẩn cấp.

**Trong trang này**

1.  Nên lưu API key LLM ở đâu?
2.  Có thể đặt API key trong trình duyệt hay ứng dụng di động không?
3.  Vì sao mỗi workload nên có key riêng?
4.  Danh sách IP cho phép bảo vệ key thế nào?
5.  Vì sao tách key inference khỏi thông tin xác thực quản trị?
6.  Nên xoay vòng API key bao lâu một lần?
7.  Nên làm gì khi key bị lộ?
8.  Key bị lộ qua log như thế nào?
9.  Làm sao hạn chế thiệt hại từ một vụ lộ key bạn chưa phát hiện?
10.  BroadNet Inference cung cấp những cơ chế kiểm soát key nào?

Để bảo mật API key LLM, hãy giữ nó trong secret manager và chỉ gọi model từ server của bạn, không bao giờ từ trình duyệt hay ứng dụng. Cấp cho mỗi workload một key riêng, xoay vòng key định kỳ, khóa key vào IP server bằng danh sách cho phép, và khi key bị lộ thì thu hồi trước, điều tra sau.

Bài này nói về những thói quen giữ key an toàn, cùng các cơ chế kiểm soát cụ thể mà BroadNet Inference cung cấp. Để xem từng bước thao tác trên portal, hãy đọc [hướng dẫn API key và danh sách IP cho phép](https://broadrouter.com/vi/guides/api-keys-ip-allow-lists/); về ngân sách và chống vòng lặp mất kiểm soát, xem [kiểm soát chi tiêu API LLM](https://broadrouter.com/vi/blog/llm-api-spend-control/).

## Nên lưu API key LLM ở đâu?

Hãy lưu key trong secret manager hoặc kho secret được mã hóa của nền tảng, không bao giờ trong code. [OWASP Secrets Management Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html) trình bày kỹ các lựa chọn. Lưu ý lời cảnh báo của nó: biến môi trường “are generally accessible to all processes and may be included in logs or system dumps” (bản dịch: thường có thể bị mọi tiến trình truy cập và có thể lọt vào log hoặc bản dump hệ thống), nên khi có lựa chọn, OWASP ưu tiên file secret được mount hoặc lấy secret từ kho secret. Một biến môi trường được nạp từ secret manager lúc khởi động là giải pháp trung gian phổ biến.

```python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],  # fails loudly if missing
)
```

Hãy dùng `os.environ[...]`, đừng dùng `os.getenv(...)` kèm giá trị dự phòng viết cứng; chính giá trị dự phòng đó là cách key lọt vào Git. Khi phát triển cục bộ, file `.env` vẫn ổn nếu nó nằm trong `.gitignore` ngay từ commit đầu tiên. Hãy bật secret scanning và push protection của nền tảng Git bạn dùng. Trên GitHub, [push protection](https://docs.github.com/en/code-security/secret-scanning/introduction/about-push-protection) chặn các lần push chứa định dạng secret đã biết trước khi chúng tới repository; push protection cho người dùng được bật mặc định, nhưng push protection cấp repository mặc định tắt và phải do quản trị viên repository hoặc chủ tổ chức bật.

## Có thể đặt API key trong trình duyệt hay ứng dụng di động không?

Không. Bất cứ thứ gì gửi xuống client đều có thể bị trích xuất. Code front-end và gói ứng dụng là công khai, dù có được minify hay làm rối đến đâu. Hãy gọi LLM từ server, xác thực người dùng của bạn tại đó, và áp giới hạn riêng cho từng người dùng trước khi chuyển tiếp.

Công cụ desktop bạn giao cho người khác cũng vậy. Nếu một đồng nghiệp cần dùng coding agent, hãy cho họ key riêng trên tài khoản riêng thay vì dùng chung một key.

## Vì sao mỗi workload nên có key riêng?

Trên BroadNet Inference, một tài khoản có thể giữ **tối đa mười key đang hoạt động**. Hãy tận dụng chúng:

| Nhãn key | Dùng cho |
| --- | --- |
| `prod-api` | Backend production |
| `prod-worker` | Job batch |
| `staging` | Môi trường staging |
| `agent-ci` | Coding agent trong CI |
| `dev-laptop-<name>` | Phát triển cục bộ |

Khi một key bị lộ, bạn chỉ thu hồi key đó, các key khác vẫn chạy. Nhãn cũng giúp đọc mức sử dụng dễ hơn: bạn thấy workload nào tiêu bao nhiêu. Hãy đặt tên key theo thứ dùng nó, không theo người tạo ra nó.

## Danh sách IP cho phép bảo vệ key thế nào?

Một [danh sách IP cho phép](https://broadrouter.com/vi/glossary/ip-allow-list/) khiến key bị đánh cắp không dùng được ở bất cứ đâu ngoài hạ tầng của bạn. Trên BroadNet Inference:

-   Danh sách cho phép của tài khoản nhận **tối đa 32 mục**, mỗi dòng một địa chỉ IPv4 hoặc IPv6 hoặc một dải CIDR.
-   Danh sách trống nghĩa là không hạn chế.
-   Key mới kế thừa danh sách của tài khoản, trừ khi bạn tạo key với `allowed_ips` riêng, khi đó danh sách này thay thế danh sách kế thừa cho key đó.
-   Request từ địa chỉ ngoài danh sách bị từ chối với mã 403 (“refused by model, route or IP policy”, bản dịch: bị từ chối bởi chính sách model, route hoặc IP).

Tạo key với danh sách riêng qua portal API:

```bash
curl -X POST https://inference.broadnet.ai/portal/keys \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
  -H "Content-Type: application/json" \
  -d '{"label":"prod-worker","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'
```

Phản hồi chứa key gốc đúng một lần. Hãy lưu ngay vào secret manager; không thể đọc lại được. Các bước đầy đủ có trong [hướng dẫn danh sách IP cho phép](https://broadrouter.com/vi/guides/api-keys-ip-allow-lists/).

Danh sách cho phép hợp với server có IP đi ra cố định: một VPS, một NAT gateway, một IP văn phòng cố định. Với laptop dùng mạng thay đổi, hãy dùng một key riêng không có danh sách và giữ số dư mà key đó có thể tiêu ở mức nhỏ.

## Vì sao tách key inference khỏi thông tin xác thực quản trị?

BroadNet dùng hai loại thông tin xác thực:

| Thông tin xác thực | Làm được gì | Lưu ở đâu |
| --- | --- | --- |
| Key inference | Gửi request tới model qua `/v1/*` | Nơi ứng dụng chạy |
| Thông tin xác thực portal | Tạo và thu hồi key, đổi IP được phép, mua hàng | Chỉ trong công cụ tự động hóa hoặc quản trị |

Tài liệu khuyên coi mỗi thông tin xác thực portal là toàn quyền với tài khoản. Đừng bao giờ triển khai thông tin xác thực portal cạnh ứng dụng. Nếu server ứng dụng bị xâm nhập, kẻ tấn công chỉ nên lấy được một key inference, không phải quyền điều khiển tài khoản.

## Nên xoay vòng API key bao lâu một lần?

OWASP khuyên xoay vòng định kỳ “so that any stolen credentials will only work for a short time.” (bản dịch: để thông tin xác thực bị đánh cắp chỉ dùng được trong thời gian ngắn.) Key BroadNet có hiệu lực **một năm** kể từ khi tạo, nên dù sao mọi key cũng sẽ phải thay. Hãy biến xoay vòng thành việc thường lệ:

1.  Tạo key mới với cùng quy ước nhãn và danh sách cho phép.
2.  Triển khai song song với key cũ, hoặc đổi secret rồi khởi động lại.
3.  Theo dõi traffic chuyển sang key mới.
4.  Thu hồi key cũ bằng `DELETE /portal/keys/{alias}`.

Vì một tài khoản có thể giữ tối đa mười key đang hoạt động, bạn có thể cho key cũ và mới chạy chồng nhau vài phút mà không gián đoạn. Hãy xoay vòng sớm hơn với những key mà thành viên sắp rời nhóm từng có quyền truy cập.

## Nên làm gì khi key bị lộ?

Khi key bị lộ, hãy thu hồi trước và điều tra sau. Trên BroadNet Inference, request mới dừng **trong vòng năm giây** sau khi thu hồi hoặc thay đổi danh sách cho phép; tài liệu giải thích rằng quyết định cấp quyền có thể còn nằm trong cache được nhân bản trong khoảng thời gian giới hạn đó.

Sau khi thu hồi:

-   kiểm tra mức sử dụng của key trên trang tài khoản hoặc qua `GET /portal/usage`;
-   tìm xem key bị lộ thế nào (lịch sử commit, log CI, một ảnh chụp màn hình được chia sẻ);
-   xoay vòng mọi secret khác lưu cùng chỗ.

Key đã bị thu hồi hoặc bị chặn trả về 401 hoặc 403; xem [hướng dẫn lỗi](https://broadrouter.com/vi/guides/errors-and-retries/) để hệ thống giám sát không coi chúng là lỗi tạm thời.

## Key bị lộ qua log như thế nào?

Log là đường lộ dễ bị bỏ sót. Hãy che header `Authorization` trong log debug HTTP, công cụ báo lỗi và log truy cập của proxy. Khi liên hệ hỗ trợ, hãy gửi `X-Request-ID`, thời điểm, route, trạng thái và **alias** của key, không bao giờ gửi chính key. Tài liệu của BroadNet cho biết portal chỉ lưu hash của mỗi key, nên cũng không thể hiển thị lại key bạn đã làm mất.

## Làm sao hạn chế thiệt hại từ một vụ lộ key bạn chưa phát hiện?

Ngay cả khi đã giữ mọi thói quen trên, hãy giả định một ngày nào đó key có thể bị lộ. Thu nhỏ phạm vi ảnh hưởng:

-   Giữ số dư trả theo mức dùng ở mức bạn chấp nhận mất được, và nạp tiền khi cần.
-   Dùng gói giá cố định cho agent chạy nặng: một phiên của gói có giá cố định, nên key gói bị đánh cắp không thể đẩy hóa đơn tính theo token lên. Xem [“không giới hạn” thực sự nghĩa là gì](https://broadrouter.com/vi/blog/what-unlimited-llm-api-really-means/).
-   Đặt cảnh báo khi chi tiêu hoặc tốc độ request của từng key bất thường; [công cụ tính chi phí API LLM](https://broadrouter.com/tools/llm-api-cost-calculator/) cho bạn con số hằng tháng bình thường để làm mốc cảnh báo. Bài [kiểm soát chi tiêu API LLM](https://broadrouter.com/vi/blog/llm-api-spend-control/) đề cập ngân sách và cảnh báo.

## BroadNet Inference cung cấp những cơ chế kiểm soát key nào?

| Cơ chế | BroadNet Inference |
| --- | --- |
| Key chỉ hiện một lần, lưu dạng hash | Có |
| Key đang hoạt động mỗi tài khoản | Tối đa 10 |
| Thời hạn key | Một năm |
| Danh sách IP cho phép | Tối đa 32 mục IPv4, IPv6 hoặc CIDR |
| Danh sách cho phép theo từng key | Có, `allowed_ips` khi tạo |
| Thu hồi có hiệu lực | Trong vòng năm giây |
| Thông tin xác thực quản trị riêng | Thông tin xác thực portal |

Key bảo vệ tài khoản của bạn; [không lưu giữ dữ liệu](https://broadrouter.com/vi/privacy/) bảo vệ những gì bạn gửi qua tài khoản đó. Hãy đọc cả hai trước khi đưa lên production.

Công cụ miễn phí cho chủ đề này (tiếng Anh)

-   [OpenAI to BroadNet migration helper](https://broadrouter.com/tools/openai-to-broadnet-migration/) Paste OpenAI SDK code; get base URL, key and model edits, a diff and the checks that remain.
-   [max\_tokens calculator for reasoning models](https://broadrouter.com/tools/reasoning-token-budget/) Answer length + reasoning budget + margin = a max\_tokens that does not cut the answer off.
-   [JSON schema generator for LLM structured output](https://broadrouter.com/tools/json-schema-generator/) Sample JSON to strict schema, Pydantic, Zod and a ready request.
-   [LLM JSON output validator](https://broadrouter.com/tools/llm-json-output-validator/) Parse errors by line and column, safe repairs, cut-off detection and JSON Schema checks for model output.

[Công cụ miễn phí (tiếng Anh)](https://broadrouter.com/tools/)

## Thuật ngữ trong bài này

[API key (khóa API)](https://broadrouter.com/vi/glossary/api-key/)

API key là một chuỗi bí mật dùng để xác định và cấp quyền cho client gọi API. API LLM thường yêu cầu nó trong header Authorization: Bearer, và bất kỳ ai giữ key đều có thể gửi request được tính phí vào tài khoản sở hữu key đó.

[AI coding agent](https://broadrouter.com/vi/glossary/coding-agent/)

AI coding agent là công cụ phần mềm trong đó một model ngôn ngữ làm việc trên codebase theo vòng lặp: đọc file, sửa file, chạy lệnh như test, đọc kết quả và quyết định bước tiếp theo cho tới khi xong task hoặc chạm giới hạn.

[IP allow list (danh sách IP được phép)](https://broadrouter.com/vi/glossary/ip-allow-list/)

IP allow list là cơ chế bảo mật chỉ chấp nhận request từ các địa chỉ IP hoặc dải CIDR trong danh sách và từ chối mọi nguồn khác. Trên API, nó hạn chế thiệt hại khi key bị lộ, vì key không hoạt động từ các mạng không có trong danh sách.

[Không lưu giữ dữ liệu (zero data retention, ZDR)](https://broadrouter.com/vi/glossary/zero-data-retention/)

Không lưu giữ dữ liệu (ZDR) là chính sách mà nhà cung cấp AI chỉ xử lý prompt và đầu ra để phục vụ request, sau đó không lưu nội dung đó vào log, cache hay dữ liệu huấn luyện. Các bản ghi không chứa nội dung như số token và thời gian xử lý thường vẫn được giữ.

[Token](https://broadrouter.com/vi/glossary/token/)

Token là đơn vị văn bản mà model ngôn ngữ đọc và viết: một từ, một phần của từ, một dấu câu hoặc một chuỗi byte do tokenizer của model tạo ra. API LLM đếm, giới hạn và thường tính phí theo token.

[Tool calling (gọi tool, function calling)](https://broadrouter.com/vi/glossary/tool-calling/)

Tool calling, còn gọi là function calling, là tính năng của API LLM trong đó model trả về một yêu cầu có cấu trúc để chạy một hàm do nhà phát triển định nghĩa, kèm đối số JSON. Ứng dụng chạy hàm rồi gửi kết quả lại; model không bao giờ tự chạy code.

[Trả theo mức dùng (pay-as-you-go)](https://broadrouter.com/vi/glossary/pay-as-you-go/)

Trả theo mức dùng (pay-as-you-go) là mô hình giá mà bạn chỉ trả cho những gì đã dùng, đo theo đơn vị như token, request hoặc phút âm thanh, không có gói đăng ký hay cam kết tối thiểu. Hầu hết API LLM tính phí theo cách này, trừ vào số dư trả trước hoặc qua hóa đơn định kỳ.

## Câu hỏi thường gặp

### Nên lưu API key LLM ở đâu?

Trong secret manager hoặc kho secret được mã hóa của nền tảng, rồi đưa vào tiến trình dưới dạng biến môi trường như BROADNET\_API\_KEY. Không để trong mã nguồn, không trong file .env đã commit, và tuyệt đối không trong code front-end.

### Thu hồi một key BroadNet Inference nhanh đến mức nào?

Tài liệu của BroadNet cho biết request mới sẽ dừng trong vòng năm giây sau khi thu hồi hoặc thay đổi danh sách cho phép, vì quyết định cấp quyền có thể còn nằm trong cache được nhân bản trong khoảng thời gian giới hạn đó.

### Key BroadNet Inference có hiệu lực bao lâu?

Key trả theo mức dùng có hiệu lực một năm kể từ khi tạo. Một tài khoản có thể giữ tối đa mười key đang hoạt động, nên bạn có thể tạo key thay thế trước khi key cũ hết hạn.

### Nếu làm mất key, BroadNet có hiển thị lại được không?

Không. Tài liệu của BroadNet cho biết key gốc chỉ được trả về một lần và portal chỉ lưu hash của nó. Hãy tạo key mới và thu hồi key cũ.

### Làm gì nếu API key tương thích OpenAI của tôi bị lộ?

Thu hồi trước, điều tra sau. Kiểm tra mức sử dụng của key xem có traffic lạ không, tìm nơi bị lộ (lịch sử commit, log CI, ảnh chụp màn hình), xoay vòng mọi secret khác lưu cùng chỗ, và cấp key thay thế có danh sách IP cho phép.

## Đọc tiếp

-   [Kiểm soát chi phí API LLM: ngân sách, giới hạn key và chặn vòng lặp](https://broadrouter.com/vi/blog/llm-api-spend-control/)
-   [Gửi dữ liệu nhạy cảm tới API LLM: che, tối thiểu hóa, ghi log ít](https://broadrouter.com/vi/blog/llm-api-sensitive-data/)
-   [Cách xử lý lỗi 429 của API LLM: backoff, jitter và giới hạn đồng thời](https://broadrouter.com/vi/blog/handle-llm-api-429-rate-limits/)
-   [GDPR và API LLM: 15 câu hỏi cần đặt cho nhà cung cấp](https://broadrouter.com/vi/blog/gdpr-llm-api-checklist/)
-   [Phần cứng GPU và cách phục vụ model của BroadNet, theo lời BroadNet](https://broadrouter.com/vi/blog/broadnet-gpu-fleet-and-serving/)
-   [Cache phản hồi API LLM để giảm chi phí: cache khớp chính xác (Python)](https://broadrouter.com/vi/blog/cache-llm-responses-cut-cost/)
-   [Hướng dẫn: Khóa API key vào server của bạn bằng danh sách IP cho phép](https://broadrouter.com/vi/guides/api-keys-ip-allow-lists/)
-   [Hướng dẫn: Mã lỗi BroadNet Inference và khi nào nên thử lại](https://broadrouter.com/vi/guides/errors-and-retries/)
-   [Hướng dẫn: Dùng OpenAI Python SDK với BroadNet Inference](https://broadrouter.com/vi/guides/openai-python-sdk/)

Hãy thử với khối lượng công việc thực tế của bạn. Tài khoản mới được tặng US$5 tín dụng ban đầu cho Gemma và chuyển giọng nói thành văn bản. DeepSeek, GLM và Qwen3.8 cần nạp tiền.

[Bắt đầu](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-blog-llm-api-key-security&utm_content=page-cta) ·

**Nguồn**

-   [Tài liệu tham chiếu API BroadNet Inference, giới hạn: thời hạn key, số key đang hoạt động (truy cập ngày 2026-11-14) (tiếng Anh)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-blog-llm-api-key-security&utm_content=sources#limits)
-   [Tài liệu tham chiếu API BroadNet Inference, danh sách IP cho phép và key portal (truy cập ngày 2026-11-14) (tiếng Anh)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-blog-llm-api-key-security&utm_content=sources#ip-allow-lists)
-   [OWASP Secrets Management Cheat Sheet (truy cập ngày 2026-11-14)](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html)
-   [GitHub Docs, secret scanning (truy cập ngày 2026-11-14)](https://docs.github.com/en/code-security/secret-scanning/about-secret-scanning)
-   [GitHub Docs, giới thiệu push protection (truy cập ngày 2026-11-14)](https://docs.github.com/en/code-security/secret-scanning/introduction/about-push-protection)
