@cqrs-ddd/pipeline-casl
Εξουσιοδότηση λεπτομερούς ελέγχου βάσει χαρακτηριστικών (ABAC) και ρόλων (RBAC) χρησιμοποιώντας το CASL.
Επιβάλλει μοντέλο άμυνας σε βάθος δύο επιπέδων (two-tier defense-in-depth):
- Εξουσιοδότηση σε επίπεδο τύπου (Type-Level Outer Gate): Το
CaslBehaviorαξιολογεί στατικά δικαιώματα πριν την εκτέλεση της λειτουργίας (π.χ. Μπορεί ο χρήστης να εκτελέσει τοDeleteUserCommand;), αποφεύγοντας περιττά queries στη βάση. - Εξουσιοδότηση οντότητας & πεδίων (Entity & Field Inner Gate): Το
CaslAuthorizerαξιολογεί λεπτομερείς κανόνες πάνω σε ενυδατωμένα (hydrated) domain aggregates εντός του handler (π.χ. Μπορεί ο χρήστης να ενημερώσει το συγκεκριμένο άρθρο ότανauthorId !== currentUserId;) και προβάλλει μόνο αναγνώσιμα πεδία.
Εγκατάσταση
Ενότητα με τίτλο «Εγκατάσταση»Απαιτεί Node.js 22.12 ή νεότερο και @casl/ability 7.
Αρχιτεκτονική & Ροή εξουσιοδότησης
Ενότητα με τίτλο «Αρχιτεκτονική & Ροή εξουσιοδότησης»Γρήγορο παράδειγμα
Ενότητα με τίτλο «Γρήγορο παράδειγμα»Μορφή Capability & Παρεμβολή συνθηκών (Interpolation)
Ενότητα με τίτλο «Μορφή Capability & Παρεμβολή συνθηκών (Interpolation)»Η πηγή δικαιωμάτων φορτώνει κανόνες ως αντικείμενα Capability. Για συμπαγή αποθήκευση στη βάση ή claims σε JWT, σειριοποιήστε τα ως capability strings:
| Capability String | Action | Subject | Conditions / Fields | Σημασία |
|---|---|---|---|---|
Post|read|* |
read |
Post |
Wildcard | Μπορεί να διαβάσει οποιοδήποτε post |
!Post|delete|* |
delete |
Post |
Inverted (!) |
Ρητή απαγόρευση διαγραφής posts |
Post|update|{"authorId":"${user.id}"}|title,body |
update |
Post |
${user.id} ταύτιση |
Ενημέρωση τίτλου και body μόνο σε δικά του posts |
all|manage|* |
manage |
all |
Wildcard | Superadmin: επιτρέπεται κάθε ενέργεια |
Placeholders της μορφής ${user.<field>} στις συνθήκες αντικαθίστανται αυτόματα από χαρακτηριστικά του ενεργού principal:
Έλεγχοι οντοτήτων και πεδίων (CaslAuthorizer)
Ενότητα με τίτλο «Έλεγχοι οντοτήτων και πεδίων (CaslAuthorizer)»Μέσα σε command ή query handlers, δημιουργήστε instance του CaslAuthorizer για να αξιολογήσετε κανόνες έναντι φορτωμένων οντοτήτων και να καθαρίσετε πεδία εξόδου:
Ασφάλεια & Διαχωρισμός Cache (abilityDigest)
Ενότητα με τίτλο «Ασφάλεια & Διαχωρισμός Cache (abilityDigest)»Όταν αποθηκεύετε αποτελέσματα query στην cache (@cqrs-ddd/pipeline-cache) ή εκτελείτε replay idempotent commands (@cqrs-ddd/pipeline-idempotency), οι απαντήσεις δεν πρέπει ποτέ να διαμοιράζονται μεταξύ διαφορετικών επιπέδων δικαιωμάτων.
Το abilityDigest(context) παράγει SHA-256 αποτύπωμα των κανόνων του καλούντος:
Ενσωμάτωση NestJS (@cqrs-ddd/nestjs)
Ενότητα με τίτλο «Ενσωμάτωση NestJS (@cqrs-ddd/nestjs)»Καταχωρίστε το CaslBehavior σε ένα shared security module:
Διακοσμήστε handlers με requires:
Το ErrorFilter μετατρέπει αυτόματα το UnauthorizedActionException σε HTTP 403 Forbidden.
Σειρά των behaviors
Ενότητα με τίτλο «Σειρά των behaviors»Τοποθετήστε το CaslBehavior πριν από behaviors cache και idempotency:
ZodValidationBehavior: Επικυρώνει το input.CaslBehavior: Ελέγχει την εξουσιοδότηση.CacheBehavior/IdempotencyBehavior: Αξιολογεί short-circuit keys μέσωabilityDigest.