[带屏音箱] 第三方认证流程

星空无限传媒xk8027-高清全集免费看

一、TUTK服务第三方认证核心逻辑

TUTK服务在使用前，需验证用户是否有权使用该服务，核心逻辑如下：

1. TUTK服务API必须包含服务所需的域（realm）及其他必要参数；
2. TUTK服务需预设"realm（领域）"与"验证API"的映射关系；
3. "validation"为自定义验证数据，若为二进制数据需进行base64编码；
4. 当TUTK服务需要验证用户时，根据"realm"调用对应的验证API，并将"validation"传递给第三方服务器；
5. 仅当第三方验证服务返回200状态码时，用户方可使用服务。

（一）验证流程示意图

（二）验证接口定义

1. 接口请求信息

请求项	具体说明
请求方法	POST
请求地址	https://3rd-party-service-domain/{api}（{api}由第三方自定义）
请求头	Content-Type: `application/json` Authorization: `{authType} {authToken}`

2. 请求参数说明

参数位置	参数名	类型	是否必填	说明
请求头	`authToken`	String	是	需要验证的token
请求头	`authType`	String	是	token类型（如JWT、Bearer等）
请求体	`validation`	String	是	自定义验证数据，二进制数据需base64编码，验证者需解码后校验
请求体	可选参数	-	否	无

3. 响应参数说明

响应类型	参数名/状态码	类型	是否必填	说明
响应体（200状态）	`validateId`	String	是	验证服务器确认用户有效的标识
响应体（200状态）	`extraInfo`	String	否	服务调用方可用的额外信息
状态码	`200`	-	-	用户合法，验证通过
状态码	`401`	-	-	用户非法，验证失败（无响应体）

（三）请求与响应示例

1. 验证请求示例（curl）

第三方认证验证请求（curl命令）

// 验证请求curl示例 curl -XPOST \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer thisisthetoken' \ -d '{ "validation": "SSEEDDGGEEDSSaasllkiiksie" }' \ https://3rd-party-service-domain/{api}

2. 验证响应示例

合法用户响应（HTTP 200）

{ "validateId": "123456767889", "extraInfo": "extraInfo" }

注意事项

validation参数若为二进制数据，必须先进行base64编码，第三方验证服务器需解码后再校验；
TUTK服务需提前配置realm与第三方验证API的映射关系，确保验证请求能准确路由；
仅当第三方验证返回200状态码时，视为验证通过，其他状态码均视为验证失败；
接口请求地址中的{api}由第三方自定义，需在realm映射配置中明确对应关系；
Authorization请求头格式固定为"authType + 空格 + authToken"，不可省略空格。