node package manager

sails-auth

auth

NPM version Build status Dependency Status

Passport-based User Authentication system for Sails.js applications.

Note: For comprehensive user account control with role-based permissioning, object ownership, and row-level security, see sails-permissions, which uses this project as a dependency.

1. Install

$ npm install sails-auth --save

This will install sails-auth as a Sails Hook. The Hook uses marlinspike to inject the relevant Controllers, Policies, etc into your Sails application.

2. Configure

config/passport.js

By default, the local and basic strategies are enabled. See config/passport.js for examples of how to add and configure additional authentication strategies.

config/auth.js

  bcrypt: {
    /**
     * Specifiy number of salt rounds to perform on password. Values >10 are
     * slow.
     */
    rounds: 8
  }

3. Authenticate!

Create users as you normally would (POST to /user). Authenticate using the endpoint of the provider you've chosen.

/user/me

Returns User for this authenticated session.

Passport Protocols

License

MIT

Maintained By

Manage permissions for the whole team

Manage developer teams with varying permissions and multiple projects. Learn more about Private Packages and Organizations…

how? learn more

Collaborators list

Stats

Try it out

Keywords

sails, sails.js, authentication, auth, passport, oauth, oauth2, openid, passport.js, generator, google, facebook, twitter, linkedin, instagram, youtube

Dependencies (6)

bcryptjs, lodash, marlinspike, passport, passport-http, passport-local

Dependents (5)

sails-generate-sails-permissions-auth-browserify-multilayout, sails-hook-permit-actions, hashware-api, sails-permissions, sails-permissions-sequelize