登录认证

登录流程

SDK完整的登录流程如下图，标记为红色的步骤，就是本文档中对应的登录认证协议。

上图中各个步骤说明：

1、游戏客户端，调用SDK登录接口.

2、登录成功后，SDK服务端会将结果返回给客户端，包含用户的uid，token等数据.

3、游戏客户端uid，token等参数， 可以访问游戏服务器.

4、游戏服务器访问【本协议】接口，验证uid和token的有效性.

5、如果验证成功，则允许玩家进入游戏.

签名规则

登录认证协议中的sign字段生成规则如下：

1）除了sign字段和值为空的字段， 将其余字段按照字段key值的升序排列， 然后按照key=value&key=value.....拼接成字符串。（注意接收到字段后，需要先进行url decode，再进行签名计算）；

2) 将上述生成的字符串，最后附加&secretKey={SDK Key参数}格式生成待签名字符串。 {SDK Key参数}替换为分配的游戏【AppKey】参数；

3）对上面得到的待签名字符串，做md5(32位大写)计算，生成对应的sign。

协议内容

客户端SDK登录成功之后，会返回当前的uid和token等信息。 客户端需要将该参数告诉游戏服务器，游戏服务器拿着这些参数，来聚合SDK服务端进行一次登录认证。 认证成功的玩家，才能允许进入游戏。

1 请求协议

请求地址：http://{聚合SDK服务端API地址}/user/v1/check
请求方式：POST
请求参数格式：application/x-www-form-urlencoded
参数编码： UTF-8

请求参数：

参数名称	参数类型	参数说明
appID	String	当前游戏的appID，U8SDK后台-》游戏管理中查看appID
timestamp	String	时间戳，单位毫秒
uid	String	客户端SDK登录成功后，SDK返回的userID参数
token	String	客户端SDK登录成功后，SDK返回的token参数
sign	String	签名，签名算法规则见上方《签名规则》部分

2 响应内容

登录认证成功， SDK返回JSON格式的状态信息

{
    "code": 0,
    "msg": "SUCCESS"
}

状态码说明

状态码	说明
0	成功状态
1	失败状态