Passport 身份验证中间件入门指南

祖筱泳

于 2024-08-15 09:40:32 发布

阅读量792

点赞数 9

本文链接：https://blog.csdn.net/gitblog_01111/article/details/141210443

版权

Passport 身份验证中间件入门指南

passportSimple, unobtrusive authentication for Node.js.项目地址:https://gitcode.com/gh_mirrors/pa/passport

项目介绍

Passport 是一个流行的 Node.js 框架，用于身份验证和授权。它通过一组插件（称为策略）支持多种认证方式，如用户名/密码、OAuth 和 OpenID 等。Passport 提供了强大的灵活性，允许开发者轻松地将认证机制集成到他们的应用程序中。

特性

支持多种认证协议。
可扩展性和灵活性高。
强大的社区支持，丰富的策略库。

项目快速启动

为了在你的项目中快速启用 Passport，遵循以下步骤：

初始化项目

首先，确保你的环境中有 Node.js 和 npm。然后创建一个新的目录作为你的项目根目录并运行 npm init 来初始化一个新的 Node.js 项目。
安装 Passport

在项目目录中，使用以下命令安装 Passport 核心包以及所需的身份验证策略，例如本地策略和 OAuth 策略。
```
npm install passport passport-local passport-oauth2 --save
```

配置 Express 应用

创建或编辑你的 Express 应用来引入 Passport 并设置相应的中间件。下面是一个基本的示例：

const express = require('express');
const session = require('express-session');
const passport = require('passport');
const LocalStrategy = require('passport-local').Strategy;

// 初始化Express应用
const app = express();

// 设置视图引擎和模板路径
app.set('views', './views');
app.set('view engine', 'ejs');

// 启用静态文件服务
app.use(express.static(__dirname + '/public'));

// 使用session中间件存储认证状态
app.use(session({
  secret: 'keyboard cat',
  resave: false,
  saveUninitialized: false
}));

// 初始化Passport
app.use(passport.initialize());
app.use(passport.session());

// 定义本地策略
passport.use(new LocalStrategy(
  function(username, password, done) {
    User.findOne({ username: username }, function (err, user) {
      if (err) { return done(err); }
      if (!user) {
        return done(null, false, { message: 'Incorrect username.' });
      }
      if (!user.validPassword(password)) {
        return done(null, false, { message: 'Incorrect password.' });
      }
      return done(null, user);
    });
  }
));

// 配置序列化和反序列化
passport.serializeUser(function(user, done) {
  done(null, user.id);
});

passport.deserializeUser(function(id, done) {
  User.findById(id, function (err, user) {
    done(err, user);
  });
});

// 启动服务器监听端口
app.listen(3000);

实现登录路由

接下来，添加处理登录请求的路由。

// 登录页面显示表单
app.get('/login', checkNotAuthenticated, (req, res) => {
  res.render('login');
});

// 处理提交的登录数据
app.post('/login', checkNotAuthenticated, 
  passport.authenticate('local', { successRedirect: '/',
                                   failureRedirect: '/login' })
);

// 注册成功重定向至首页
function checkNotAuthenticated(req, res, next) {
  if (req.isAuthenticated()) {
    return res.redirect('/');
  }
  next();
}

完成注册逻辑

实现用户注册的逻辑也很重要。这通常包括收集用户输入的数据，将其保存到数据库中，并使用之前定义的策略来验证新用户的凭证。
运行应用

最后，在终端运行 node index.js 或者 nodemon index.js，启动你的应用并访问 localhost:3000 开始体验。