{"_id":"passport-remember-me","_rev":"18-e3286c78f20918e7e7a8f6f68798e11e","name":"passport-remember-me","description":"Remember Me cookie authentication strategy for Passport.","dist-tags":{"latest":"0.0.1"},"versions":{"0.0.1":{"name":"passport-remember-me","version":"0.0.1","description":"Remember Me cookie authentication strategy for Passport.","keywords":["passport","cookie","persistent","rememberme","auth","authn","authentication"],"repository":{"type":"git","url":"git://github.com/jaredhanson/passport-remember-me.git"},"bugs":{"url":"http://github.com/jaredhanson/passport-remember-me/issues"},"author":{"name":"Jared Hanson","email":"jaredhanson@gmail.com","url":"http://www.jaredhanson.net/"},"licenses":[{"type":"MIT","url":"http://www.opensource.org/licenses/MIT"}],"main":"./lib","dependencies":{"pkginfo":"0.2.x","passport":"~0.1.1"},"devDependencies":{"mocha":"1.x.x","chai":"1.x.x"},"scripts":{"test":"NODE_PATH=./lib node_modules/.bin/mocha --reporter spec --require test/bootstrap/node test/*.test.js"},"engines":{"node":">= 0.4.0"},"readme":"# Passport-Remember Me\n\n[Passport](http://passportjs.org/) strategy for authenticating based on a\nremember me cookie.\n\nThis module lets you authenticate using a remember me cookie (aka persistent\nlogin) in your Node.js applications.  By plugging into Passport, remember me\nauthentication can be easily and unobtrusively integrated into any application\nor framework that supports [Connect](http://www.senchalabs.org/connect/)-style\nmiddleware, including [Express](http://expressjs.com/).\n\n## Install\n\n    $ npm install passport-remember-me\n\n## Usage\n\n#### Configure Strategy\n\nThe remember me authentication strategy authenticates users using a token stored\nin a remember me cookie.  The strategy requires a `verify` callback, which\nconsumes the token and calls `done` providing a user.\n\nThe strategy also requires an `issue` callback, which issues a new token.  For\nsecurity reasons, remember me tokens should be invalidated after being used.\nThe `issue` callback supplies a new token that will be stored in the cookie for\nnext use.\n\n    passport.use(new RememberMeStrategy(\n      function(token, done) {\n        Token.consume(token, function (err, user) {\n          if (err) { return done(err); }\n          if (!user) { return done(null, false); }\n          return done(null, user);\n        });\n      },\n      function(user, done) {\n        var token = utils.generateToken(64);\n        Token.save(token, { userId: user.id }, function(err) {\n          if (err) { return done(err); }\n          return done(null, token);\n        });\n      }\n    ));\n\n#### Authenticate Requests\n\nUse `passport.authenticate()`, specifying the `'remember-me'` strategy, to\nauthenticate requests.\n\nThis is typically used in an application's middleware stack, to log the user\nback in the next time they visit any page on your site.  For example:\n\n    app.configure(function() {\n      app.use(express.cookieParser());\n      app.use(express.bodyParser());\n      app.use(express.session({ secret: 'keyboard cat' }));\n      app.use(passport.initialize());\n      app.use(passport.session());\n      app.use(passport.authenticate('remember-me'));\n      app.use(app.router);\n    });\n    \nNote that `passport.session()` should be mounted *above* `remember-me`\nauthentication, so that tokens aren't exchanged for currently active login\nsessions.\n\n#### Setting the Remember Me Cookie\n\nIf the user enables \"remember me\" mode, an initial cookie should be set when\nthey login.\n\n    app.post('/login', \n      passport.authenticate('local', { failureRedirect: '/login', failureFlash: true }),\n      function(req, res, next) {\n        // issue a remember me cookie if the option was checked\n        if (!req.body.remember_me) { return next(); }\n    \n        var token = utils.generateToken(64);\n        Token.save(token, { userId: req.user.id }, function(err) {\n          if (err) { return done(err); }\n          res.cookie('remember_me', token, { path: '/', httpOnly: true, maxAge: 604800000 }); // 7 days\n          return next();\n        });\n      },\n      function(req, res) {\n        res.redirect('/');\n      });\n\n## Examples\n\nFor a complete, working example, refer to the [login example](https://github.com/jaredhanson/passport-remember-me/tree/master/examples/login).\n\n## Tests\n\n    $ npm install\n    $ make test\n\n[![Build Status](https://secure.travis-ci.org/jaredhanson/passport-remember-me.png)](http://travis-ci.org/jaredhanson/passport-remember-me)\n\n## Credits\n\n  - [Jared Hanson](http://github.com/jaredhanson)\n\n## License\n\n[The MIT License](http://opensource.org/licenses/MIT)\n\nCopyright (c) 2013 Jared Hanson <[http://jaredhanson.net/](http://jaredhanson.net/)>\n","_id":"passport-remember-me@0.0.1","dist":{"shasum":"0aa6095c82480f44619456aef363ccb929bc2bc3","tarball":"https://registry.npmjs.org/passport-remember-me/-/passport-remember-me-0.0.1.tgz","integrity":"sha512-hggqG9tdcVwSFaJly4ANroyHTcTDqN5rxlXtCUQXuMDDXS7a1kq2IRFvm6mBLjp+OfmaJJbsi5FyuJQ/dLCBCQ==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQC5M9QXNc4W+t+kTMfsxKGdACY8iZ2XYbEluYR08eQptAIhAO0oPD0ehrDpD/9up3oighGqYfeyesJ8t5Iwnc2o4yCi"}]},"_npmVersion":"1.1.62","_npmUser":{"name":"jaredhanson","email":"jaredhanson@gmail.com"},"maintainers":[{"name":"jaredhanson","email":"jaredhanson@gmail.com"}],"directories":{}}},"readme":"# Passport-Remember Me\n\n[Passport](http://passportjs.org/) strategy for authenticating based on a\nremember me cookie.\n\nThis module lets you authenticate using a remember me cookie (aka persistent\nlogin) in your Node.js applications.  By plugging into Passport, remember me\nauthentication can be easily and unobtrusively integrated into any application\nor framework that supports [Connect](http://www.senchalabs.org/connect/)-style\nmiddleware, including [Express](http://expressjs.com/).\n\n## Install\n\n    $ npm install passport-remember-me\n\n## Usage\n\n#### Configure Strategy\n\nThe remember me authentication strategy authenticates users using a token stored\nin a remember me cookie.  The strategy requires a `verify` callback, which\nconsumes the token and calls `done` providing a user.\n\nThe strategy also requires an `issue` callback, which issues a new token.  For\nsecurity reasons, remember me tokens should be invalidated after being used.\nThe `issue` callback supplies a new token that will be stored in the cookie for\nnext use.\n\n    passport.use(new RememberMeStrategy(\n      function(token, done) {\n        Token.consume(token, function (err, user) {\n          if (err) { return done(err); }\n          if (!user) { return done(null, false); }\n          return done(null, user);\n        });\n      },\n      function(user, done) {\n        var token = utils.generateToken(64);\n        Token.save(token, { userId: user.id }, function(err) {\n          if (err) { return done(err); }\n          return done(null, token);\n        });\n      }\n    ));\n\n#### Authenticate Requests\n\nUse `passport.authenticate()`, specifying the `'remember-me'` strategy, to\nauthenticate requests.\n\nThis is typically used in an application's middleware stack, to log the user\nback in the next time they visit any page on your site.  For example:\n\n    app.configure(function() {\n      app.use(express.cookieParser());\n      app.use(express.bodyParser());\n      app.use(express.session({ secret: 'keyboard cat' }));\n      app.use(passport.initialize());\n      app.use(passport.session());\n      app.use(passport.authenticate('remember-me'));\n      app.use(app.router);\n    });\n    \nNote that `passport.session()` should be mounted *above* `remember-me`\nauthentication, so that tokens aren't exchanged for currently active login\nsessions.\n\n#### Setting the Remember Me Cookie\n\nIf the user enables \"remember me\" mode, an initial cookie should be set when\nthey login.\n\n    app.post('/login', \n      passport.authenticate('local', { failureRedirect: '/login', failureFlash: true }),\n      function(req, res, next) {\n        // issue a remember me cookie if the option was checked\n        if (!req.body.remember_me) { return next(); }\n    \n        var token = utils.generateToken(64);\n        Token.save(token, { userId: req.user.id }, function(err) {\n          if (err) { return done(err); }\n          res.cookie('remember_me', token, { path: '/', httpOnly: true, maxAge: 604800000 }); // 7 days\n          return next();\n        });\n      },\n      function(req, res) {\n        res.redirect('/');\n      });\n\n## Examples\n\nFor a complete, working example, refer to the [login example](https://github.com/jaredhanson/passport-remember-me/tree/master/examples/login).\n\n## Tests\n\n    $ npm install\n    $ make test\n\n[![Build Status](https://secure.travis-ci.org/jaredhanson/passport-remember-me.png)](http://travis-ci.org/jaredhanson/passport-remember-me)\n\n## Credits\n\n  - [Jared Hanson](http://github.com/jaredhanson)\n\n## License\n\n[The MIT License](http://opensource.org/licenses/MIT)\n\nCopyright (c) 2013 Jared Hanson <[http://jaredhanson.net/](http://jaredhanson.net/)>\n","maintainers":[{"name":"jaredhanson","email":"jaredhanson@gmail.com"}],"time":{"modified":"2022-06-23T13:23:16.662Z","created":"2013-05-15T06:06:08.413Z","0.0.1":"2013-05-15T06:06:09.471Z"},"author":{"name":"Jared Hanson","email":"jaredhanson@gmail.com","url":"http://www.jaredhanson.net/"},"repository":{"type":"git","url":"git://github.com/jaredhanson/passport-remember-me.git"},"users":{"masanorinyo":true,"davidhalldor":true,"saidgeek":true,"theverve":true,"shieldax":true,"kulakowka":true,"intuitivcloud":true,"snowdream":true,"hoetmaaiers":true,"yusufcomert":true,"olehumborstad":true,"serge-nikitin":true,"maxblock":true}}