Authentication
Customer endpoints ที่ต้องยืนยันตัวตนรับ Prism API key ผ่าน Bearer token:
Prism ไม่รองรับ X-API-Key สำหรับ customer authentication ตัวอย่างและ
integration ใหม่ต้องใช้ Authorization: Bearer เท่านั้น
วงจรชีวิตของ key
- สร้าง key ใน developer console
- เก็บ full secret ทันที เพราะระบบแสดงเพียงครั้งเดียว
- ส่ง key จาก trusted server environment เท่านั้น
- สร้าง key ใหม่และ deploy ก่อนหมุนเวียน key ที่ใช้งานอยู่
- Revoke key เก่าหลัง integration เปลี่ยนเสร็จ
Prism เก็บ one-way hash และ lookup prefix ไม่สามารถกู้ full secret จาก console
หรือ database ได้
Policy ของ key
การใช้งาน key อาจถูกจำกัดด้วย route scope, model allowlist, rate limit,
organization budget, เครดิตคงเหลือ และ trial policy
GET /v1/models จะแสดงเฉพาะโมเดลที่ key มองเห็น แต่ administrator อาจเปลี่ยน
policy ภายหลังได้
ตอนนี้ self-service organization offboarding ยังไม่ invalidate key เดิม
อัตโนมัติ ผู้ดูแลต้อง revoke key ของพนักงานที่ออกเอง
401 เมื่อ Bearer token หาย รูปแบบผิด ไม่รู้จัก หรือถูก revoke อย่า
retry 401 ด้วย key เดิม
English version