nodejs实现OAuth2.0授权服务

OAuth是一种开发授权的网络标准，全拼为open authorization，即开放式授权，最新的协议版本是2.0。

举个栗子：

有一个"云冲印"的网站，可以将用户储存在Google的照片，冲印出来。用户为了使用该服务，必须让"云冲印"读取自己储存在Google上的照片。

传统方法是，用户将自己的Google用户名和密码，告诉"云冲印"，后者就可以读取用户的照片了。这样的做法有以下几个严重的缺点。

• "云冲印"为了后续的服务，会保存用户的密码，这样很不安全。
• Google不得不部署密码登录，而我们知道，单纯的密码登录并不安全。
• "云冲印"拥有了获取用户储存在Google所有资料的权力，用户没法限制"云冲印"获得授权的范围和有效期。
• 用户只有修改密码，才能收回赋予"云冲印"的权力。但是这样做，会使得其他所有获得用户授权的第三方应用程序全部失效。
• 只要有一个第三方应用程序被破解，就会导致用户密码泄漏，以及所有被密码保护的数据泄漏。

所以OAuth就诞生了！

名词定义

• Third-party application：第三方应用程序，本文中又称"客户端"（client），即上一节例子中的"云冲印"。
• HTTP service：HTTP服务提供商，本文中简称"服务提供商"，即上一节例子中的Google。
• Resource Owner：资源所有者，本文中又称"用户"（user）。
• User Agent：用户代理，本文中就是指浏览器。
• Authorization server：认证服务器，即服务提供商专门用来处理认证的服务器。
• Resource server：资源服务器，即服务提供商存放用户生成的资源的服务器。它与认证服务器，可以是同一台服务器，也可以是不同的服务器。

OAuth整体思路

登录层提供令牌（token）的生成，其中token包括：有效期、权限范围。客户端拿到token去访问受限资源。

• access_token：请求资源时需要携带的token，即访问token。
• refresh_token：刷新token，如果access_token过期，可以使用该token获取一份新的access_token和新的refresh_token。一般refresh_token时效性较长，比如一年，而access_token时效性较短，比如几分钟。
• 权限范围：即指定客户端可以获取的资源权限范围。

OAuth授权模式

OAuth有四种授权模式，分别为：

• 授权码模式（authorization code）
• 简化模式（implicit）
• 密码模式（resource owner password credentials）
• 客户端模式（client credentials）

1、授权码模式

授权码模式是最为严密的授权模式，整体流程为：浏览器携带必要信息至授权页面，正常登录成功后，返回一个code（授权码），客户端拿到code后在后台获取拿code换取token。

2、密码模式

密码模式，简单地理解即为使用用户名密码等参数获取access_token，它的步骤如下：

• 用户向客户端提供用户名和密码。
• 客户端将用户名和密码发给认证服务器，向后者请求令牌。
• 认证服务器确认无误后，向客户端提供访问令牌。

3、refresh_token的应用

refresh_token被用来获取新的access_token和refresh_token，使用方式简单如下：

refresh_token无效：

使用nodejs实现OAuth授权服务

技术栈：

• nodejs + eggjs
• eggjs-oAuth-server插件

具体可以参考：

https://github.com/Azard/egg-oauth2-server

https://cnodejs.org/topic/592b2aedba8670562a40f60b

1、code grant模式测试及单点登录实现

这里我们构建两个站点，一个是7001端口（授权服务），一个是7002端口（客户端），授权模式为code grant。

首先是客户端登录页：

单击按钮后直接登录：

可以发现，浏览器重定向到授权服务地址，并携带了response_type、client_id、redirect_uri三个参数，登录成功后，浏览器会重定向到redirect_uri指定的地址，即这里的http://127.0.0.1:7002/auth/redirect：

如下为授权服务的登录页写法

<form action="/oauth2/authorize?{{query}}" id="form1" name="f" method="post">
	<div class="input_outer">
		<span class="u_user"></span>
		<input name="username" class="text" style="color: #FFFFFF !important" type="text" placeholder="请输入账户">
	</div>
	<div class="input_outer">
		<span class="us_uer"></span>
		<input name="password" class="text" style="color: #FFFFFF !important; position:absolute; z-index:100;"value="" type="password" placeholder="请输入密码">
	</div>
	<div class="mb2"><a class="act-but submit" href="javascript:;" onclick="document.getElementById('form1').submit()" style="color: #FFFFFF">登录</a></div>
</form>

这里的${query}即为客户端登录重定向携带的完整query，然后是/oauth2/authorize路由的写法：

app.all('/oauth2/authorize', app.oAuth2Server.authorize());      // 获取授权码

这里调用app.oAuth2Server.authorize()时，插件会自动执行重定向操作，首先是重定向到客户端指定地址，客户端拿到code和state后，再去授权层获取token：

async redirect(){
    // 服务端重定向过来的
    console.log(this.ctx.query)
    const result = await this.ctx.curl('http://127.0.0.1:7001/users/token', {
      dataType: 'json',
      // contentType: 'application/x-www-form-urlencoded', // 默认格式
      method: 'POST',
      timeout: 3000,
      data: {
        grant_type: 'authorization_code',
        code: this.ctx.query.code,
        state: this.ctx.query.state,
        client_id: client_id,
        client_secret: client_secret,
        redirect_uri: redirect_uri,
      }
    });
    this.ctx.body = result.data;
  }

获取到token后正常返回：

2、password grant模式测试

首先使用username、password获取access_token：

用户名或密码错误时返回：

使用token获取授权资源正常返回：

以上内容完整源码参考：https://github.com/caiya/eggjs-oAuth2-server

总结

• OAuth实际使用时要上https，包括客户端和授权服务端
• 授权服务可以使用私钥签名，客户端使用公钥验证，从而保证数据安全性