Secrets manager Backend với nút Add secret và tip appifio.secrets.get
Secrets manager

DINHDANH Creator · Bài AM07 · API REFERENCE §6 · 1 method (+ Secrets UI)

Hàm máy chủ
executeBackendFunction - đầy đủ cấu trúc

Chạy logic nhạy cảm phía máy chủ (gửi mail, đọc secret…) - không để chìa khóa lộ trên trang khách.

Method duy nhất §6

appifio_executeBackendFunction(functionName, params?)

Việc làm: Gọi một hàm đã lưu trong backend/functions/{tên}.js trên máy chủ.

Ai được gọi: Public khi chưa bật siết bảo mật CMS. Khi bật → cần đăng nhập quản trị (Admin+).

Tham số:

  • functionName - chỉ chữ/số/_/- (vd. sendMail, greetUser). Phải khớp tên file hàm.
  • params - object tuỳ chọn → trong handler đọc được qua appifio.params.

Cách gọi:

const res = await appifio_client.appifio_executeBackendFunction('sendMail', {
  to: 'khach@mail.com',
  subject: 'Xin chào'
});
if (res.success) {
  console.log(res.data.result);
  console.log(res.data.function_name, res.data.execution_time);
} else {
  alert(res.message || 'Hàm máy chủ lỗi');
}

Kết quả trả về:

{ success, data: {
  function_name: string,
  result: any,           // kết quả handler trả về
  execution_time: number // thời gian chạy
} }

Lưu ý:

  • Có giới hạn số lần gọi - không spam từ trang.
  • Chi tiết viết hàm + secrets: SECTION BACKEND FUNCTION & SECRETS trong TXT.
  • Khi CMS siết quyền: gọi sau validateAdminSession() (AM06).

Secrets trên UI (không phải method appifio_*)

  1. Tab Backend → Secrets manager → Thêm secret (đặt tên dễ nhớ).
  2. Trong handler máy chủ mới đọc được secret - không đọc file secret bằng readFsFile từ trang.

Khung file hàm (tạo bằng writeFsFile - AM04)

Không gian Files và Code để tạo file khung hàm backend
File hàm qua Files
// backend/functions/greetUser.js
exports.handler = async function (appifio) {
  const { name } = appifio.params || {};
  if (!name) return { success: false, error: 'Thiếu name' };
  // Secret (nếu cần): appifio.secrets.get('TEN_SECRET')
  return { success: true, message: 'Xin chào ' + name };
};

await appifio_client.appifio_writeFsFile(
  'backend/functions/greetUser.js',
  codeString
);
Không nhét mật khẩu SMTP / key thanh toán vào HTML trang - chỉ Secrets manager + hàm máy chủ.
Checklist §6: executeBackendFunction = 1/1 (+ quy trình Secrets UI)

AM08 - Helper đồng bộ (§7 - 5 hàm)

DINHDANH Creator · Loạt Method · AM07