Passport strategy for authenticating with Civic
This module lets you authenticate using Civic in your Node.js applications. By plugging into Passport, Civic authentication can be easily and unobtrusively integrated into any application or framework that supports Connect-style middleware, including Express.
$ npm install passport-civic
The Civic authentication strategy authenticates users using a Civic
app. The strategy requires a verify
callback, which
accepts these credentials and calls done
providing a user, as well as
options
specifying a appId, prvKey, and appSecret.
passport.use(new CivicStrategy({
appId: APP_ID,
prvKey: PRIVATE_KEY,
appSecret: "Something-secret"
},
function(profile, done) {
User.findOrCreate({ civicId: profile.userId }, function (err, user) {
return done(err, user);
});
}
));
The verify callback can be supplied with the request
object by setting
the passReqToCallback
option to true, and changing callback arguments
accordingly.
passport.use(new CivicStrategy({
appId: APP_ID,
prvKey: PRIVATE_KEY,
appSecret: "Something-secret"
passReqToCallback: true
},
function(req, profile, done) {
// request object is now first argument
// ...
}
));
Use passport.authenticate()
, specifying the 'civic'
strategy, to
authenticate requests.
For example, as route middleware in an Express application:
app.get('/auth/civic',
passport.authenticate('civic'));
app.get('/auth/civic',
passport.authenticate('civic', { failureRedirect: '/login' }),
function(req, res) {
// Successful authentication, redirect home.
res.redirect('/');
});