manacle
Manacle is a lightweight ACL implementation for Node.js and the browser.
Example
Create a new ACL:
var acl = manacle;
Define some rules:
var user = ... ; acl; if user acl; acl; if useradmin acl; if userblocked acl;
Check various rules:
var post = ... ; // `true` for users who are not blockedacl; // `true` for all users (the given post object is ignored// and unnecessary since there is no condition defined)acl; // `true` for users who are not blocked and either own// the post or are an adminacl;acl; // `true` (undefined rules are denied by default)acl;
Note that the order in which the rules are defined matters as each newly defined rule takes precedence over past rules.
Download
Releases are available on GitHub or via NPM.
npm install manacle
Development: manacle.js
Production: manacle.min.js
API
allow(actions, subjects, condition)
deny(actions, subjects, condition)
Allow (or deny) the specified action(s) and subject(s), optionally only if the given condition holds.
Arguments:
- actions - string or array of strings
- subjects - string or array of strings
- condition - function (optional)
allowed(action, subject, ...)
denied(action, subject, ...)
Check if the specified action(s) and subject(s) are allowed (or denied), optionally checking a condition against any extra arguments.
Arguments:
- action - string
- subject - string
- additional arguments passed to condition function