auth

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

• passport.google
• passport.twitter
• passport.github
• passport.facebook
• et al

License

MIT

Maintained By

• Travis Webb
• Ryan Quinn
• Contributors