前言

在我之前的【Node服务集成权限认证中间件之Passport】一文中已经介绍了如何为普通express应用集成passport认证中间件。那么对于下一代的Node应用框架——Koa，能否完美集成passport中间件呢？

困难

不得不承认，对于Koa而言，尤其是最新版本2.X版本Koa，其生态目前完全出于一个起步阶段，对比目前express大量稳定可用的中间件，的确是有许多的不足。但是开源的力量永远是最强大的，只要有需求，就一定有解决方案

思路

1、首选，passport中间件的官方只是提供了对express的支持。但是相对应的，koa也有其对应的开源集成版本——【koa-passport】

2、这里需要注意的是，koa-passport本质上并非全新实现的另外一个版本的passport，它仅仅只是作为中间件，将原先passport对express的支持，转移到了koa上。通过分析其源码可以看出，它其实是将原先绑定在express的req和res中的API方法，重新绑定到了koa的ctx中

3、美中不足的是koa-passport的官方文档中并没有给出很详细的使用方法，其koa-passport-example项目的示例也没有给出很清晰的使用说明，就我个人直接使用koa-passport-example项目，如果不加以修改，是无法完成认证功能的，所以难免会对初学者造成困扰，甚至是放弃

解决

对于koa-passport集成进入koa2版本，虽然是google和baidu了大量资料，但是很遗憾，目前似乎并没有太多关于这两者的集成文章，相关的都是比较老版本的文章或者是经过实践并没有生效的文章，并没有太多的参考价值
所以，这一篇文章可能是全网第一篇koa2版本正确集成koa-passport的教程，通过较长时间的分析koa-passport和passport的源码，最终得出了以下的正确集成方法，在此作为文章分享出来

步骤

第一，安装koa-passport

npm install koa-bodyparser --save
npm install passport --save
npm install passport-local --save
npm install koa-passport --save
npm install koa-session2 --save 【官方示例文档上使用的是koa-session，存在兼容问题】

第二，创建passport配置文件passport_config.js

【UserModel是数据库查询封装，在此省略】

const passport = require('koa-passport')
const LocalStrategy = require('passport-local')
const UserModel = require(__dirname + '/../../src/model/UserModel')

// 用户名密码验证策略
passport.use(new LocalStrategy(
    /**
     * @param username 用户输入的用户名
     * @param password 用户输入的密码
     * @param done 验证验证完成后的回调函数，由passport调用
     */
    function (username, password, done) {
        let where = { where: { username: username } }
        UserModel.findOne(where).then(function (result) {
            if (result != null) {
                if (result.password == password) {
                    return done(null, result)
                } else {
                    return done(null, false, '密码错误')
                }
            } else {
                return done(null, false, '未知用户')
            }
        }).catch(function (err) {
            log.error(err.message)
            return done(null, false, { message: err.message })
        })
    }
))

// serializeUser 在用户登录验证成功以后将会把用户的数据存储到 session 中
passport.serializeUser(function (user, done) {
    done(null, user)
})

// deserializeUser 在每次请求的时候将从 session 中读取用户对象
passport.deserializeUser(function (user, done) {
    return done(null, user)
})

module.exports = passport

第三，创建认证路由xauth.js

【这里使用的是koa-router的koa2版本】

// 路由相关
const Router = require('koa-router')
// 初始化路由
const router = new Router()
// 认证相关
const passport = require(__dirname + '/passport_config.js')

/**
 * 认证登录
 */
router.post('/xauth/login', function (ctx, next) {
    return passport.authenticate('local', function (err, user, info, status) {
        if (user) {
            ctx.body = 'Y'
            return ctx.login(user)
        } else {
            ctx.body = info
        }
    })(ctx, next)
})

/**
 * 认证登出
 */
router.get('/xauth/logout', function (ctx, next) {
    ctx.logout()
    ctx.body = 'Y'
})

// 以下为自定义需要身份认证的路由
router.post('/xauth/test', function (ctx, next) {
    if (ctx.isAuthenticated()) {
        ctx.body = '认证通过'
    } else {
        ctx.throw(401)
        ctx.body = '非法访问'
    }
})

module.exports = router

最后，Koa的App中初始化和引入passport

// 认证相关
const bodyParser = require('koa-bodyparser')
const mount = require('koa-mount')
const session = require("koa-session2") 
const passport = require(__dirname + '/src/auth/passport_config.js')
const xauth = require(__dirname + '/src/auth/xauth.js')

// 初始化应用服务
const app = new Koa()

// 启用认证路由
app.proxy = true    
app.use(session({key: "SESSIONID"}))
app.use(bodyParser())   
app.use(passport.initialize())
app.use(passport.session())
app.use(mount('/',xauth.routes()))

后记

关于本文中提到的内容，引用于我的开源项目【XServer——组件化后端构建】，本文代码开源于Github的【x-koa——组件化后端开发模板】，十分感谢对于本文的阅读，如有任何的疑问或者建议甚至批评，可以随时通过评论或私信联系我，我会第一时间回复