Skip to Content

auth.ts

app/auth.ts bật đăng nhập cho app bằng vài dòng cấu hình. Từ đó manh.run sinh bảng người dùng, API đăng nhập và trang quản lý người dùng.

app/ ├── auth.ts # vai trò, cách đăng ký, Google ├── users/users.table.ts # [sinh sẵn] bảng người dùng └── shared/auth-roles.ts # [sinh sẵn] ROLES, ADMIN_ROLE, ROLE_LABELS…

Vai trò

Đăng nhập là cấu hình, không phải code bạn viết. Có file này thì mọi request mang token hợp lệ có user = { id, name, email, role, avatarUrl }, và mọi handler cần người đã đăng nhập, trừ khi access là "public".

manh.run chỉ đọc file này chứ không chạy nó, nên chỉ dùng giá trị viết thẳng.

Export

default là một object:

  • roles: danh sách vai trò. Vai trò đứng đầu quản lý người dùng. Vai trò này chỉ đến với tài khoản đầu tiên đăng ký từ bản xem trước trong không gian làm việc của chủ project, khi app chưa có ai giữ vai trò đó. Trên app đã deploy, người đăng ký luôn nhận defaultRole, nên người lạ không thể đăng ký trước để chiếm quyền admin.
  • defaultRole: vai trò của mọi người đăng ký còn lại.
  • signup: "open" (ai cũng đăng ký được) hoặc "closed" (chỉ admin đầu tiên tự đăng ký từ bản xem trước; các tài khoản khác do admin tạo).
  • providers (tuỳ chọn): ["google"] để thêm nút đăng nhập bằng Google. Starter đăng nhập đã ghi sẵn dòng này; chỉ bỏ khi chủ app muốn dùng mật khẩu thôi.
  • labels (tuỳ chọn): tên vai trò hiện trên màn hình, ví dụ { owner: "Chủ tiệm", technician: "Kỹ thuật viên" }. Vai trò phổ biến (admin, manager, staff, cashier…) đã có tên tiếng Việt sẵn.
  • profile (tuỳ chọn): trường thêm của người dùng, ví dụ { branchId: "int", phone: "text" }; kiểu int, text, real, bool, tối đa 12 trường.

Ví dụ

app/auth.ts
export default { roles: ["admin", "manager", "staff"], defaultRole: "staff", signup: "closed", providers: ["google"], labels: { manager: "Quản lý cửa hàng" }, profile: { branchId: "int" }, };

Những gì manh.run sinh ra:

  • API POST /api/auth/login, POST /api/auth/register (trả { token, user }), GET /api/auth/me, GET/PATCH /api/auth/profile (người dùng tự sửa tên, ảnh đại diện), POST /api/auth/password (tự đổi mật khẩu), GET /api/auth/providers, GET /api/users/members, và GET /api/users, POST /api/users, PATCH /api/users/:id cho vai trò đứng đầu.
  • Bảng app/users/users.table.ts với cột id, email, passwordHash, name, role, active, avatarUrl, createdAt cộng các trường profile.
  • app/shared/auth-roles.ts với ROLES, ADMIN_ROLE, DEFAULT_ROLE, SIGNUP, PROFILE_FIELDS, ROLE_LABELS.

GET /api/users/members trả một mảng người dùng đang hoạt động cho mọi người đã đăng nhập, dùng cho ô chọn người phụ trách. Trường hồ sơ dạng chữ (số điện thoại…) không có trong đó.

Cần biết

  • Đuôi phải là .ts. app/auth.tsx bị bỏ qua, check báo config.wrong-extension. Cấu hình sai dạng: auth.config-invalid.
  • Vai trò trong access phải có trong roles, nếu không check báo access.unknown-role.
  • Nhập sai mật khẩu 5 lần cho một email, hoặc 30 lần từ một IP, trong 15 phút thì POST /api/auth/login trả 429 TOO_MANY_ATTEMPTS. Email không tồn tại cũng mất thời gian như sai mật khẩu, nên câu trả lời không lộ email nào có trong app.
  • Với signup: "closed", trang /users của starter có nút Thêm tài khoản: chủ app tạo tài khoản cho từng nhân viên ở đó. Khi dùng Google, chỉ email admin đã thêm mới vào được.
  • Muốn thử từng vai trò trước khi bàn giao, agent dùng create_test_accounts rồi remove_test_accounts. Không nâng quyền một tài khoản bằng SQL.
  • Muốn đổi một phần sinh sẵn, viết file của bạn đúng đường dẫn đó; file trong project được ưu tiên. Giữ nguyên các cột sinh sẵn.
  • Không dùng manh/oauth hay session bằng cookie. Token là JWT gửi trong header Authorization.

Bước tiếp theo

Cập nhật