OAuth协议

读音/’əu ‘ɔːθ/

OAuth

OAuth是一个关于授权的开放网络标准。

应用场景

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

问题是只有得到用户的授权，Google才会同意”云冲印”读取这些照片。那么，”云冲印”怎样获得用户的授权呢？

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

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

名词定义

1. 第三方程序：又称客户端，即上面举的云冲印的例子
2. HTTP服务提供商：即上一个例子中的google
3. 资源所有者：又称“用户”
4. （user agent）用户代理：一般是浏览器
5. （authorization server）认证服务器，即服务提供商专门用来处理认证的服务器
6. （Resource server）资源服务器：即服务提供商存放用户生成的资源的服务器。他与认证服务器可以是一台服务器也可以是不同的服务器。

OAuth的作用，就是让“客户端”安全可控地获取“用户”的授权，与“服务提供商”进行互动。

OAuth的思路

OAuth在“客户端”和“服务提供商”之间，设置了一个授权层。“客户端”不能直接登录“服务提供商”，只能登录授权层，以此将用户与客户端区分开来。“客户端”登录授权层所用的令牌（token）与用户的密码不同。用户可以在登录的时候，制定授权层令牌的权限范围和有效期。

“客户端”登录授权层以后，“服务提供商”根据令牌的权限范围和有效期，向“客户端”开放用户储存的资料。

运行流程

- 用户打开客户端以后，客户端要求用户给予授权。
- 用户同意给予客户端授权
- 客户端使用上一步获得的授权，向认证服务器申请令牌
- 认证服务器对客户端进行认证以后，确认无误，同意发放令牌
- 客户端使用令牌，向资源服务器申请获取资源。
- 资源服务器确认令牌无误，同意向客户端开放资源。

其中，B是关键，即用户怎样才能给予客户端授权。有了这个授权以后，客户端就可以获取令牌，进而凭令牌获取资源。

客户端的授权模式

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

授权码模式

授权码模式是功能最完整，流程最严密的授权模式。他的特点是通过客户端的后台服务器，与“服务提供商”的认证服务器进行互动。

- 用户访问客户端，后者将前者导向认证服务器
- 用户选择是否给予客户端授权。
- 假设用户给予授权，认证服务器将用户导向客户端事先制定的“重定向（redirection URI）”同时附上一个授权码。
- 客户端收到授权码，附上早先的“重定向URI”向服务器申请令牌。这一步是在客户端的后台的服务器上完成的，对用户不可见。
- 认证服务器核对了授权码和重定向URI，确认无误后，向客户端发送访问令牌（access code）和更新令牌（refresh token）

A步骤中，客户端申请认证的URI，包含以下参数：
- response_type:表示授权类型，必选项。此处的值固定为“code”
- client_id:表示客户端的ID，必选项
- redirect_uri:表示重定向URI，可选项
- scope：表示申请的权限范围可选项
- state：表示客户端当前状态，可以指定任意值，认证服务器会原封不动的返回这个值

一个例子

GET /authorize?response_type=code&client_id=s6BhdRkqt3&state=xyz
        &redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fcb HTTP/1.1
Host: server.example.com

C步骤中，服务器回应客户端的URI，包含以下参数：
- code：表示授权码，必选项。该码有效期很短，通常为10分钟，客户端只能使用该码一次，否则会被授权服务器拒绝。该码和客户端ID和重定向URI是一一对应的关系。
- state：如果客户端的请求中包含这个参数。认证服务器的回应也必须一模一样包含这个参数。

一个例子

HTTP/1.1 302 Found
Location: https://client.example.com/cb?code=SplxlOBeZQQYbYS6WxSbIA
          &state=xyz

D步骤中，客户端向认证服务器申请令牌的HTTP请求，包含以下参数
- grant_type：表示使用的授权模式。此处固定为“authorization_code”
- code:表示上一步获取的授权码
- redirect_uri：表示重定向URI，且必须与A步骤中的该参数保持一致
- client_id:表示客户端ID

一个例子

POST /token HTTP/1.1
Host: server.example.com
Authorization: Basic czZCaGRSa3F0MzpnWDFmQmF0M2JW
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code&code=SplxlOBeZQQYbYS6WxSbIA
&redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fcb

E步骤中，认证服务器发送的HTTP回复，包含以下参数：
- access_token：表示访问令牌，必选项
- token_type:表示令牌类型，该值大小写不敏感必选项
- expires_in:表示过期时间，单位是秒
- refresh_token:表示更新令牌，用来获取下一次的访问令牌
- scope:表示权限范围
一个例子

     HTTP/1.1 200 OK
     Content-Type: application/json;charset=UTF-8
     Cache-Control: no-store
     Pragma: no-cache

     {
       "access_token":"2YotnFZFEjr1zCsicMWpAA",
       "token_type":"example",
       "expires_in":3600,
       "refresh_token":"tGzv3JOkF0XG5Qx2TlKWIA",
       "example_parameter":"example_value"
     }

简化模式

简化模式不通过第三方应用程序的服务器，直接在浏览器中向认证服务器申请令牌，跳过了“授权码”这个步骤。所有步骤在浏览器中完成，令牌对访问者是可见的，且客户端不需要认证。

- 客户端将用户导向认证服务器
- 用户决定是够给予客户端授权
- 假设用户给予授权，认证服务器将用户导向客户端制定的“重定向URI”，并在URI的Hash部分包含了访问令牌。
- 浏览器向资源服务器发出请求，其中不包括上一步收到的HASH值
- 资源服务器返回一个网页，其中包含的代码可以获取HASH值中的令牌
- 浏览器执行上一步获得的脚本，提出令牌
- 浏览器将令牌发给客户端