关于android:接入指南华为帐号服务Authorization-Code模式介绍与接入步骤详解

华为帐号服务提供两种登录受权模式，第一种是 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/h…

往期指南：

【接入指南】一文带你理解华为帐号服务

【接入指南】一个 Demo 带你玩转华为帐号服务

华为帐号服务相干链接：

华为帐号服务具体领导

codelab 接入领导

视频解说(请参考 HMS 4.0 视频解说)

应用 Toolkit 疾速集成华为帐号服务应用领导

原文链接：https://developer.huawei.com/…
原作者：胡椒

关于android:接入指南华为帐号服务Authorization-Code模式介绍与接入步骤详解

Just My Socks（注册教程 内含优惠码）

Just My Socks（注册教程内含优惠码）