華為帳號服務提供兩種登入授權模式，第一種是Authorization Code模式，第二種是ID-Token模式，這兩種模式在使用場景上存在差異。本文將詳細介紹Authorization Code模式及其接入方法，下一篇文章將給大家詳解ID-Token模式。

Authorization Code模式介紹

使用場景：僅適用於開發者有自己的應用伺服器場景。

優勢：首次登入時，要求使用者同意授權，當身份驗證資訊到期時，只需要從伺服器端通過Refresh Token重新整理Access Token令牌，不需要重複請求使用者授權，體驗更優。

業務流程：

Authorization Code模式接入步驟詳解

1、環境配置

推薦使用HMS Toolkit外掛進行環境配置，更加方便、快捷。

2、客戶端開發：

（1）展示華為帳號登入圖示

華為帳號提供了一個按鈕控制元件HuaweiIdAuthButton，此控制元件展示華為風格的登入按鈕，可以讓您方便快速地實現符合華為圖示使用規範的登入按鈕。

使用方法：在xml佈局檔案中新增如下宣告，並通過不同可選引數調整風格。

<com.huawei.hms.support.hwid.ui.HuaweiIdAuthButton
 android:id="@+id/HuaweiIdAuthButton"//自定義
 android:layout_width="wrap_content"
 android:layout_height="wrap_content"/>

（2）編寫帳號登入功能程式碼：

private void signInCode() {
 mAuthParam = new AccountAuthParamsHelper(AccountAuthParams.DEFAULT_AUTH_REQUEST_PARAM)
 .setAuthorizationCode()
 .createParams();
 mAuthService = AccountAuthManager.getService(AuthWithAuthCodeActivity.this, mAuthParam);
 startActivityForResult(mAuthService.getSignInIntent(), REQUEST_SIGN_IN_LOGIN_CODE
 
);
}

在需要的Activity(如AuthWithAuthCodeActivity)中編寫如上signInCode()方法程式碼。程式碼中.setAuthorizatonCode()表示選擇Authorization Code模式請求獲取code。

之後在華為帳號登入按鈕中繫結點選事件，觸發按鈕點選事件後執行signInCode()方法即可拉起基於Authorization Code模式的帳號登入授權頁面。

（3）登入授權後處理登入結果

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
 // Process the sign-in authorization result and obtain an ID token from AuthHuaweiId.
 super.onActivityResult(requestCode, resultCode, data);
 if (requestCode == REQUEST_SIGN_IN_LOGIN_CODE) {
 Task<AuthAccount> authAccountTask = AccountAuthManager.parseAuthResultFromIntent(data);
 if (authAccountTask.isSuccessful()) {
 // The sign-in is successful, and the user's HUAWEI ID information and Code are obtained.
 AuthAccount authAccount = authAccountTask.getResult();

 Log.i("AuthWithAuthCodeActivity", "Authorization code:" + authAccount.getAuthorizationCode());
 } else {
 // The sign-in failed.

 Log.e("AuthWithAuthCodeActivity", "sign in failed : " +((ApiException)authAccountTask.getException()).getStatusCode());

 }
 }
}

當登入授權成功後，通過authAccount.getAuthorizationCode()即可獲取到code。

（4）獲取到code後，開發者需將code傳送給應用伺服器，該部分程式碼由開發者根據自身設計自行開發。

至此，登入授權功能的客戶端程式碼開發完成。

3、伺服器側開發：

（1）接收來自客戶端傳送的code

該部分程式碼由開發者根據自身設計自行開發。

（2）用code換Access Token

應用伺服器呼叫華為帳號伺服器對應介面將code換成Access Token、Refresh Token。同時將Access Token、Refresh Token儲存在應用伺服器。

注：code有效期只有5分鐘，且用一次就會失效，失效後需要通知客戶端重新獲取使用者授權。

請求引數：

請求示例：

POST /oauth2/v3/token HTTP/1.1
Host: oauth-login.cloud.huawei.com
Content-Type: application/x-www-form-urlencoded
grant_type=authorization_code&
code=CF3L7XyCVZi52XMdsUzD7Z6ap0/N2qExcNe0AMqTselTtNd1B4DUwTsQ/23FPZasC8yI29v+N2s2jMT/T2MXiuc+178I/sYuWVoTyqwBaDqVW82KCMqaxbeWBguH4hEENxmDSUIE61Qg5R1F074PiS+qJYnbLI2IBqatS37px8pn5qnuq5oX+UX8XN3/w8HLt4GpakW5Dk1v7hGs&
client_id={app_id}&
client_secret={app_secret}&
redirect_uri=https://www.example.com/redirect_uri

響應引數：

響應示例：

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache
{
"access_token": "CFyJ21sNODl16eV9y2vu3CwQk9DBr32BkOcxxgAd7MZUR5th1giyTk5\/kA+QDAyxou+\/5U2zzBRcf3qgLkkFdtbbC+mM3zFV7xj7CCEMHc5Tw92al0Y=",
"refresh_token": "CF13G0sRaGybtYt7SIyeUILNORtTFwMgz4ao5C7j7vtgLPt6ogmXKjdI8RS\/YlyS71z4DyP6kEMnOrRlmNK0KhdOUNWd+qVLLRsEEHkqRIKpuAkPvL8=",
"expires_in": 3600,
"id_token": "eyJraWQiOiI3YTNlYjRkNTJmMDdhODM0NDU4MmRhOGQ3MWE1MGQ5MDlmNWM0YmRiZTFkNDQ3MjQ2MDNhZTA2NGM0ZTlkZGYyIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJhdF9oYXNoIjoiM0hPdFZYOEdMcG1GSDBWRVlSc1BjdyIsImF1ZCI6IjEwMDczNTE2NyIsInN1YiI6Ik1ERTlYaWFoc3MwaWFFNXU2c09PaEY5Mlhvell0Rkt4bUdtbWlhNGtTaEJ3dklLR2ciLCJhenAiOiIxMDA3MzUxNjciLCJpc3MiOiJodHRwczovL2FjY291bnRzLmh1YXdlaS5jb20",
"scope": "openid profile email",
"token_type": "Bearer"
}

（3）解析Access Token

獲取到Access Token，要對其進行解析鑑權，獲取Access Token中包含的union_id、open_id、expire_in、scope等資訊。

請求示例：

POST /rest.php?nsp_fmt=JSON&nsp_svc=huawei.oauth2.user.getTokenInfo HTTP/1.1
Host: oauth-api.cloud.huawei.com
Content-Type: application/x-www-form-urlencoded
open_id=OPENID&

access_token=CFwaKaGpgXEj9LlsDKVARTUL7DFkvbAE2a22HYpRx%2F520JO5UvfWqSc6X7XUwf4Pzo5%2FxC8mByagdMPG%2FHeHDBldhW3tYizcw3xXSVwJPWK82C8zPM%3D

其中open_id為固定值“OPENID”。

響應示例：

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"union_id": "MDHSI1UnQ9wzGzibtoqicNNnUmJbwhicPzHxxiaVHvMtmNd3xw",
"scope": "https://www.huawei.com/auth/account",
"open_id": "MDFAMzAwMDE3NTAxQGI4ODgzNWRmYjE4ZTI2NGFiaZDE2YjI5ODMwMDM3MDA0QDIxYWY3NzVkZmM1ODk1MWY4NzI4YzFiaNGJkMjE2Y2QyZTUxNzg3NzUzMDcyZTM4ZjkyZTQxYw",
"expire_in": 1123,
"client_id": "300017501"
}

響應引數說明：

（4）判斷Access Token、Refresh Token是否過期

A、解析AT後，可獲取該AT的有效期時間（預設60分鐘），開發者可以根據這個時間進行倒計時判斷當前AT是否即將過期，做好提前保活；

B、另一種方式是看用AT去獲取使用者資訊的時候是否返回AT過期錯誤碼來判斷；

C、RT是否過期（預設有效期180天）可以通過用RT換取AT時是否返回RT過期錯誤碼來判斷。

（5）Access Token即將過期或已過期，可用Refresh Token去華為帳號伺服器重新整理Access Token

當Access Token未過期，用Refresh Token去重新整理不會改變Access Token，但超時時間會重新整理。

當Access Token已過期，用Refresh Token去重新整理，會獲得一個新的Access Token。

RT重新整理AT的介面與用Code換取AT的介面類似，只需要將grant_type換成”refresh_token”、code換成Refresh Token，同時去掉redirect_uri引數即可。

請求示例：

POST /oauth2/v3/token HTTP/1.1
Host: oauth-login.cloud.huawei.com
Content-Type: application/x-www-form-urlencoded
grant_type=refresh_token&
client_id=12345&
client_secret=bKaZ0VE3EYrXaXCdCe3d2k9few&
refresh_token=CF2Mm03n0aos9iZZ8nIhfyDtoXy74CXeBi50gVVhMpB0IUzlv9ZwizEvTBhVoF820ZPim0JwNR9j2p1qgEQWnIVYZRlp4T6ezMgekUnsHBkvNev5rd2MdfQMLP

響應示例：

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache
{
"access_token": "CFyJ4J\/l6wuwcFqYOJG4maq2ca8RAV+g0i+mel6qCV5lvqH0PYtW0+BNwfHWg0AqMnW6ZdBvUgs7ijkxMFh1xVP\/B+vQXz3PWsivkKCuL78XtbLt7vs=",
"id_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjExOGRmMjU0YjgzNzE4OWQxYmMyYmU5NjUwYTgyMTEyYzAwZGY1YTQiLCJ0eXAiOiJKV1QifQ.eyJpc3MiOiJodHRwczovL2FjY291bnRzLmdvb2dsZS5jb20iLCJhenAiOiI3ODI0NTY2Njc4OTgtc2M0MzE3Y2l0NGEwMjB0NzdrbGdsbWo1ZjA4YWtnMWIuYXBwcy5nb29nbGV1c2VyY29udGVudC5jb20iLCJhdWQiOiI3ODI0NTY2Njc4OTgtN2NkNGJpYWRkaGVwNGc4cnZic2VlOGtwcDA5Zm1hNzIuYXBwcy5nb29nbGV1c2VyY29udGVudC5jb20iLCJzdWIiOiIxMDE3MTIxMzkwMzgwNDE2MDc0MTQiLCJlbWFpbCI6Inh1ZXpoZW5odWF0anVAc2l",
"expires_in": 3600,
"scope": "openid profile email",
"token_type": "Bearer"
}

（6）Refresh Token過期後，應用伺服器需通知客戶端重新申請使用者授權，重新獲取code，重新整理AT和RT

該部分程式碼由開發者根據自身設計自行開發。

（7）使用Access Token去華為帳號伺服器獲取使用者資訊

應用已經獲取到Access Token並已申請帳號開放資訊對應許可權後，應用需要獲取帳號使用者名稱稱、頭像、手機號碼、年齡等資訊。

請求示例：

POST /rest.php?nsp_svc=GOpen.User.getInfo HTTP/1.1
Host: account.cloud.huawei.com
Content-Type: application/x-www-form-urlencoded
access_token=CV46i%2BFdM3LEja3z7%2BjOGu27mNBsKwBznSoe4MMfKmNw4aGNLisoCKYgbSOJIVhWLOIIVr0nMwVXFu9AvFGKoJmGk%2FUZdMDytv2bsamauePs3FG6ZkU%3D&

getNickName=0

響應示例：

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"displayName":"182******74",
"openID":"MDFAMTAxMDA1MTg1QGFlMzM0OWIyOGY0MzNiaNjI1MDRiaNTI5ODAxYTA3MDhkQDU1MDA4ZTZmNTA2ZTE4ZTg0Yzc2YTlmNGVmN2E1ZjY1OTg4NWRiaN2QxMzQyMDUzNGMzNTU0YWQ3",
"headPictureURL":"https://upfile-drcn.platform.hicloud.com/FileServer/image/b.0150086000130905592.20180407082531.08157939582468778294625163020035.1000.9C3EE92B95EFEF4CAC263604A15953F32C7BC9E8A47D52B774511F75EF34C0D4.jpg"
}

響應引數說明：

注：當應用有獲取頭像、手機號、服務地國家、註冊地、生日、年齡段、郵箱許可權後才返回對應資訊，獲取許可權請參見帳號開放資訊獲取流程。

至此，基於code模式的應用服務端關鍵開發步驟完成。

服務端相關示例程式碼可參考https://github.com/HMS-Core/huawei-account-demo/tree/master/Account-Server-Java-Demo

往期指南：

>>【接入指南】一文帶你瞭解華為帳號服務

>>【接入指南】一個Demo帶你玩轉華為帳號服務

華為帳號服務相關連結：

>>華為帳號服務詳細指導

>>codelab接入指導

>>視訊講解(請參考HMS 4.0視訊講解)

>>使用Toolkit快速整合華為帳號服務使用指導

原文連結：https://developer.huawei.com/...
原作者：胡椒