OAuth 2.0

[TOC] ## OAuth 2.0 - OAuth 的核心就是向第三方应用颁发令牌 - OAuth 2.0 规定了四种获得令牌的流程。你可以选择最适合自己的那一种，向第三方应用颁发令牌 - client_id和client_secret 通过在第三方平台注册获取 ## 四种授权方式 ### 授权码（authorization-code） - 指的是第三方应用先申请一个授权码，然后再用该码获取令牌 - 这种方式是最常用的流程，安全性也最高 1. 第一步:A 网站提供一个链接，用于跳转到B网站 ``` https://b.com/oauth/authorize? response_type=code& client_id=CLIENT_ID& redirect_uri=CALLBACK_URL& scope=read 参数说明: response_type 参数表示要求返回授权码（code） client_id 参数让 B 知道是谁在请求 redirect_uri 参数是 B 接受或拒绝请求后的跳转网址 scope 参数表示要求的授权范围（这里是只读） ``` 2. 第二步，用户跳转后，B 网站会要求用户登录，然后询问是否同意给予 A 网站授权。用户表示同意，这时 B 网站就会跳回redirect_uri参数指定的网址。跳转时，会传回一个授权码 ``` https://a.com/callback?code=AUTHORIZATION_CODE 参数说明: code参数就是授权码 ``` 3. 第三步，A 网站拿到授权码以后，就可以在后端，向 B 网站请求令牌 ``` https://b.com/oauth/token? client_id=CLIENT_ID& client_secret=CLIENT_SECRET& grant_type=authorization_code& code=AUTHORIZATION_CODE& redirect_uri=CALLBACK_URL 参数说明: client_id参数和client_secret 参数用来让 B 确认 A 的身份（client_secret参数是保密的，因此只能在后端发请求）， grant_type 参数的值是AUTHORIZATION_CODE，表示采用的授权方式是授权码 code 参数是上一步拿到的授权码， redirect_uri 参数是令牌颁发后的回调网址 ``` 4. 第四步，B 网站收到请求以后，就会颁发令牌。具体做法是向redirect_uri指定的网址 ``` { "access_token":"ACCESS_TOKEN", "token_type":"bearer", "expires_in":2592000, "refresh_token":"REFRESH_TOKEN", "scope":"read", "uid":100101, "info":{...} } 参数说明: access_token 字段就是令牌，A 网站在后端拿到了 refresh_token 此token 适用于令牌过期是时,更新令牌的touken,详见令牌更新 ``` ### 隐藏式 - 有些 Web 应用是纯前端应用，没有后端,必须将令牌储存在前端 - 允许直接向前端颁发令牌。这种方式没有授权码这个中间步骤 1. 第一步，A 网站提供一个链接，要求用户跳转到 B 网站，授权用户数据给 A 网站使用 ``` https://b.com/oauth/authorize? response_type=token& client_id=CLIENT_ID& redirect_uri=CALLBACK_URL& scope=read 参数说明: response_type参数为token，表示要求直接返回令牌 ``` 2. 第二步，用户跳转到 B 网站，登录后同意给予 A 网站授权。这时，B 网站就会跳回redirect_uri参数指定的跳转网址，并且把令牌作为 URL 参数，传给 A 网站 ``` https://a.com/callback#token=ACCESS_TOKEN ``` > 这种方式把令牌直接传给前端，是很不安全的。因此，只能用于一些安全要求不高的场景，并且令牌的有效期必须非常短，通常就是会话期间（session）有效，浏览器关掉，令牌就失效了 ### 密码式 - 如果你高度信任某个应用，也允许用户把用户名和密码，直接告诉该应用。该应用就使用你的密码，申请令牌，这种方式称为"密码式"（password）。 1. 第一步，A 网站要求用户提供 B 网站的用户名和密码。拿到以后，A 就直接向 B 请求令牌 ``` https://oauth.b.com/token? grant_type=password& username=USERNAME& password=PASSWORD& client_id=CLIENT_ID 参数说明 grant_type参数是授权方式，password表示"密码式"， username和password是 B 的用户名和密码 ``` 2. 第二步，B 网站验证身份通过后，直接给出令牌。注意，这时不需要跳转，而是把令牌放在 JSON 数据里面，作为 HTTP 回应，A 因此拿到令牌 ### 凭证式 - 适用于没有前端的命令行应用，即在命令行下请求令牌 1. 第一步，A 应用在命令行向 B 发出请求 ``` https://oauth.b.com/token? grant_type=client_credentials& client_id=CLIENT_ID& client_secret=CLIENT_SECRET 参数说明 grant_type 参数等于client_credentials表示采用凭证式 client_id和client_secret 用来让 B 确认 A 的身份 ``` 2. 第二步，B 网站验证通过以后，直接返回令牌 这种方式给出的令牌，是针对第三方应用的，而不是针对用户的，即有可能多个用户共享同一个令牌 ## 令牌 ### 令牌的使用 A 网站拿到令牌以后，就可以向 B 网站的 API 请求数据了 每个发到 API 的请求，在请求的头信息，加上一个Authorization字段 ``` curl -H "Authorization: Bearer ACCESS_TOKEN" "https://api.b.com" 参数说明 ACCESS_TOKEN 就是拿到的令牌 ``` ### 更新令牌 - 令牌过期时,如果每次都重新获取令牌,体验并不好 - 颁发令牌的时候，一次性颁发两个令牌，一个用于获取数据,一个用于获取数据，另一个用于获取新的令牌（refresh token 字段） ``` https://b.com/oauth/token? grant_type=refresh_token& client_id=CLIENT_ID& client_secret=CLIENT_SECRET& refresh_token=REFRESH_TOKEN 参数说明 grant_type 参数为refresh_token表示要求更新令牌 client_id 参数和client_secret参数用于确认身份 refresh_token 参数就是用于更新令牌的令牌 ```