Secrets manager trên Backend để giữ khóa dịch vụ
Secrets manager

DINHDANH Creator · Bài AS06 · Trung bình · Loạt Aura

Secrets & hàm máy chủ
(gửi mail / thanh toán…)

Giữ chìa khóa dịch vụ trong két (Secrets) - không dán vào trang HTML để khách xem mã nguồn là thấy.

Mục tiêu: Thêm secret đúng UI; nhờ AI gọi hàm máy chủ; không lộ key trên trình duyệt.

Thời lượng: ~14 phút · Trước: AS05, F04 · Sau: AS07

Secrets manager Thêm secret Backend Lưu thay đổi

1. Sơ đồ két bí mật

Key SMTP / thanh toán / API ngoài
→ Tab Backend → Secrets manager → Thêm secret
→ Trang admin nhấn “Gửi thử” / thanh toán
→ Máy chủ lấy secret phía sau - trình duyệt khách không thấy đủ giá trị

2. Thuật ngữ

Thuật ngữNghĩaNơi thấy
SecretGiá trị bí mật (mật khẩu API, token…)Secrets manager
Hàm máy chủViệc chạy phía sau (gửi mail…) dùng secret an toànTrang admin do AI tạo
Không hiện đủ giá trịUI có thể che bớt secret đã lưuDanh sách secrets

3. Các bước

  1. Tab Backend → Secrets manager → Thêm secret - đặt tên dễ nhớ (vd. SMTP_PASS) và dán giá trị.
  2. Lưu theo nút trên UI Secrets (không nhầm với toolbar).
  3. Mode Coder: “Trang admin có nút Gửi thử email - dùng secret tên … phía máy chủ; không in secret ra HTML.”
  4. Test trên bản Thay đổi khi đã đăng nhập quản trị → rồi Lưu thay đổi.
Sai phổ biến: Nhờ AI viết mật khẩu SMTP thẳng vào file trang → ai xem mã nguồn cũng lấy được.

3b. Hàm máy chủ chạy thế nào? (SECTION BACKEND FUNCTION)

Trang admin (đã đăng nhập) → gọi tên hàm (vd. gửi mail thử)
→ Máy chủ chạy file trong thư mục backend/functions/
→ Hàm đọc secret từ két (không lộ ra trình duyệt)
→ Trả kết quả JSON về trang
  • File hàm do AI tạo/sửa trong kho file trang (cần quyền quản trị) - bạn không dán secret vào file hàm.
  • Mỗi lần gọi có giới hạn thời gian / kích thước (sandbox) - chi tiết Coder: AM07.
  • Gọi hàm cũng có “Thử lại sau” riêng nếu spam - đừng bấm liên tục khi lỗi.
  • Nếu bật bảo mật CMS chặt: khách có thể bị từ chối gọi hàm - chỉ để trên trang admin (AS11).

Tên secret trên UI phải khớp tên hàm đọc (thường chữ HOA + gạch dưới). Sai tên = không đọc được dù đã Thêm secret.

4. So sánh

  • Vercel / Netlify env: cùng ý “biến môi trường” - DINHDANH đặt trong Secrets manager.
  • Bubble API Connector keys: tương tự két riêng, không lộ UI khách.

5. Giới hạn & bảo mật

Làm được

  • Mail, webhook, thanh toán an toàn hơn
  • Đổi secret không sửa HTML

Không

  • Không nhờ AI lộ secret ra console trang
  • Không share màn hình Secrets công khai

6. Vấn đề thường gặp

Tình huốngXử lý
Gửi mail thất bạiĐúng tên secret? Còn hạn key nhà cung cấp?
Khách bấm được nút gửi mailChỉ để sau đăng nhập quản trị; kiểm tra quyền trang

7. Checklist

  1. Secret nằm trong Secrets manager, không trong HTML?
  2. Nút dùng secret chỉ dành cho quản trị?

Nhóm tiếp theo · CMS

AS07 - Mở CMS lần đầu & tài khoản chủ

DINHDANH Creator · Loạt Aura · AS06