colinshen / sails-permissions

Comprehensive user permissions and entitlements system for sails.js and Waterline. Supports user authentication with passport.js, role-based permissioning, object ownership, and row-level security.

-permissions

Comprehensive sails.js user permissions and entitlements system. Supports user authentication with passport.js, role-based permissioning, object ownership, and row-level security.

Install

$ npm install sails-permissions --save

Quickstart

Note: Complete documentation available in the sails-permissions wiki: https://github.com/tjwebb/sails-permissions/wiki

1. configure sailsrc

{
  "generators": {
    "modules": {
      "permissions-api": "sails-permissions"
    }
  }
}

2. run generator

$ sails generate permissions-api

3. Set environment variables

variable	description	default
ADMIN_USERNAME	admin username	admin
ADMIN_EMAIL	admin user email address	[e-mail]
ADMIN_PASSWORD	admin user password	admin1234

4. update configs

config/policies.js

  '*': [
    'basicAuth',
    'passport',
    'sessionAuth',
    'ModelPolicy',
    'AuditPolicy',
    'OwnerPolicy',
    'PermissionPolicy',
    'RolePolicy'
  ],

  AuthController: {
    '*': [ 'passport' ]
  }

License

MIT