嵌入页第三方K值验证

Vhall 网络直播在网页嵌入、sdk 等集成方式中，支持免费、密码验证方式，如需涉及权限控制，Vhall 提供以下认证流程来实现简单的权限认证过程。

开启设置

1.全局配置：针对所有的活动配置生效，如果针对单个活动再做配置，以单个活动配置为最终配置，设置接口：设置全局第三方 K 值

2.单个活动单 K 值配置：，设置接口：设置/修改单个活动 K 值，针对某个活动做配置，参数 use_global_k,是否针对此活动开启全局 K 值配置（默认为 0 不开启，1 为开启）；当设置为 0 后，则以单个活动的配置为最终配置

3.单个活动多 K 值配置：1）调用接口新增活动多 K 值，对单个活动设置多个 K 值，单个活动最高支持 10 条 K 值；2）完成多 K 值设置后，调用接口设置/修改单个活动 K 值，开启活动 K 值验证并关闭全局验证，此接口也可用于 K 值修改。

认证流程

流程说明

1.用户使用 Vhall 接口，接口 URL 中请务必带传递上 k 值的参数（网页嵌入参数名为 k,sdk 参数名为 pass），如果是多 K 值活动需要再带上 k_id(由设置/修改单个活动 K 值返回)，参数为空或者没有这个参数，则视为认证失败

2.针对多 K 值活动，系统会根据活动 id 和 k_id 来匹配回调验证地址，错传漏传都会导致验证不通过

3.Vhall 系统收到用户的接口访问请求后，会向第三方认证 URL(curr_url)发送 HTTP POST 请求，同时将 k 值和 email、third_user_id 作为 POST 数据提交给第三方认证

4.由第三方系统验证 k 值的合法性。如果认证通过，第三方认证 URL(curr_url)返回无 bom 字符串 pass,否则的返回 fail

5.Vhall 系统根据第三方认证 URL 返回值判断认证是否成功。只有收到 pass，才能认定为验证成功，否则网页嵌入方式跳转到指定的认证失败 URL(fail_url)，sdk 提示'非法访问'

参数特征

URL 请求很容易被探测截获，这就要求第三方系统生成的 K 值必须有以下特征：

唯一性：每次调用接口必须产生不同的 K 值

时效性：设定一个时间范围，超时的 K 值即失效。

如果包含有第三方系统内部信息，必须加密和混淆过。

建议的 K 值实现

第三方系统可以考虑 K 值元素包括：用户 ID、Vhall 直播 ID、时间戳（1970-01-01 至今的秒数）元素组合后加密后，使用 Base64 或者 hex 匹配成 URL 可识别编码。K 值在第三方系统中持久化或放在 Cache 中回调验证时，根据时间戳判断是否在设定时间内有效验证结束，若认证通过，则从 DB 或 Cache 中移除 K 值 DB 或 Cache 建议有时效性控制，自动失效或定期清理过期数据

第三方验证接收参数

请求方式：POST

请求参数格式：application/x-www-form-urlencoded

请求参数：

参数	类型	描述
k	string	调用 vhall 嵌入页时传入的 k 值参数
email	string	调用 vhall 嵌入页时传入的 email 参数
refer	string	固定值：vhall
third_user_id	string	调用 vhall 嵌入页时传入的 third_user_id 参数，如未传，则无此字段

需返回 vhall 参数

意义	值	备注
成功	pass
失败	fail

嵌入页第三方K值验证

开启设置#

认证流程#

流程说明#

参数特征#

建议的 K 值实现#

第三方验证接收参数#