Skip to content

Bảo mật & tiêu chuẩn ​

Mục này có hai phần khác nhau về bản chất, và tài liệu không trộn chúng:

  • Cái đã làm — đo được từ source, sinh tự động.
  • Cái được yêu cầu — tài liệu thiết kế bảo mật và NFR của dự án. Hai tài liệu đó là nguồn, không phải trang này.

Các trang trong mục ​

TrangNội dung
Danh mục kiểm soátTham số đọc từ hằng số code, giới hạn chống lạm dụng, bảng tổng hợp phòng thủ
Xác thực & phiênMật khẩu, token, thời hạn, thu hồi, challenge của Web Admin, bảng của luồng đăng nhập
Phân quyềnPhân tích toàn bộ luật: phạm vi, vai trò, maker/checker, MFA, luật đang từ chối
Dữ liệu cá nhânKiểm kê PII theo kiểu dữ liệu, che dữ liệu, đồng ý, legal hold, lưu giữ
AuditGhi gì, không ghi gì, vì sao không sửa được
Làm cứng tầng dữ liệusearch_path của hàm đặc quyền, role kết nối, trigger chốt chặn
Bí mật & khoáTên biến môi trường (không bao giờ giá trị), khoá ký nằm ở đâu
RLSLớp phòng thủ thứ hai, theo domain

Kiến trúc bảo mật nhiều lớp ​

Không lớp nào được tin một mình:

Internet1 · Giới hạn requestbody · độ sâu · selection · root field2 · Xác thựcJWT ES256 cục bộ · phiên còn sống3 · Phân quyềnvai trò × phạm vi · maker/checker · MFA4 · Sanitize đầu vàochạy SAU guard5 · Kiểm hợp lệZod theo từng operation6 · Quy tắc nghiệp vụservice7 · Ràng buộc databaseCHECK · khoá ngoại · transaction8 · RLSlớp phòng thủ thứ hai, role không bỏ qua được9 · Auditkhông gọi HTTPkhông rò chính sáchchỉ ghi thêmtừ chối ở đây

Ba điều đáng nói nhất:

Phân quyền đọc lại ở mỗi request. Token không chứa vai trò hay quyền; quyền hiệu lực là các grant còn sống của người gọi. Nên thu hồi quyền có hiệu lực ngay, không phải chờ token hết hạn.

Sanitize chạy sau guard. Người không có quyền luôn nhận unauthorized hoặc forbidden — họ không bao giờ thấy chi tiết chính sách lọc nội dung, và lượt truy cập bị từ chối vẫn để lại dòng audit.

RLS là lớp hai thật, không phải hình thức. Bốn role mà Edge Function dùng để kết nối database đều không bỏ qua RLS. Nếu một lỗi ở tầng API để lọt truy vấn, policy vẫn chặn.

Định danh ​

Danh tính là của PIDEAL, không dùng Supabase Auth. Mật khẩu băm PBKDF2-HMAC-SHA256; access token là JWT ES256 hạn ngắn mang kid nên khoá xoay được mà không đăng xuất ai; refresh token đục và đổi mới ở mỗi lần refresh, dùng lại thì phiên bị thu hồi.

Khoá ký riêng chỉ nằm trong Edge Function auth. Supabase cấp secret theo project, nên điều này do code và gate CI bảo đảm, không phải do nền tảng — một gate riêng kiểm rằng không function nào khác đọc khoá đó.

Nhân viên Web Admin là tài khoản STAFF riêng: đăng nhập trả về một challenge (đổi mật khẩu, rồi TOTP) trước khi có phiên. Web Admin không có tự đăng ký và không có đặt lại mật khẩu bằng OTP; mất quyền truy cập thì đi qua quy trình của người vận hành.

Giá trị cụ thể của mọi tham số: Danh mục kiểm soát.

Phân tách nhiệm vụ ​

Những thao tác có hệ quả đều cần hai người:

  • Thay đổi vai trò luôn là lệnh maker/checker, không bao giờ tự phục vụ. Ngoại lệ duy nhất là một grant hệ thống khi khách đăng ký User App.
  • Duyệt hoàn tiền, duyệt chính sách tài chính, duyệt phiếu điều chỉnh điểm — người duyệt phải khác người đề nghị.
  • "Khác người" so sánh con người, không so sánh id tài khoản: cùng số điện thoại cũng là cùng người. Điều này cần vì một nhân viên có thể vừa có tài khoản STAFF vừa có tài khoản khách hàng.
  • Hành động đặc quyền cần MFA bước hai, và grant bước hai gắn với đúng phiên, đúng hành động, dùng một lần trong transaction của lệnh đó.

Dữ liệu cá nhân ​

  • Số điện thoại chỉ hiện đầy đủ với người có quyền đọc PII; mặc định bị che ngay trong hàm database, không phải che ở tầng hiển thị.
  • Audit mask PII trước khi insert — dữ liệu chưa che không bao giờ được ghi.
  • Mật khẩu, OTP, token, chữ ký và secret MFA không bao giờ vào log, lỗi hay audit.
  • Có yêu cầu xuất và xoá dữ liệu, legal hold và chính sách lưu trữ. → Module Audit & Quyền riêng tư

Tiêu chuẩn của dự án ​

Hai tài liệu là nguồn chính thức, và tài liệu này không thay thế chúng:

Tài liệuNội dung
docs/sow/08-security.mdPD-08, 50 mục: nguyên tắc, phân loại dữ liệu, kiến trúc bảo mật, ranh giới tin cậy, luồng dữ liệu, mô hình đe doạ, sổ rủi ro, định danh, xác thực, phiên, MFA, mô hình phân quyền, RBAC
docs/sow/06-nfr.mdPD-06, 26 mục: toàn vẹn tài chính, toàn vẹn dữ liệu, bảo mật, quyền riêng tư, độ tin cậy, DR/BCP, hiệu suất, khả năng mở rộng, sẵn sàng, quan sát, bảo trì, tương thích, tiếp cận, i18n, tuân thủ và khả năng kiểm toán, SLO/SLI

Chưa có bảng đối chiếu từng mục yêu cầu với bằng chứng trong code. Đó là việc còn lại, và nó được khai ở Phạm vi & độ tin cậy chứ không bị bỏ qua im lặng. Trang Danh mục kiểm soát là phần đã làm được: mỗi kiểm soát kèm giá trị đo được và file nguồn để kiểm lại.


Nguồn: docs/sow/08-security.md, docs/sow/06-nfr.md, docs/technical/03-authentication.md, docs/contracts/api-conventions.md §14–15, docs/contracts/permission-matrix.md. Trang viết tay — xem mức độ tin cậy.

Sinh từ ad83b0aea · 820 migration · PostgreSQL 17