UI Secrets manager trong Backend cho API key
Secrets manager

DINHDANH Creator · Bài K07 · Kỹ thuật

Secrets &
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

Tab Backend → Secrets manager → Thêm secret
→ Tên key (không dấu tiếng Việt) + Giá trị secret → thông báo Đã lưu secret thành công
Trang admin (đã đăng nhập)
→ appifio_client.appifio_executeBackendFunction('sendMail', params)
Sandbox Node - backend/functions/*.js
→ 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)
❌ Guest: executeBackendFunction bị chặn · ❌ Client: readFsFile backend/secrets/…

2. Thuật ngữ

Thuật ngữNghĩa
Secrets managerKhu 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
executeBackendFunctionGọi handler Node trong backend/functions/ từ trang - guest thường bị chặn
appifio.secrets.getHà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ìnhKhô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

  1. Mở tab Backend → mục Secrets manager → nhấn Thêm secret.
  2. Đ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.
  3. 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).
  4. Yêu cầu AI viết backend/functions/myHandler.js dùng appifio.secrets.get('TÊN_KEY') bên trong handler.
  5. Từ trang admin, gọi executeBackendFunction để test - không in secret ra HTML hay console.log.
  6. 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/*.secret khỏ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ốngXử 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ộ secretTừ chối patch; nhắc AI chỉ dùng secrets.get trong backend/functions
Function trả 401 từ guestGọ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ụcGiớ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

  1. Bạn thêm được secret và thấy thông báo Đã lưu secret thành công?
  2. Bạn hiểu vì sao guest không gọi executeBackendFunction?
  3. 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.

DINHDANH Creator · Bộ hướng dẫn người dùng · K07 · Tham chiếu F04, T06, X06