passport源码研究

        passport的验证过程主要依赖具体的验证策略来实现的,比较常用的有session策略、local策略和github策略等,验证逻辑都是在这些策略类中定义的。passport模块的定义主要包括三个部分:passport类、相关中间件和验证策略,passport自带了session验证策略,如果要使用其他验证策略,需要自行添加。

        passport的使用分为五个部分:

  1. 首先必须通过app.use(passport.initialize())对passport进行初始化,否则后面的验证方法无法执行
  2. 在全局范围内添加session验证中间件,app.use(passport.session());,这个主要是为了记住用户的登录状态,可以指定session过期时间
  3. 给passport添加验证策略
  4. 在具体的路由上使用第三步中添加的验证中间件
  5. 给passport定义序列化和反序列化函数

        本文没有对passport进行深入的分析,具体请参考注释版源码

1、passport类

依赖于 ./framework/connect./strategies/session
主要属性:

    this._key = 'passport';         //挂载在session上的关键字  
    this._strategies = {};          //保存所有验证策略的对象  
    this._serializers = [];         //序列化session  
    this._deserializers = [];       //反序列化session  
    this._infoTransformers = [];    
    this._framework = null;         //保存所有中间件的对象  
    this._userProperty = 'user';    //挂载在req上的关键字 req.user  

Authenticator.prototype.init

        进行相关初始化,添加authenticate和initialize中间件,添加session验证策略 。给req对象添加login、logout、isAuthenticated和isUnAuthenticated方法

Authenticator.prototype.framework

        passport暴露的中间件是类似于connect风格的,签名如:fn(req, res, next),而有的框架需要的是不同的签名风格,因此,该方法是用来做适配的,如果使用的是express框架,则不需要调用该方法。将传入的参数保存到this._framework中,参数如下:

{  
    initialize: initialize,  
    authenticate: authenticate  
}  

Authenticator.prototype.use

        添加具体验证策略对象,并保存到this._strategies中,策略对象必须提供名称,例如:
passport.use('local',new LocalStrategy(function(username,password,done){ //todo });

Authenticator.prototype.unuse

        根据策略名称,删除this._strategies中对应的验证策略对象,例如:passport.unuse('local');

Authenticator.prototype.initialize

        设置this._userProperty,然后调用this._framework.initialize方法生成一个初始化中间件,并返回该中间件

Authenticator.prototype.authenticate

        调用this._framework.authenticate方法生成一个验证中间件,并返回该中间件

2、 middleware - 相关中间件

        主要包括initialize和authenticate,除此之外,在加载的时候还会对req对象定义多个方法

initialize

        进行相关初始化工作,将session中的passport对象(req.session[passport._key])挂载到req._passport上,如果session中没有保存相关信息或者session为空,则req_passport={}

authenticate

        给验证策略添加了额外的处理方法,如:success、fail、redirect、pass、error,主要目的是对验证状态进行保存。有了这些方法,我们就可以只关心验证逻辑的定义,在验证成功或失败后只需调用这些预先定好的方法即可。该中间件对请求按照指定的策略进行验证,如果验证通过,调用success方法,用户就会登录成功,相关用户信息将被挂载到req.user上同时会生成一个session对象,如果验证失败,将会向客户端发送未授权响应。
        该中间件需要注意的地方就是验证回调,如果提供了回调函数,那么将会覆盖默认的处理方式,即:attemp方法,此时需要自行调用req.login

  //提供了回调函数的情况
  app.get('/login', function(req, res, next) {
	  passport.authenticate('local', function(err, user, info) {
	    if (err) { return next(err); }
	    if (!user) { return res.redirect('/login'); }
	    req.logIn(user, function(err) {
	      if (err) { return next(err); }
	      return res.redirect('/users/' + user.username);
	    });
	  })(req, res, next);
	});
posted @ 2015-04-02 00:19  眼神与背影  阅读(1322)  评论(0编辑  收藏  举报