Quản lý secret
Lưu trữ thông tin xác thực an toàn
Khi ứng dụng của bạn cần kết nối với các dịch vụ bên ngoài — như gửi email qua SendGrid, xử lý thanh toán bằng Stripe hoặc sử dụng OpenAI cho các tính năng AI — bạn cần lưu trữ an toàn các khóa và thông tin đăng nhập API. Hệ thống quản lý secret của Kliv tự động xử lý việc này.
Điều gì làm cho secret được an toàn:
- Lưu trữ được mã hóa trong cơ sở dữ liệu
- Không bao giờ hiển thị đầy đủ sau khi bạn lưu chúng
- Tự động chèn vào các edge function khi cần
- Toàn tài khoản nên bạn chỉ lưu trữ mỗi khóa một lần
- Nhật ký kiểm toán theo dõi khi secret được tạo hoặc cập nhật
Secret hoạt động như thế nào
Khi bạn nói với AI rằng bạn muốn tích hợp với một dịch vụ bên ngoài, nó sẽ yêu cầu các thông tin xác thực cần thiết. Sau khi bạn cung cấp API key, AI sẽ lưu trữ khóa đó một cách an toàn bằng tên mô tả (như OPENAI_API_KEY hoặc STRIPE_SECRET_KEY). Từ đó trở đi, bất kỳ edge function nào cần thông tin xác thực đó đều có thể tự động truy cập vào nó.
Hiển thị dạng che: Sau khi lưu secret, bạn sẽ chỉ thấy phiên bản bị che một phần trong giao diện người dùng quản trị. Ví dụ, sk-proj-abc123xyz789 xuất hiện dưới dạng sk-p****9789. Điều này cho phép bạn xác minh khóa nào là khóa nào mà không hiển thị toàn bộ giá trị.
Tự động chèn: Khi một edge function chạy, các secret mà nó tham chiếu sẽ được chèn một cách an toàn cho lần chạy đó. AI viết hàm để đọc chúng thông qua giao diện secret của nền tảng, và nền tảng cung cấp giá trị thực tế vào thời gian chạy — vì vậy một khóa đã được xoay vòng sẽ có hiệu lực ở lần chạy tiếp theo của hàm.
Quản lý secret
Thông qua giao diện quản trị, bạn có thể:
- Xem tất cả secret của bạn (với các giá trị được che giấu)
- Thêm secret mới hoặc cập nhật secret hiện có
- Xóa những secret bạn không còn cần nữa
- Xem thời điểm mỗi secret được tạo hoặc cập nhật lần cuối
AI cũng có thể tạo và cập nhật các secret cho bạn khi bạn mô tả các tích hợp mà bạn muốn xây dựng.
Các cách dùng secret phổ biến
- Dịch vụ email: Thông tin xác thực SendGrid, Mailgun hoặc SMTP
- Xử lý thanh toán: Stripe, PayPal hoặc các API key thanh toán khác
- Dịch vụ AI: Khóa OpenAI, Anthropic hoặc Google API
- SMS/gọi điện: Auth token của Twilio
- API bên ngoài: Bất kỳ dịch vụ bên thứ ba nào mà ứng dụng của bạn tích hợp
- Webhook: Signing secret để xác minh webhook đến
- Kết nối cơ sở dữ liệu: Chuỗi kết nối cho cơ sở dữ liệu bên ngoài
Thực hành tốt nhất
✅ Dùng tên mô tả - Đặt tên secret rõ ràng như SENDGRID_API_KEY còn hơn là key1 hoặc secret.
✅ Xoay vòng khóa thường xuyên - Cập nhật secret định kỳ, đặc biệt đối với các dịch vụ quan trọng.
✅ Xóa khi hoàn tất - Xóa secret đối với các dịch vụ bạn không còn sử dụng.
❌ Không chia sẻ secret - Mỗi môi trường (test, production) nên sử dụng các API key khác nhau.
❌ Không đưa vào mã nguồn - Secret được lưu trữ riêng biệt với mã của bạn là có lý do. Không bao giờ đặt trực tiếp API key vào tệp nguồn của bạn.
Tài liệu liên quan: