Skip to Content

Dữ liệu và bảo mật

Dữ liệu app nằm trong database SQLite riêng, secret chỉ đọc được trên server, và nội dung app không chạy trên địa chỉ của bảng điều khiển. Trang này cho biết dữ liệu của bạn và của người dùng app (khách của tiệm spa, nhân viên kho…) nằm ở đâu, ai đọc được.

Database riêng của từng app

Mỗi app có một database SQLite riêng do manh.run vận hành, đặt ngay cạnh code server của app. Không app nào đọc được database của app khác.

  • Truy vấn chạy ngay trong tiến trình của app, không qua mạng.
  • Các request của một app chạy lần lượt, nên thao tác “đọc rồi ghi” (kiểm tồn kho rồi trừ kho) không bị request khác chen vào giữa.
  • File người dùng tải lên nằm trong kho file riêng của app (manh/blob).

Bạn xem dữ liệu ở mục Cơ sở dữ liệu › Bảng của project, còn agent truy vấn qua tool db_query.

Quay lại bản cũ và dữ liệu

manh.run không giữ bản sao lưu database của app. Mọi lệnh sửa, xoá dữ liệu, dù do bạn hay agent chạy, đều không hoàn tác được. Trước khi thay đổi lớn, hãy xuất bảng quan trọng ra CSV ở Cơ sở dữ liệu › Bảng và dặn agent đọc lại dữ liệu trước khi sửa hay xoá.

Quay lại một bản deploy cũ chỉ đổi code, dữ liệu vẫn giữ nguyên.

Code thì manh.run lưu riêng. Checkpoint có đặt tên không bao giờ bị tự xoá, tối đa 100 checkpoint. Trước mỗi lần sửa hay xoá file, manh.run tự lưu một bản và giữ 10 bản tự lưu gần nhất. Muốn quay lại code cũ, bạn khôi phục checkpoint rồi deploy.

Secret của app

Secret (API key, token của hệ thống khác) không bao giờ nằm trong file của app. Bạn đặt secret ở trang Secret của project (thanh bên, nhóm Kết nối), còn code server đọc secret qua env.

app/payments/post.ts
import { env } from "manh/env"; export default async function handler(c) { const r = await fetch("https://pay.example.com/charge", { method: "POST", headers: { authorization: `Bearer ${env.PAY_TOKEN}` }, // không ghi key vào code // … }); return r.json(); }
  • manh.run mã hoá secret khi lưu (AES-256-GCM). Không tool nào trả lại giá trị, agent chỉ thấy tên secret.
  • Đổi secret có hiệu lực ngay, không cần deploy lại.
  • env chỉ có trên server. File .tsx nào import manh/env sẽ bị check chặn.
  • check chặn chuỗi trông giống API key thật trong code (code.hardcoded-secret).

Khoá của manh.run không vào code app

Ở lần deploy đầu, manh.run tạo một JWT_SECRET ngẫu nhiên dành riêng cho app. App dùng khoá này để ký và kiểm tra token đăng nhập.

Khoá của dịch vụ AI và email thì khác. Các khoá này chỉ nằm trên hạ tầng của manh.run, không bao giờ vào code của app. manh/openai và manh/email gọi qua một cổng trung gian bằng token riêng của từng project. Code nào đọc tên dành riêng như env.OPENAI_API_KEY sẽ bị check chặn (code.no-reserved-env) và nhận undefined khi chạy.

Đăng nhập trong app

App tự xử lý đăng nhập bằng email/mật khẩu + JWT, gồm bảng users, POST /auth/register và POST /auth/login trả về JWT. Giao diện lưu token và gửi kèm header Authorization: Bearer <jwt>, middleware kiểm tra token trên server.

app/auth/login/post.ts
import { sign } from "hono/jwt"; import { env } from "manh/env"; // … const token = await sign({ sub: user.id, role: user.role, exp }, env.JWT_SECRET!, "HS256"); return { token, user: { id: user.id, name: user.name, role: user.role } };

Đăng nhập bằng Google bật sẵn trong khối auth (providers: ["google"] trong app/auth.ts); bỏ dòng đó nếu chỉ muốn dùng mật khẩu. manh.run lo phần chuyển hướng sang Google và trả về cho app một JWT như đăng nhập bằng mật khẩu, nên app không cần tự đăng ký OAuth hay giữ client secret. Chưa có GitHub hay nhà cung cấp khác.

Cần biết

  • Kiểm quyền và lọc dữ liệu theo người dùng phải làm trên server. Ẩn nút trên giao diện chỉ giúp người dùng đỡ bấm nhầm.
  • Không bao giờ trả passwordHash trong API, kể cả API “danh sách người dùng”.
  • verify và sign của hono/jwt cần tham số thuật toán "HS256". Thiếu tham số này thì mọi request đều bị từ chối (code.jwt-verify-alg).

Nội dung app tách khỏi bảng điều khiển

App chạy ở tên miền con của riêng nó, <id>.manh.run. Địa chỉ manh.run của bảng điều khiển không bao giờ trả về HTML, JavaScript hay file của app.

  • Bản chạy thử trong không gian làm việc cũng chạy trên tên miền con của app, không chạy trên bảng điều khiển.
  • App không nhúng được trang của bảng điều khiển vào khung của mình.
  • Mọi thao tác ghi tới API của bảng điều khiển phải xuất phát từ chính bảng điều khiển.

Nhờ vậy, code app do agent viết không thể thao tác trên tài khoản manh.run của bạn.

Chính sách dữ liệu

Chính sách quyền riêng tư và Điều khoản dịch vụ là văn bản có giá trị ràng buộc. Các điểm chính:

  • Với dữ liệu trong app bạn deploy, bạn là bên kiểm soát dữ liệu, còn manh.run là bên xử lý theo chỉ dẫn của bạn.
  • manh.run không bán dữ liệu cá nhân, không chạy quảng cáo hay công cụ theo dõi, và không dùng dữ liệu của bạn để huấn luyện AI.
  • manh.run không có AI riêng: khi bạn dùng agent, manh.run chỉ nhận các lệnh gọi tool, không nhận lịch sử hội thoại.
  • manh.run mã hoá dữ liệu khi truyền (HTTPS) và khi lưu.
  • manh.run giữ database của app tới khi bạn xoá project, và xoá tài khoản trong vòng 30 ngày kể từ khi bạn yêu cầu.
  • Bạn vẫn nên tự giữ bản sao của dữ liệu quan trọng.

Bước tiếp theo

Cập nhật