华为帐号服务提供两种登录授权模式，第一种是Authorization Code模式，第二种是ID-Token模式，这两种模式在使用场景上存在差异。本文将详细介绍Authorization Code模式及其接入方法，下一篇文章将给大家详解ID-Token模式。

使用场景：仅适用于开发者有自己的应用服务器场景。

优势：首次登录时，要求用户同意授权，当身份验证信息到期时，只需要从服务器端通过Refresh Token刷新Access Token令牌，不需要重复请求用户授权，体验更优。

业务流程：

1、 环境配置

推荐使用HMS Toolkit插件进行环境配置，更加方便、快捷。

2、 客户端开发：

（1）展示华为帐号登录图标

华为帐号提供了一个按钮控件HuaweiIdAuthButton，此控件展示华为风格的登录按钮，可以让您方便快速地实现符合华为图标使用规范的登录按钮。

使用方法：在xml布局文件中添加如下声明，并通过不同可选参数调整风格。

（2）编写帐号登录功能代码：

在需要的Activity(如AuthWithAuthCodeActivity)中编写如上signInCode()方法代码。代码中.setAuthorizatonCode()表示选择Authorization Code模式请求获取code。

之后在华为帐号登录按钮中绑定点击事件，触发按钮点击事件后执行signInCode()方法即可拉起基于Authorization Code模式的帐号登录授权页面。

（3）登录授权后处理登录结果

当登录授权成功后，通过authAccount.getAuthorizationCode()即可获取到code。

（4）获取到code后，开发者需将code发送给应用服务器，该部分代码由开发者根据自身设计自行开发。

至此，登录授权功能的客户端代码开发完成。

3、 服务器侧开发：

（1）接收来自客户端发送的code

该部分代码由开发者根据自身设计自行开发。

（2）用code换Access Token

应用服务器调用华为帐号服务器对应接口将code换成Access Token、Refresh Token。同时将Access Token、Refresh Token保存在应用服务器。

注：code有效期只有5分钟，且用一次就会失效，失效后需要通知客户端重新获取用户授权。

请求参数：

参数名

描述

grant_type

OAuth 2.0规范定义的字段，该值固定填“authorization_code”。

code

客户端发送的授权码

client_id

App ID，在创建应用后由华为开发者联盟为应用分配的唯一标识。查询方法请参见查看应用。

client_secret

App SECRET，在创建应用后由华为开发者联盟为应用分配公钥。查询方法请参见查看应用。

redirect_uri

AppGallery Connect中设置应用服务器的回调地址，用于应用服务器在获取用户授权后获取凭证Access Token。

请求示例：

响应参数：

参数名

描述

access_token

用户的Access Token。

refresh_token

如果应用申请帐号服务时，入参中包含access_type=offline，则会返回此参数，该参数用于刷新Access Token。

expires_in

Access Token的过期时间，以秒为单位。默认60分钟过期。

id_token

如果应用申请帐号服务时，入参scope中包含openid，则会返回此参数（JWT格式数据），包含用户基本帐号、用户邮箱等信息。ID Token的描述信息请参见ID Token验证接口中ID Token描述。

scope

生成的凭证Access Token中包含的scope。

token_type

固定返回Bearer，标识返回Access Token的类型。

响应示例：

（3）解析Access Token

获取到Access Token，要对其进行解析鉴权，获取Access Token中包含的union_id、open_id、expire_in、scope等信息。

请求示例：

其中open_id为固定值“OPENID”。

响应示例：

响应参数说明：

参数

是否必选

参数类型

描述

client_id

是

Long

应用App ID。

expire_in

是

int

Access Token的过期时间，单位为秒。默认为60分钟。

union_id

否

string

用户的union_id，由用户帐号和应用开发者帐号签名而成，需要应用ID包含com.huawei.android.hms.account.getUnionId权限时才会返回。对于同一个用户，同一个开发者帐号下管理的不同应用，UnionId值相同，它是开发者帐号的唯一标识

open_id

否

string

用户的open_id，由用户帐号和应用ID加密生成的，当Access Token为用户级，且入参open_id为OPENID时才返回。[z(1] 同一个用户，不同应用，OpenId值不同，它是用户的唯一标识

scope

否

string

用户授权scope列表，当Access Token为用户级时才返回。

（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参数即可。

请求示例：

响应示例：

（6）Refresh Token过期后，应用服务器需通知客户端重新申请用户授权，重新获取code，刷新AT和RT

该部分代码由开发者根据自身设计自行开发。

（7）使用Access Token去华为帐号服务器获取用户信息

应用已经获取到Access Token并已申请帐号开放信息对应权限后，应用需要获取帐号用户名称、头像、手机号码、年龄等信息。

请求示例：

响应示例：

响应参数说明：

参数

是否必选

参数类型

描述

openID

是

string

用户openID。

displayName

是

string

getNickName为0或不传时，按照匿名化帐号、昵称的先后顺序返回。

getNickName为1时，按照昵称、匿名化帐号的先后顺序返回。

headPictureURL

否

string

用户头像。

mobileNumber

否

string

用户手机号。

srvNationalCode

否

string

用户服务地国家。

nationalCode

否

string

用户注册地。

birthDate

否

string

生日。

ageGroupFlag

否

Int

年龄段。

-1：年龄未知（没输入生日） 。

0：成人。

1：未成人，介于儿童和成人之间。

2：儿童。

email

否

string

用户邮箱。

注：当应用有获取头像、手机号、服务地国家、注册地、生日、年龄段、邮箱权限后才返回对应信息，获取权限请参见帐号开放信息获取流程。

至此，基于code模式的应用服务端关键开发步骤完成。

服务端相关示例代码可参考https://github.com/HMS-Core/huawei-account-demo/tree/master/Account-Server-Java-Demo

往期指南：

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

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

华为帐号服务相关链接：

>>华为帐号服务详细指导

>>codelab接入指导

>>视频讲解(请参考HMS 4.0视频讲解)

>>使用Toolkit快速集成华为帐号服务使用指导

>>请戳华为开发者联盟官网、开发指导文档，了解更多相关内容

>>华为移动服务开源仓库地址：GitHub、Gitee

关注我们，第一时间了解华为移动服务最新技术资讯~