
DINHDANH Creator · Bài F04 · Nâng cao
& Backend Function - không lộ secret
App cần gọi dịch vụ ngoài (email, thanh toán…) bằng API key riêng - key đó phải nằm trong Secrets manager, chỉ hàm chạy phía máy chủ (Backend Function) được đọc, khách trên trình duyệt không thấy đủ giá trị bí mật.
Mục tiêu bài học: Biết lưu secret đúng cách, gọi được Backend Function từ trang, và hiểu ranh giới rõ giữa code chạy trên trình duyệt và code chạy trên server.
Thời lượng đọc: khoảng 12 phút
Điều kiện trước: Đã hiểu API key backend (F01) và auth admin (F03).
1. Sơ đồ: ai chạy ở đâu
2. Thuật ngữ (bảng 3 cột)
| Thuật ngữ | Nghĩa | Nơi thấy trên UI |
|---|---|---|
| Secrets manager | Nơi lưu key nhạy cảm - chỉ Backend Function đọc được | Tab Backend |
| Thêm secret | Form nhập Tên key + Giá trị secret | Secrets manager |
| executeBackendFunction | Gọi hàm Node từ trang - params qua appifio.params | Code trang (AI viết) |
| Không hiện đủ giá trị bí mật | Sau Lưu secret, UI che bớt giá trị; function không trả secret thô | Danh sách Secrets + response function |
| Thử lại sau | Rate limit khi test function quá nhiều lần | Thông báo trên trang test |
3. Các bước thêm secret & viết backend function

- Mở tab "Backend" → mục "Secrets manager" → nhấn "Thêm secret".
- Điền "Tên key" (chỉ chữ Anh, số, gạch dưới - không dấu tiếng Việt, ví dụ
STRIPE_API_KEY) và "Giá trị secret", có thể thêm "Mô tả (tùy chọn)". - Sau khi Lưu, danh sách secret hiển thị tên key - giá trị không hiện đủ (che bớt). Đây là đúng thiết kế bảo mật.
- Yêu cầu AI viết file trong
backend/functions/(vd.sendMail.js) - bên trong handler gọiappifio.secrets.get('SMTP_KEY'), không trả secret thô ra ngoài. - Từ trang, gọi
await appifio_client.appifio_executeBackendFunction('sendMail', {'{'} to, subject {'}'}). - Gắn nút test tạm trên trang admin để kiểm tra function chạy đúng trước khi đưa vào luồng production thật.
4. So sánh với công cụ khác
- Vercel/Netlify Functions + env variables: cùng ý tưởng "serverless function + secret store", nhưng bạn phải tự deploy; ở đây chạy ngay trong sandbox Creator.
- Zapier/Make: nối API bên thứ 3 không cần code, nhưng khó tuỳ biến logic phức tạp như một hàm Node tự viết.
- WordPress plugin gọi API ngoài: thường lưu key trong wp-config hoặc DB không mã hoá; Aura tách riêng secrets khỏi dữ liệu app.
5. Giới hạn kỹ thuật
Làm được
- Chạy code Node tùy biến (gửi mail, tính phí, webhook…)
- Giữ secret tách biệt hoàn toàn khỏi mã nguồn client
- Test nhanh qua nút gắn tạm trên trang admin
Chưa làm được
- Không có UI xem log chi tiết từng lần chạy function như một nền tảng serverless chuyên dụng
- Giới hạn gửi riêng cho executeBackendFunction - cửa sổ chờ dài hơn thao tác thường, cần try/catch và hiện “Thử lại sau”
- Không chạy được tác vụ nền dài hơi (cron/queue) trong sandbox này
6. Bảo mật - nguyên tắc không thể phá
AI sinh code app chỉ được gọi appifio.secrets.get('KEY') bên trong file backend/functions/*.js.
Trang chạy production tuyệt đối không đọc trực tiếp thư mục backend/secrets/... từ trình duyệt - khách không có quyền đọc secret dưới bất kỳ hình thức nào.
- Handler backend không được hiện đủ giá trị bí mật trên màn hình khi trả về client - chỉ xác nhận đúng key, không hiện toàn bộ.
- Khi CMS Security enforce bật, khách chưa đăng nhập có thể bị từ chối gọi hàm nhạy cảm - cần gọi từ trang đã kiểm tra còn đăng nhập admin nếu function thuộc nhóm nhạy cảm.
- Đổi tên key secret không tự xoá secret cũ - kiểm tra kỹ trước khi đổi tên đang dùng trong code.
7. Vấn đề thường gặp
| Tình huống | Xử lý |
|---|---|
| "Tên key không được chứa ký tự tiếng Việt có dấu" | Đổi tên key chỉ dùng chữ Anh/số/gạch dưới, ví dụ MAIL_API_KEY |
| Function chạy nhưng trả lỗi 401 | CMS Security enforce đang chặn guest - gọi lại sau khi đăng nhập admin, hoặc chỉnh quyền trong Cài đặt bảo mật |
| Thông báo gửi quá nhiều lần khi test nhiều lần liên tiếp | Giới hạn gửi riêng cho executeBackendFunction - giảm tần suất test, đợi rồi thử lại |
8. Lời khuyên
- Đặt tên secret rõ nghĩa và viết mô tả - vài tháng sau bạn sẽ quên key nào dùng cho dịch vụ nào.
- Luôn yêu cầu AI thêm nút test riêng khi mới viết function, xoá hoặc ẩn nút đó khi đã public app cho khách.
- Không copy secret dán trực tiếp vào prompt chat công khai - chỉ nhập vào form Secrets manager.
9. Checklist tự kiểm
- Bạn biết secret chỉ đọc được trong backend/functions, không phải trong code client?
- Bạn biết vì sao handler không được hiện đủ giá trị bí mật trên màn hình?
- Bạn biết hệ thống có thể tạm chặn yêu cầu khi gọi executeBackendFunction quá nhiều lần?
Bài tiếp theo
F05 - Flat vs Indexed JSON
Tổng kết lại nguyên tắc chọn đúng kiểu lưu dữ liệu - tránh lỗi phổ biến nhất khi AI viết backend cho bạn.
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · Bộ hướng dẫn người dùng · F04 · Hàm máy chủ & Secrets