การจัดการ 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 ลงในไฟล์ต้นฉบับของคุณโดยตรง


เอกสารที่เกี่ยวข้อง: