Intercom authentication strategy for Passport.
npm install passport-intercomPassport strategy for authenticating
with Intercom using the OAuth 2.0 API.
This module lets you authenticate using Intercom in your Node.js applications.
By plugging into Passport, Intercom authentication can be easily and
unobtrusively integrated into any application or framework that supports
Connect-style middleware, including
Express.
``js`
$ npm install passport-intercom
#### Configure Strategy
The Intercom authentication strategy authenticates users using a Intercom
account and OAuth 2.0 tokens. The strategy requires a verify callback, whichdone
accepts these credentials and calls providing a user, as well asoptions specifying a client ID, client secret, and callback URL.
`js`
passport.use(new IntercomStrategy({
clientID: INTERCOM_CLIENT_ID,
clientSecret: INTERCOM_CLIENT_SECRET,
callbackURL: "http://localhost:3000/auth/intercom/callback"
},
function(accessToken, refreshToken, profile, done) {
User.findOrCreate({ intercomAdminId: profile.id }, function (err, user) {
return done(err, user);
});
}
));
#### Authenticate Requests
Use passport.authenticate(), specifying the 'intercom' strategy, to
authenticate requests.
For example, as route middleware in an Express
application:
`js
app.get('/auth/intercom',
passport.authenticate('intercom'));
app.get('/auth/intercom/callback',
passport.authenticate('intercom', { failureRedirect: '/login' }),
function(req, res) {
// Successful authentication, redirect home.
res.redirect('/');
});
`
For a complete, working example, refer to passport-intercom-example-app.
`bash``
$ npm install --dev
$ make test
Inspired by Jared Hanson's passport plugins.