การจัดการ secrets
การจัดเก็บข้อมูลรับรองที่ปลอดภัย
เมื่อแอปพลิเคชันของคุณต้องการเชื่อมต่อกับบริการภายนอก เช่น การส่งอีเมลผ่าน SendGrid การประมวลผลการชำระเงินด้วย Stripe หรือการใช้ OpenAI สำหรับฟีเจอร์ AI คุณจะต้องจัดเก็บคีย์ API และข้อมูลรับรองอย่างปลอดภัย ระบบการจัดการ secrets ของ Kliv จัดการสิ่งนี้ให้โดยอัตโนมัติ
สิ่งที่ทำให้ secrets ปลอดภัย:
- จัดเก็บแบบเข้ารหัส ในฐานข้อมูล
- ไม่แสดงแบบเต็ม หลังจากที่คุณบันทึกแล้ว
- แทรกโดยอัตโนมัติ เข้าไปใน Edge Functions เมื่อจำเป็น
- ทั่วทั้งบัญชี ดังนั้นคุณจึงจัดเก็บแต่ละคีย์เพียงครั้งเดียว
- เส้นทางการตรวจสอบ ติดตามว่ามีการสร้างหรืออัปเดต secrets เมื่อใด
secrets ทำงานอย่างไร
เมื่อคุณบอก AI ว่าคุณต้องการผสานรวมกับบริการภายนอก AI จะขอข้อมูลรับรองที่จำเป็น เมื่อคุณระบุคีย์ API แล้ว AI จะจัดเก็บคีย์นั้นอย่างปลอดภัยด้วยชื่อที่สื่อความหมาย (เช่น OPENAI_API_KEY หรือ STRIPE_SECRET_KEY) จากนั้นเป็นต้นไป Edge Function ใดๆ ที่ต้องการข้อมูลรับรองนั้นก็จะสามารถเข้าถึงได้โดยอัตโนมัติ
การแสดงผลแบบปกปิด: หลังจากบันทึก secret แล้ว คุณจะเห็นเฉพาะเวอร์ชันที่ถูกปกปิดบางส่วนใน UI ผู้ดูแลระบบ ตัวอย่างเช่น sk-proj-abc123xyz789 จะปรากฏเป็น sk-p****9789 วิธีนี้ช่วยให้คุณตรวจสอบได้ว่าคีย์ใดเป็นคีย์ใดโดยไม่ต้องเปิดเผยค่าทั้งหมด
การแทรกอัตโนมัติ: เมื่อ edge function ทำงาน secrets ที่ฟังก์ชันอ้างอิงจะถูกแทรกเข้าไปอย่างปลอดภัยสำหรับการรันครั้งนั้น AI จะเขียนฟังก์ชันให้อ่านค่าเหล่านั้นผ่านอินเทอร์เฟซ secrets ของแพลตฟอร์ม และแพลตฟอร์มจะจัดหาค่าจริง ณ รันไทม์ — ดังนั้นคีย์ที่ถูกหมุนเวียนเปลี่ยนใหม่จะมีผลในการรันครั้งถัดไปของฟังก์ชัน
การจัดการ secrets
ผ่านอินเทอร์เฟซผู้ดูแลระบบ คุณสามารถ:
- ดู secrets ทั้งหมดของคุณ (พร้อมค่าที่ถูกปกปิด)
- เพิ่ม secrets ใหม่หรืออัปเดตรายการที่มีอยู่
- ลบ secrets ที่คุณไม่ต้องการอีกต่อไป
- ดูว่า secret แต่ละรายการถูกสร้างขึ้นหรืออัปเดตครั้งล่าสุดเมื่อใด
AI ยังสามารถสร้างและอัปเดต secrets ให้คุณได้เมื่อคุณอธิบายการผสานรวมที่คุณต้องการสร้าง
การใช้งานทั่วไปสำหรับ secrets
- บริการอีเมล: ข้อมูลรับรองของ SendGrid, Mailgun หรือ SMTP
- การประมวลผลการชำระเงิน: คีย์ API ของ Stripe, PayPal หรือบริการชำระเงินอื่นๆ
- บริการ AI: คีย์ API ของ OpenAI, Anthropic หรือ Google
- SMS/การโทร: token การตรวจสอบสิทธิ์ของ Twilio
- API ภายนอก: บริการของบุคคลที่สามใดๆ ที่แอปของคุณผสานรวมด้วย
- Webhooks: signing secrets สำหรับการตรวจสอบ webhooks ที่เข้ามา
- การเชื่อมต่อฐานข้อมูล: สตริงการเชื่อมต่อสำหรับฐานข้อมูลภายนอก
แนวทางปฏิบัติที่ดีที่สุด
✅ ใช้ชื่อที่สื่อความหมาย - ตั้งชื่อ secrets ให้ชัดเจน เช่น SENDGRID_API_KEY แทนที่จะเป็น key1 หรือ secret
✅ หมุนเวียนเป็นประจำ - อัปเดต secrets เป็นระยะ โดยเฉพาะสำหรับบริการที่สำคัญ
✅ ลบเมื่อไม่ใช้แล้ว - ลบ secrets ของบริการที่คุณไม่ได้ใช้อีกต่อไป
❌ อย่าใช้ secrets ร่วมกัน - แต่ละสภาพแวดล้อม (ทดสอบ, การใช้งานจริง) ควรใช้คีย์ API ที่แตกต่างกัน
❌ อย่าคอมมิตลงในโค้ด - secrets ถูกจัดเก็บแยกจากโค้ดของคุณด้วยเหตุผลบางประการ อย่าใส่คีย์ API ลงในไฟล์ต้นฉบับของคุณโดยตรง
เอกสารที่เกี่ยวข้อง: