天天看點

OAuth 2.0

OAuth是一個關于授權(authorization)的開放網絡标準,在全世界得到廣泛應用,目前的版本是2.0版。

應用場景舉例:

先看一張圖:

OAuth 2.0

程式員最常用的網站之一就是代碼托管平台,gitee是國内通路速度最快的,代碼最全的代碼托管平台之一。

除了使用注冊的gitee的賬号密碼之外,也提供了其他的第三方的登入方式,如微信、QQ、github等。這些使用第三方的登入方式使用的背後協定就是OAuth。那麼他們的工作方式是什麼樣的呢?

先貼一張圖(圖檔摘自RFC 6749):

OAuth 2.0

 接下介紹一下圖中的名詞和内容:

為友善了解,假設小明利用github賬戶登入gitee;

四種角色:

Client:用戶端,例如上面例子中的gitee網站;

Resource Owner:資源所有者,又稱“使用者”,上面例子中的小明;

Authorization server:認證伺服器,即服務提供商專門用來處理認證的伺服器。即github提供的專門用來處理想gitee這樣網站請求的伺服器;

Resource server:資源伺服器,即服務提供商存放使用者生成的資源的伺服器。它與認證伺服器,可以是同一台伺服器,也可以是不同的伺服器。即github提供小明資源的伺服器。

運作流程如下(參照上圖):

(A)使用者打開用戶端以後,用戶端要求使用者給予授權。

(B)使用者同意給予用戶端授權。

(C)用戶端使用上一步獲得的授權,向認證伺服器申請令牌。

(D)認證伺服器對用戶端進行認證以後,确認無誤,同意發放令牌。

(E)用戶端使用令牌,向資源伺服器申請擷取資源。

(F)資源伺服器确認令牌無誤,同意向用戶端開放資源。

用戶端的授權模式:

OAuth 2.0定義了四種授權方式。

  • 授權碼模式(authorization code)
  • 簡化模式(implicit)
  • 密碼模式(resource owner password credentials)
  • 用戶端模式(client credentials)

本文主要講授權碼模式,授權碼模式是功能最完整、流程最嚴密的授權模式。它的特點就是通過用戶端的背景伺服器,與"服務提供商"的認證伺服器進行互動。也是網絡程式設計中通常使用的授權模式。

OAuth 2.0

 User Agent:使用者代理,本文中就是指浏覽器。

 授權碼模式的步驟如下(參照上圖):

(A)使用者通路用戶端,後者将前者導向認證伺服器。

(B)使用者選擇是否給予用戶端授權。

(C)假設使用者給予授權,認證伺服器将使用者導向用戶端事先指定的"重定向URI"(redirection URI),同時附上一個授權碼。

(D)用戶端收到授權碼,附上早先的"重定向URI",向認證伺服器申請令牌。這一步是在用戶端的背景的伺服器上完成的,對使用者不可見。

(E)認證伺服器核對了授權碼和重定向URI,确認無誤後,向用戶端發送通路令牌(access token)和更新令牌(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:表示令牌類型,該值大小寫不敏感,必選項,可以是bearer類型或mac類型。
  • 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"
     }

           

從上面代碼可以看到,相關參數使用JSON格式發送(Content-Type: application/json)。此外,HTTP頭資訊中明确指定不得緩存。

本文部分内容轉自http://www.ruanyifeng.com/blog/2014/05/oauth_2_0.html,本文隻詳述了授權碼模式,如果也想了解其他模式可以通路這個文章。

如果覺得不錯,可以推薦收藏一下,讓我也更有動力。