身份鉴权服务

更新时间:
复制 MD 格式

完成 服务端接入准备 后,平台侧可根据本文指引接入小游戏账号鉴权。

接入须知

该接入项为非必选。仅当游戏商家需对 openid 及 token 进行强身份鉴权校验时启用;若平台方未提前完成接入,则无法使用此功能。

接口时序图

image

服务端接入方案

平台需提供服务端用户鉴权接口并由 mPaaS 完成适配;同时,平台客户端须向小游戏提供有效的登录凭证及稳定的用户标识。

接口入参

字段示例

类型

要求

说明

auth_token

String

必须具备

平台签发的用户登录凭证

open_uid

String

必须具备

当前平台用户标识

mini_program_id

String

必须能够确定

当前小游戏标识,平台校验其是否在凭证授权范围内

请求业务参数样例:

{
  "auth_token": "<authToken>",
  "open_uid": "USER_001",
  "mini_program_id": "game_demo"
}

接口出参

字段示例

类型

要求

说明

success

Boolean

必须具备

本次鉴权接口调用是否成功

matched

Boolean

调用成功时必须具备

凭证有效,且与当前用户及小游戏相匹配时为 true

error_code、error_message

String

调用失败时提供

失败原因,例如参数错误或平台服务异常

身份匹配时的响应样例:

{
  "success": true,
  "matched": true
}

凭证失效或身份不匹配时的响应样例:

{
  "success": true,
  "matched": false
}

平台接口处理异常时的响应样例:

{
  "success": false,
  "error_code": "AUTH_SERVICE_ERROR",
  "error_message": "鉴权服务异常"
}

mPaaS 仅在接口调用成功且明确返回身份匹配时判定鉴权通过。平台需提供凭证全生命周期处理规则(含获取、有效期、刷新、退出登录及切换账号),以及测试与生产环境地址、签名或授权方式,供 mPaaS 对接使用。

接入联测

接入后如需联测,请联系 mPaaS 业务方,协同游戏商完成鉴权能力的接入与配置。