
DINHDANH Creator · Bài K07 · Kỹ thuật
Backend Function - không lộ key ra trình duyệt
Góc nhìn kỹ thuật cho người đã quen F04: lưu API key trong Secrets manager, gọi logic server qua executeBackendFunction, và bắt AI không hardcode secret vào HTML.
Mục tiêu bài học: Thao tác đúng UI Secrets manager, hiểu ranh giới client/server, và biết khi nào Diff từ chối patch lộ secret.
Thời lượng đọc: khoảng 14 phút
Điều kiện trước: F04 (Secrets cơ bản), T06 (Backend API key), K02 (Diff trước Lưu).
Bài trước → sau: K06 → K07 → K08
Nhãn UI chính: Secrets manager · Thêm secret · Sửa secret · Xóa secret · Tên key · Giá trị secret · Mô tả (tùy chọn)
1. Sơ đồ luồng secret
appifio_client.appifio_executeBackendFunction('sendMail', params)await appifio.secrets.get('SMTP_KEY') → gọi dịch vụ ngoài → trả kết quả (giá trị bí mật không hiện đầy đủ trên màn hình)2. Thuật ngữ
| Thuật ngữ | Nghĩa |
|---|---|
| Secrets manager | Khu vực quản lý key nhạy cảm trong tab Backend - chỉ role admin+ thao tác |
| Tên key | Định danh secret (vd. STRIPE_API_KEY) - chỉ chữ Anh, số, gạch dưới; không dấu tiếng Việt |
| executeBackendFunction | Gọi handler Node trong backend/functions/ từ trang - guest thường bị chặn |
| appifio.secrets.get | Hàm async đọc secret - chỉ hợp lệ bên trong backend/functions, không dùng ở frontend |
| Giá trị bí mật trên màn hình | Không hiện đủ giá trị bí mật khi trả về client - chỉ thấy dạng đã che |
3. Các bước thao tác UI
- Mở tab Backend → mục Secrets manager → nhấn Thêm secret.
- Điền Tên key, Giá trị secret, tuỳ chọn Mô tả (tùy chọn) → lưu. Thấy Đã lưu secret thành công.
- Nếu key có dấu tiếng Việt, UI báo lỗi key invalid - đổi sang tên Anh (vd.
MAIL_API_KEY). - Yêu cầu AI viết
backend/functions/myHandler.jsdùngappifio.secrets.get('TÊN_KEY')bên trong handler. - Từ trang admin, gọi
executeBackendFunctionđể test - không in secret ra HTML hayconsole.log. - Sửa giá trị: Sửa secret. Xóa hẳn: Xóa secret + xác nhận - không hoàn tác.
4. Giải thích tính năng Backend Function
Client gửi params, server giữ secret: Trang chỉ truyền dữ liệu công khai (email người nhận, số tiền…). Handler backend đọc key từ Secrets manager rồi gọi Stripe, SMTP, webhook…
Diff bảo vệ: Nếu AI đề xuất patch hardcode secret vào HTML/JS hoặc readFsFile('backend/secrets/…'), Diff từ chối (✗) - bạn phải sửa prompt hoặc chuyển logic sang backend/functions.
Tham chiếu sâu hơn: Khái niệm đầy đủ ở F04; cấu hình API key Backend ở T06; khi bị giới hạn gửi (thông báo “Thử lại sau”) xem X06.
5. So sánh với công cụ khác
- Vercel/Netlify env + Functions: cùng mô hình secret server-side; DINHDANH tích hợp sẵn trong Creator sandbox, không deploy riêng.
- Firebase Functions + Secret Manager: tương đương về phân tách; khác ở cách gọi từ trang qua
executeBackendFunction. - WordPress wp-config.php: thường lưu key chung file cấu hình; Aura tách file
backend/secrets/*.secretkhỏi mã client.
6. Giới hạn kỹ thuật
Làm được
- Logic Node tùy biến (mail, thanh toán, webhook)
- CRUD secret qua UI admin
- Test nhanh từ trang đã đăng nhập admin
Chưa làm được
- Guest gọi executeBackendFunction khi security enforce bật
- Đọc secret từ frontend dù mọi cách
- Cron/queue chạy nền dài hơi trong sandbox
7. Bảo mật
Chỉ backend/functions được dùng appifio.secrets.get và executeBackendFunction target - không copy secret vào comment, README, hay chat AI.
Guest bị chặn: Form công khai không gọi được function nhạy cảm - thiết kế luồng qua trang admin hoặc backend validate session trước.
8. Vấn đề thường gặp
| Tình huống | Xử lý |
|---|---|
| Key invalid / có dấu tiếng Việt | Đổi Tên key sang chữ Anh/số/gạch dưới (vd. API_KEY_VIET thay vì có dấu) |
| Diff ✗ vì lộ secret | Từ chối patch; nhắc AI chỉ dùng secrets.get trong backend/functions |
| Function trả 401 từ guest | Gọi từ trang admin đã validate session; xem F03/T06 |
| Thông báo gửi quá nhiều lần khi test liên tục | Giới hạn gửi riêng cho executeBackendFunction - đợi rồi thử lại (X06) |
9. Lời khuyên
- Prompt AI: “Gọi executeBackendFunction; dùng appifio.secrets.get chỉ trong backend/functions; không hiện đủ giá trị bí mật trên màn hình.”
- Đặt tên key theo UPPER_SNAKE_CASE - dễ grep và tránh nhầm với biến JS thường.
- Luôn review Diff trước Lưu thay đổi (K02) - đặc biệt khi AI vừa thêm integration mới.
- Rotate secret định kỳ: Sửa secret với giá trị mới, deploy function, rồi mới Xóa secret cũ.
- Một key một mục đích - tránh dùng chung STRIPE_KEY cho cả test và production trong cùng project.
10. Checklist tự kiểm
- Bạn thêm được secret và thấy thông báo Đã lưu secret thành công?
- Bạn hiểu vì sao guest không gọi executeBackendFunction?
- Bạn biết Diff sẽ từ chối nếu secret lọt vào HTML?
Bài tiếp theo
K08 - Soft delete · Hard delete · Restore
Quản lý file an toàn: xóa mềm có thể khôi phục, xóa vĩnh viễn một chiều - nhãn UI tiếng Việt từ D01.
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · Bộ hướng dẫn người dùng · K07 · Tham chiếu F04, T06, X06