---
title: "IP allow list cho API key là gì? Ví dụ CIDR | BroadRouter"
description: "IP allow list chỉ chấp nhận request từ địa chỉ hoặc dải CIDR trong danh sách. Cách nó bảo vệ API key của LLM, cách CIDR hoạt động và bẫy với IP egress trên cloud."
url: https://broadrouter.com/vi/glossary/ip-allow-list/
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/glossary/ip-allow-list/) (cập nhật ngày 2026-11-14).

# IP allow list (danh sách IP được phép)

Cập nhật 2026-11-14

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.

Còn gọi là: IP allow list là gì, whitelist IP, danh sách IP được phép, giới hạn IP, IP được phép, IP allowlist, IP whitelist, allowed IPs, IP restriction, allowed\_ips

Mặc định, một API key hoạt động từ bất cứ đâu. Allow list gắn nó với những nơi bạn thực sự chạy code.

## Cách hoạt động

Lớp edge của API kiểm tra IP nguồn của mỗi request với một danh sách. Nếu địa chỉ có trong danh sách, hoặc nằm trong một dải đã liệt kê, request đi tiếp tới bước kiểm tra key thông thường. Nếu không, nó bị từ chối.

Các dải được viết theo ký pháp CIDR: một địa chỉ, dấu gạch chéo và độ dài prefix. RFC 4632 giải thích độ dài prefix là số bit đầu được cố định. Với IPv4:

| Mục | Phạm vi |
| --- | --- |
| `203.0.113.7` | một địa chỉ |
| `198.51.100.0/24` | 256 địa chỉ, từ `198.51.100.0` đến `198.51.100.255` |
| `10.0.0.0/16` | 65,536 địa chỉ |

IPv6 dùng cùng ý tưởng với địa chỉ 128 bit, chẳng hạn `2001:db8::/48`.

Địa chỉ quan trọng là IP **egress** của bạn: địa chỉ công khai mà lưu lượng từ server đi ra. Khi nằm sau NAT, load balancer hoặc proxy của công ty, địa chỉ đó thường không phải địa chỉ mà máy tự hiển thị.

## Vì sao quan trọng

[API key](https://broadrouter.com/vi/glossary/api-key/) là bearer token: ai giữ nó thì người đó dùng được. Key bị lộ qua commit, log, ảnh chụp màn hình và laptop. Có allow list, key bị đánh cắp sẽ thất bại khi gọi từ mạng của kẻ tấn công, biến một vụ lộ key từ sự cố tốn tiền thành chuyện không đáng kể. Ví dụ, GitHub áp dụng allow list cho cả lệnh gọi API và personal access token, không chỉ đăng nhập web.

Cái giá là thêm chút việc vận hành. Mỗi server, region hay CI runner mới cần thêm IP egress của nó, và IP động cần một đường egress cố định.

## Trên BroadNet Inference

Trên trang tài khoản, thêm mỗi dòng một địa chỉ IPv4 hoặc IPv6 hoặc một dải CIDR, tối đa 32 mục. Danh sách trống nghĩa là không giới hạn. Key mới kế thừa danh sách của tài khoản. `allowed_ips` riêng cho từng key sẽ thay thế danh sách đó cho key ấy:

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

Request từ địa chỉ khác nhận lỗi 403. Sau khi thay đổi danh sách hoặc thu hồi key, request mới bị chặn trong vòng năm giây. Các bước đầy đủ có trong [API key và IP allow list](https://broadrouter.com/vi/guides/api-keys-ip-allow-lists/), còn bảng lỗi nằm trong [lỗi và thử lại](https://broadrouter.com/vi/guides/errors-and-retries/). Để có bức tranh rộng hơn về bảo vệ dữ liệu, xem [checklist ZDR](https://broadrouter.com/vi/blog/zero-data-retention-llm-api-checklist/).

## Lỗi thường gặp

-   Thêm địa chỉ private của server, như `10.x.x.x`, thay vì IP egress công khai.
-   Dùng dải rất rộng cho hết lỗi. Một `/8` bao phủ hơn 16 triệu địa chỉ.

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

### IP allow list có đủ để bảo vệ API key không?

Không. Nó chỉ là một lớp bảo vệ. Bạn vẫn nên giữ key trên server, không để trong code và log, cấp cho mỗi ứng dụng một key riêng, và thu hồi key ngay khi bị lộ.

### Server của tôi chạy serverless hoặc autoscaling. Có dùng allow list được không?

Chỉ khi lưu lượng đi ra xuất phát từ các địa chỉ đã biết. Hãy định tuyến nó qua NAT gateway hoặc egress proxy có IP cố định, rồi thêm các IP đó vào danh sách.

### Request từ IP không có trong danh sách sẽ nhận lỗi gì?

Trên BroadNet Inference là 403. Các API khác thường cũng trả về 403.

## Xem thêm

-   [API key (khóa API)](https://broadrouter.com/vi/glossary/api-key/) (thuật ngữ)
-   [Không lưu giữ dữ liệu (zero data retention, ZDR)](https://broadrouter.com/vi/glossary/zero-data-retention/) (thuật ngữ)
-   [Giới hạn tần suất (rate limit)](https://broadrouter.com/vi/glossary/rate-limit/) (thuật ngữ)
-   [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)
-   [API LLM không lưu giữ dữ liệu: checklist 10 câu hỏi](https://broadrouter.com/vi/blog/zero-data-retention-llm-api-checklist/) (bài viết)

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-glossary-ip-allow-list&utm_content=page-cta) ·

**Nguồn**

-   [RFC 4632: Classless Inter-domain Routing (CIDR)](https://www.rfc-editor.org/rfc/rfc4632)
-   [GitHub Docs, quản lý địa chỉ IP được phép cho tổ chức](https://docs.github.com/en/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)
-   [Tài liệu tham chiếu API BroadNet Inference, IP allow list (tiếng Anh)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-glossary-ip-allow-list&utm_content=sources#ip-allow-lists)
