远程鉴权配置

Recent Pages

远程鉴权配置

最后更新时间：2024-04-29 16:18:06

远程鉴权是指在腾讯云推流/播放防盗链验证通过后，调用客户的业务服务端接口，将请求转发至客户的业务服务，客户判定请求合法性后将结果返回给腾讯云，腾讯云根据返回结果执行相应动作：允许或拒绝访问。 需要客户自行开发并指定远程鉴权服务器，由该鉴权服务器对用户请求进行校验。实现更加精准的鉴权，保障直播安全。
流程说明
远程鉴权的使用流程如下：
﻿
﻿
序号
说明
1
终端用户对云直播服务发起请求。
2
云直播判断请求对应的域名若配置了远程鉴权，会根据远程鉴权配置，对请求进行处理后，转发至客户的远程鉴权服务器。
3
客户的远程鉴权服务器返回鉴权结果，HTTP 状态码为 200 代表放行，403 代表拦截。
4
云直播根据鉴权结果来决定是否继续响应该用户的请求。
前提条件
已开通云直播服务，并登录 云直播控制台。
已添加 播放域名。
配置远程鉴权
1. 登录云直播控制台，选择 域名管理，单击需要配置远程鉴权的播放域名或右侧的管理，进入域名管理页。
﻿
﻿
﻿
2. 在 访问控制 > 远程鉴权中，可选择开启或关闭远程鉴权配置。
﻿
﻿
﻿
﻿
3. 单击
﻿
按钮，选择开启远程鉴权，并进行如下配置：
﻿
﻿
﻿
配置项
﻿
说明
远程鉴权地址
﻿
远程鉴权地址是客户侧远程鉴权服务器的地址，必填项，规则：http(s)://+域名或IP+端口+路径。
请求方法
﻿
默认选择 POST，可选择 HEAD 或 GET。
URL鉴权参数
保留参数设置
默认选择保留所有参数，可选择保留指定参数或删除所有参数。
 当选择保留指定参数时，需在输入框内输入要保留的参数，暂不支持中文，多个参数间用 | 分隔，例如：value1|value2。
﻿
添加自定义参数
单击添加，参数类型可选择参数或自定义。（最多可添加50个参数）
选择参数支持选择 host、uri、client_ip、cdn_ip 参数。
host 参数代表：播放域名。
uri 参数代表：请求原始 URL。
client_ip 参数代表：请求客户端 IP。
cdn_ip 参数代表：请求 CDN 侧 IP。
选择自定义，参数和取值的输入框为必填项，需要填写相关信息；暂不支持中文，URL 鉴权参数区分大小写，key 和 KEY 为两个不同参数。
请求头鉴权参数
保留请求头设置
默认选择保留所有参数，可选择保留指定参数或删除所有参数。
当选择保留指定参数时，需在输入框内输入要保留的参数，暂不支持中文，多个参数间用 | 分隔，例如：value1|value2。
﻿
添加自定义参数
单击添加，参数类型可选择参数或自定义。（最多可添加50个参数）
选择参数支持选择 User-Agent、Referer、X-Forwarded-For 参数：
User-Agent 参数代表：用户所使用的系统和浏览器信息；
Referer 参数代表：指定网页的跳转来路；
X-Forwarded-For 参数代表：伪装访问链接。
选择自定义，参数和取值的输入框为必填项，需要填写相关信息；暂不支持中文，请求头鉴权参数不区分大小写。
单次鉴权请求超时时长（ms）
﻿
必填项，默认3000ms，支持的取值范围为500 - 3000ms。
超时重试次数
﻿
默认1次，支持的取值范围为0次 - 3次。
超时执行动作
﻿
默认放行，支持选择拦截。
当单次鉴权请求超时时长 ×（重试次数+1）时长后仍未收到明确的响应结果（HTTP 状态码为200或403），系统将执行设置的超时执行动作。
异步鉴权
﻿
异步鉴权是默认关闭，您可以根据自己的业务需求手动开启该功能。
开启后，播放时不再等待远程鉴权结果，可以先播放，若后续拿到远程鉴权结果失败，再断开播放，避免同步远程鉴权耗时导致首屏时间增加的问题。异步鉴权模式下，HLS协议中的ts和m3u8鉴权不生效，将继续保持同步鉴权。
4. 单击保存即可保存配置。
注意：
远程鉴权功能配置完成后约10分钟生效，请耐心等待。
﻿
﻿
﻿
修改远程鉴权
1. 登录云直播控制台，选择 域名管理，单击需要配置远程鉴权的播放域名或右侧的管理，进入域名管理页。
﻿
﻿
﻿
2. 在访问控制 > 远程鉴权中，单击编辑进入远程鉴权配置页。
3. 根据您的实际需求修改配置项信息，单击保存即可完成修改。
﻿
﻿
﻿
关闭远程鉴权
1. 登录云直播控制台，选择 域名管理，单击需要关闭远程鉴权的播放域名或右侧的管理，进入域名管理页。
﻿
﻿
﻿
2. 在访问控制 > 远程鉴权中，单击
﻿
按钮，选择关闭远程鉴权。
﻿
﻿
﻿
3. 关闭远程鉴权配置，预计10分钟后生效，单击确定即可。
﻿
﻿
﻿

联系我们

联系我们，为您的业务提供专属服务。

技术支持

如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

7x24 电话支持

tencent cloud

Recent Pages

远程鉴权配置

流程说明

前提条件

配置远程鉴权

修改远程鉴权

关闭远程鉴权

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？

序号	说明
1	终端用户对云直播服务发起请求。
2	云直播判断请求对应的域名若配置了远程鉴权，会根据远程鉴权配置，对请求进行处理后，转发至客户的远程鉴权服务器。
3	客户的远程鉴权服务器返回鉴权结果，HTTP 状态码为 200 代表放行，403 代表拦截。
4	云直播根据鉴权结果来决定是否继续响应该用户的请求。

配置项			说明
远程鉴权地址			远程鉴权地址是客户侧远程鉴权服务器的地址，必填项，规则：http(s)://+域名或IP+端口+路径。
请求方法			默认选择 POST，可选择 HEAD 或 GET。
URL鉴权参数	保留参数设置	默认选择保留所有参数，可选择保留指定参数或删除所有参数。当选择保留指定参数时，需在输入框内输入要保留的参数，暂不支持中文，多个参数间用 \| 分隔，例如`：value1\|value2`。
URL鉴权参数		添加自定义参数	单击添加，参数类型可选择参数或自定义。（最多可添加50个参数）选择参数支持选择 host、uri、client_ip、cdn_ip 参数。 host 参数代表：播放域名。 uri 参数代表：请求原始 URL。 client_ip 参数代表：请求客户端 IP。 cdn_ip 参数代表：请求 CDN 侧 IP。选择自定义，参数和取值的输入框为必填项，需要填写相关信息；暂不支持中文，URL 鉴权参数区分大小写，key 和 KEY 为两个不同参数。
请求头鉴权参数	保留请求头设置	默认选择保留所有参数，可选择保留指定参数或删除所有参数。当选择保留指定参数时，需在输入框内输入要保留的参数，暂不支持中文，多个参数间用 \| 分隔，例如：`value1\|value2`。
请求头鉴权参数		添加自定义参数	单击添加，参数类型可选择参数或自定义。（最多可添加50个参数）选择参数支持选择 User-Agent、Referer、X-Forwarded-For 参数： User-Agent 参数代表：用户所使用的系统和浏览器信息； Referer 参数代表：指定网页的跳转来路； X-Forwarded-For 参数代表：伪装访问链接。选择自定义，参数和取值的输入框为必填项，需要填写相关信息；暂不支持中文，请求头鉴权参数不区分大小写。
单次鉴权请求超时时长（ms）			必填项，默认3000ms，支持的取值范围为500 - 3000ms。
超时重试次数			默认1次，支持的取值范围为0次 - 3次。
超时执行动作			默认放行，支持选择拦截。当单次鉴权请求超时时长 ×（重试次数+1）时长后仍未收到明确的响应结果（HTTP 状态码为`200`或`403`），系统将执行设置的超时执行动作。
异步鉴权			异步鉴权是默认关闭，您可以根据自己的业务需求手动开启该功能。开启后，播放时不再等待远程鉴权结果，可以先播放，若后续拿到远程鉴权结果失败，再断开播放，避免同步远程鉴权耗时导致首屏时间增加的问题。异步鉴权模式下，HLS协议中的ts和m3u8鉴权不生效，将继续保持同步鉴权。

tencent cloud

注册

登录

Recent Pages

远程鉴权配置

流程说明

前提条件

配置远程鉴权

﻿﻿﻿

修改远程鉴权

关闭远程鉴权

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？