Claude API có IP allowlist (beta) để hạn chế API key bị lộ

· Ban biên tập

Từ 5/11/2026, admin tổ chức trên Claude Console có thể giới hạn các địa chỉ IP được gọi Claude API, Managed Agents và Admin API. Request từ IP ngoài danh sách bị trả lỗi 403, nên API key bị lộ khó dùng hơn nhiều. Tính năng đang beta và không áp dụng cho Claude qua Bedrock, Google Cloud hay Foundry.

Chuyện gì đã xảy ra

Theo release notes của Claude Platform ngày 5/11/2026, tổ chức trên Claude Console giờ có thể bật IP allowlist (danh sách IP được phép), đang ở dạng beta. Request tới các dịch vụ được bảo vệ mà đến từ địa chỉ không có trong danh sách sẽ bị từ chối. Mỗi tổ chức thêm được tối đa 1.000 mục, gồm địa chỉ IPv4, IPv6 hoặc dải CIDR.

Theo tài liệu IP allowlisting:

  • Ai cấu hình: admin hoặc owner của tổ chức, ở trang Identity and access trong Claude Console. Danh sách áp dụng cho cả tổ chức.
  • Được bảo vệ: giao diện Claude Console; các endpoint Messages, Message Batches, Token Counting, Models, Files, Skills (dùng API key hoặc token Workload Identity Federation); các endpoint Managed Agents (Agents, Sessions, Environments, Vaults, Memory stores); Admin API và Compliance API.
  • Không được bảo vệ: Claude trên Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud, Claude in Microsoft Foundry. Allowlist cũng không áp dụng cho kết nối mạng bên trong runtime của Managed Agents.
  • Khi bị chặn: Messages API trả 403 permission_error với thông điệp Your IP address isn't in this organization's allowed range.
  • Giới hạn mục: dải CIDR không rộng hơn /8 với IPv4 và /32 với IPv6; chỉ nhận địa chỉ public, không nhận dải nội bộ như 10.0.0.0/8.
  • Thay đổi có thể mất tới 15 phút mới có hiệu lực.

Claude Enterprise có một allowlist riêng cho các ứng dụng (claude.ai, desktop, mobile, Claude Code khi đăng nhập bằng tài khoản Claude…), do owner cấu hình.

Vì sao quan trọng

API key lộ qua repo, log CI hay máy dev là sự cố rất phổ biến. Trước đây, key lộ có thể bị dùng từ bất kỳ đâu cho tới khi bị thu hồi. Với allowlist, kẻ có key nhưng không đi ra từ mạng của bạn sẽ nhận 403, giảm cả rủi ro rò dữ liệu lẫn hoá đơn bất thường.

Tài liệu cũng nói rõ giới hạn: allowlist chỉ hạn chế key dùng ở đâu, không hạn chế key sống bao lâu. Anthropic khuyên kết hợp thời hạn key ngắn hoặc chuyển sang Workload Identity Federation (token ngắn hạn thay cho key tĩnh). Nếu bạn gọi Claude qua Bedrock, Vertex hay Foundry, lớp bảo vệ này không áp dụng; hãy dùng kiểm soát mạng của nền tảng đó.

Cần làm gì

  1. Liệt kê mọi địa chỉ IP public mà traffic tới Claude đi ra: server, CI, văn phòng, VPN, proxy, worker sandbox tự host, cả IPv4 lẫn IPv6.
  2. Vào Claude Console → Identity and access, bật IP allowlist, thêm các địa chỉ trên (kể cả mạng bạn đang dùng) rồi Save.
  3. Cân nhắc tuỳ chọn cho admin vào trang cài đặt từ mọi IP để tránh tự khoá mình. Đổi lại, phiên admin bị chiếm có thể sửa allowlist từ xa.
  4. Theo dõi lỗi 403 permission_error trong ứng dụng, kể cả job chỉ chạy hằng ngày hoặc hằng tuần, và bổ sung địa chỉ còn thiếu.
  5. Đừng thêm địa chỉ proxy dùng chung nếu không cần: ai có key lộ hoặc phiên đăng nhập bị đánh cắp vẫn có thể đi qua proxy đó.

Còn chưa rõ

Tính năng đang beta; tài liệu ghi cài đặt và hành vi có thể thay đổi trong giai đoạn này. Release notes không nhắc tới chi phí riêng cho tính năng.

Nguồn

  1. Claude Platform release notes — Anthropic
  2. IP allowlisting — Anthropic