Tổng quan
Danh sách IP được phép là tính năng bảo mật tùy chọn, cho phép bạn giới hạn những địa chỉ IP có thể truy cập API OpenAI của bạn.
Khi tính năng này được bật, chỉ những yêu cầu từ các địa chỉ IP hoặc dải IP đã cấu hình mới được chấp nhận. Yêu cầu từ mọi IP khác đều bị từ chối, ngay cả khi có khóa API hợp lệ.
Tính năng này giúp giảm nguy cơ sử dụng API trái phép bằng cách chỉ cho phép truy cập từ các môi trường mạng đáng tin cậy.
Lưu ý: Danh sách IP được phép chỉ áp dụng cho các yêu cầu API. Tính năng này không ảnh hưởng đến việc truy cập platform.openai.com hay đăng nhập của người dùng.
Vì sao nên dùng danh sách IP được phép
Danh sách IP được phép có thể giúp bạn:
Chỉ cho phép truy cập API từ hạ tầng đã xác định (ví dụ: máy chủ hoặc môi trường đám mây của bạn)
Giảm rủi ro khi khóa API bị lộ
Bổ sung một lớp kiểm soát nguồn phát sinh lưu lượng API
Danh sách IP được phép thường được dùng nhất trong các môi trường vận hành thực tế, nơi lưu lượng API xuất phát từ các dải mạng cố định hoặc được xác định rõ ràng.
Cách hoạt động
Bạn cấu hình danh sách các địa chỉ IP hoặc dải CIDR được phép.
Yêu cầu từ các IP được phép sẽ được chấp nhận.
Yêu cầu từ các IP không nằm trong danh sách được phép sẽ bị từ chối.
Danh sách IP được phép có thể được áp dụng ở:
Cấp tổ chức, hoặc
Cấp dự án
Phạm vi cung cấp
Tất cả khách hàng sử dụng API đều có thể dùng danh sách IP được phép.
Để cấu hình danh sách IP được phép, hãy làm theo các bước bên dưới.
Cấu hình danh sách IP được phép
Lưu ý: Bạn có thể thêm tối đa 50 địa chỉ IP hoặc dải CIDR.
Mở Cài đặt.
Chọn Bảo mật.
Chọn Danh sách IP được phép.
Thêm một hoặc nhiều địa chỉ IP hoặc dải CIDR.
(Tùy chọn) Dùng công cụ Kiểm tra để xác minh một IP có nằm trong danh sách được phép của bạn hay không.
Bật danh sách IP được phép cho:
Một dự án cụ thể, hoặc
Toàn bộ tổ chức của bạn.
Thử gửi yêu cầu từ các môi trường bạn dự định sử dụng.
Chúng tôi khuyên bạn nên bắt đầu với một dự án trước khi áp dụng cho toàn bộ tổ chức.
Sau khi thay đổi, các cập nhật có thể mất tối đa 15 phút để có hiệu lực.
Lưu ý: Bạn phải có quyền phù hợp trong tổ chức để cấu hình danh sách IP được phép.
Khắc phục sự cố
Nếu yêu cầu gặp lỗi ngoài dự kiến:
Xác nhận rằng yêu cầu xuất phát từ một địa chỉ IP được phép.
Kiểm tra xem các địa chỉ IP trong hạ tầng của bạn có thay đổi hay không.
Kiểm tra lại độ chính xác của các dải IP đã cấu hình.
Chờ tối đa 15 phút để các thay đổi cấu hình được đồng bộ trên hệ thống.
Dùng công cụ Kiểm tra để xác minh một IP có được phép hay không.
Điều gì xảy ra khi một yêu cầu bị chặn
Nếu một yêu cầu xuất phát từ địa chỉ IP không nằm trong danh sách được phép, yêu cầu đó sẽ không thành công và trả về:
Trạng thái HTTP: 401 Unauthorized
Mã lỗi: ip_not_authorized
Ví dụ về phản hồi:
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
Câu hỏi thường gặp
Danh sách IP được phép có ngăn chặn mọi hành vi sử dụng trái phép khóa API của tôi không?
Không. Danh sách IP được phép có thể giúp giảm rủi ro bằng cách giới hạn nguồn gửi yêu cầu API, nhưng không ngăn chặn hoàn toàn mọi hình thức sử dụng sai mục đích. Bạn nên kết hợp tính năng này với các biện pháp bảo mật được khuyến nghị khác như lưu trữ khóa an toàn, thay khóa định kỳ và bảo mật tài khoản chặt chẽ. Để tăng cường bảo mật, hãy tham khảo các hướng dẫn trong trung tâm trợ giúp của chúng tôi về Các biện pháp tốt nhất để bảo vệ khóa API và Ngăn chặn việc sử dụng trái phép.
Danh sách IP được phép có ảnh hưởng đến độ trễ không?
Danh sách IP được phép có thể làm tăng độ trễ một chút trong một số trường hợp, thường là với các yêu cầu ban đầu. Dự kiến tính năng này sẽ không ảnh hưởng đáng kể đến hiệu năng tổng thể của API.
Làm sao biết một yêu cầu không thành công do danh sách IP được phép?
Các yêu cầu không thành công do danh sách IP được phép sẽ trả về:
HTTP status: 401 UnauthorizedError code: ip_not_authorized