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ậndefaultRole, 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ểuint,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/:idcho vai trò đứng đầu. - Bảng
app/users/users.table.tsvới cộtid, email, passwordHash, name, role, active, avatarUrl, createdAtcộng các trườngprofile. app/shared/auth-roles.tsvớiROLES,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.tsxbị bỏ qua,checkbáoconfig.wrong-extension. Cấu hình sai dạng:auth.config-invalid. - Vai trò trong
accessphải có trongroles, nếu khôngcheckbáoaccess.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/logintrả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/userscủ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_accountsrồiremove_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/oauthhay session bằng cookie. Token là JWT gửi trong headerAuthorization.
Bước tiếp theo
- Đăng nhập và phân quyền — đặt
accesscho handler và hiện phiên đăng nhập trên giao diện. - Trang đăng nhập và đăng ký — dựng màn hình đăng nhập đúng kiểu sản phẩm thật.
- middleware.ts — khoá cả một thư mục API cho một vai trò.
Cập nhật