รายการอนุญาต IP

รายการอนุญาต IP

คุณสามารถตั้งค่ารายการอนุญาต IP แยกสำหรับคีย์ API แต่ละรายการ เพื่อให้เฉพาะคำขอจาก IP ต้นทางที่กำหนดเท่านั้นที่ใช้คีย์นั้นได้

เหมาะใช้เมื่อใด

เหมาะสำหรับการใช้งานบนเซิร์ฟเวอร์ production ที่มี IP ขาออกแบบคงที่ หากแอปส่งคำขอจากเครือข่ายบ้าน เครือข่ายมือถือ หรือที่อยู่ที่เปลี่ยนแปลงได้ โปรดตรวจสอบว่า IP ขาออกคงที่ก่อน มิฉะนั้นคุณอาจล็อกตัวเองออก

วิธีตั้งค่า

เปิด /keys จากนั้นเปิดเมนู "⋯" ของคีย์ที่ต้องการ เลือก "รายการอนุญาต IP" ใส่รายการ แล้วบันทึก

หรือใช้ PATCH /api/v1/keys/:id ด้วย session ที่เข้าสู่ระบบแล้วหรือ 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": []}

รูปแบบรายการ

ใน UI ให้ใส่หนึ่งค่าต่อบรรทัด ส่วน API ให้ส่งค่าเดียวกันในอาร์เรย์ `allowedCidrs` รองรับ IPv4 แบบไม่ระบุ CIDR, IPv4 CIDR หรือ IPv6 literal (เทียบข้อความแบบตรงกันเท่านั้น)

203.0.113.7
198.51.100.0/24
2001:db8::1

การทำงาน

เว้นว่าง (ส่งอาร์เรย์ [] ที่ว่างเปล่า) หมายถึงไม่จำกัด IP ต้นทาง นี่คือค่าเริ่มต้น พฤติกรรมของคีย์ที่มีอยู่จึงไม่เปลี่ยนแปลง

ระบบอ่าน IP ต้นทางจาก header `cf-connecting-ip`

หากรายการไม่ว่างแต่ไม่สามารถระบุ IP ต้นทางได้ คำขอจะถูกปฏิเสธ (fail-closed)