Chuyển tới nội dung chính

Module Authorization (CASL)

Overview​

src/casl/ chứa enum vai trò, RolesGuard, decorator @Roles, và phần CASL (ma trận quyền, PoliciesGuard, @CheckPolicies). Vai trò và kết luận về quyền thực tế nằm ở user-roles; tài liệu này mô tả phần cài đặt.

Responsibilities​

Thành phầnFileCó hiệu lực trên route?
ERole, EActionenums/Có (kiểu dữ liệu)
RolesGuardroles.guard.tsCó, đăng ký toàn cục
@Roles(...)roles.decorator.tsCó, 41 route dùng
CaslAbilityFactorycasl-ability.factory.tsKhông, không nơi nào gọi createForUser ngoài module
PoliciesGuard, @CheckPoliciespolicies.guard.tsKhông, không controller nào dùng, không đăng ký toàn cục

Architecture​

RolesGuard đọc metadata ROLES_KEY từ handler và class bằng getAllAndOverride. Không có @Roles thì cho qua. Có thì so user.role với danh sách. Nó chạy sau JwtAuthGuard nên request.user đã có (app.setup.ts).

PoliciesGuard đọc CHECK_POLICIES_KEY, tạo Ability cho người dùng bằng CaslAbilityFactory rồi chạy từng handler. Cơ chế hoàn chỉnh, nhưng chưa được nối vào route nào.

Business Rules (ma trận CASL đã khai báo)​

Ma trận này không được thực thi, ghi lại để biết ý định thiết kế:

Chủ thể (ESubject)SUPER ADMINHRNORMAL USER
tất cảmanage——
Jobmanagecreate, read, update, deleteread
Companymanageread, updateread
Resumemanageread, update, deletecreate, read
CvProfile, Chat, Subscriber, Notification, Filemanagemanagemanage (CvProfile, Chat, Subscriber, Notification, File)
Statisticmanageread—

ESubject còn khai báo 'Role' và 'Permission' nhưng không có collection hay module tương ứng.

Known Limitation​

  • CASL không có tác dụng thực tế. Thêm hoặc sửa quy tắc trong CaslAbilityFactory không đổi quyền của bất kỳ route nào. Muốn dùng, phải gắn @UseGuards(PoliciesGuard) cùng @CheckPolicies(...) hoặc đăng ký guard toàn cục. Trạng thái: đã grep, xem user-roles.
  • Quy tắc sở hữu (HR chỉ sửa công ty mình) nằm rải rác trong service, không tập trung ở CASL.
  • src/roles/ chỉ còn thư mục rỗng sau khi entity Role bị bỏ, xem ADR-0002 và project-structure. ESubject còn giữ 'Role' và 'Permission' là dấu vết của cấu trúc đó.

Testing​

src/casl/ không có file test. RolesGuard không có test riêng và 4 kịch bản e2e hiện chưa kiểm tra @Roles (testing-strategy).

Source References​

src/casl/, app.setup.ts.