Danh sách cho phép IP

Danh sách cho phép IP

Bạn có thể đặt danh sách cho phép IP riêng cho từng khóa API, để chỉ các yêu cầu từ IP nguồn được chỉ định mới sử dụng được khóa đó.

Khi nào nên dùng

Tính năng này phù hợp với máy chủ production có IP outbound cố định. Nếu ứng dụng gửi yêu cầu từ mạng gia đình, mạng di động hoặc địa chỉ thay đổi, hãy kiểm tra IP outbound có ổn định trước; nếu không, bạn có thể tự khóa mình bên ngoài.

Cách thiết lập

Mở /keys , mở menu "⋯" của khóa cần dùng, chọn "Danh sách cho phép IP", nhập các mục rồi lưu.

Bạn cũng có thể dùng PATCH /api/v1/keys/:id với session đã đăng nhập hoặc Management API key:

PATCH https://api.bazaarlink.ai/v1/keys/KEY_ID
Authorization: Bearer sk-bl-YOUR_MANAGEMENT_KEY
Content-Type: application/json

{
"allowedCidrs": [
  "203.0.113.7",
  "198.51.100.0/24"
]
}

# Clear the allowlist and return to unrestricted access
{"allowedCidrs": []}

Định dạng mục

Trong UI, nhập một giá trị trên mỗi dòng. Trong API, gửi các giá trị tương tự trong mảng `allowedCidrs`. Chấp nhận IPv4 thuần, IPv4 CIDR hoặc IPv6 literal (chỉ so khớp chính xác).

203.0.113.7
198.51.100.0/24
2001:db8::1

Cách hoạt động

Để trống (gửi mảng [] rỗng) nghĩa là không giới hạn IP nguồn. Đây là mặc định nên hành vi của các khóa hiện có không thay đổi.

IP nguồn được lấy từ header `cf-connecting-ip`.

Nếu danh sách không rỗng nhưng không thể xác định IP nguồn, yêu cầu sẽ bị từ chối (fail-closed).