tencent cloud

云直播

动态与公告
公告
新手指南
产品简介
产品概述
子产品简介
基本概念
产品功能
应用场景
产品优势
使用限制
购买指南
计费概述
基础服务费
增值服务费
预付费资源包
购买流程
计费变更
退款说明
账单查询
续费说明
欠费停服说明
计费常见问题
标准直播
概述
应用场景
快速入门
SDK 接入说明
快直播(超低延时直播)
概述
快直播和标准直播区别
应用场景
快速入门
SDK 接入说明
云导播台
概述
应用场景
功能区介绍
云导播台管理
通用云导播
配置节目单和自动导播
控制台指南
控制台介绍
概览
域名管理
流管理
资源包管理
AI 智能
功能配置
拉流转推
计费用量
业务监控
常用工具
无忧直播
CAM 访问控制
功能实践
直播推流与播放
直播增值功能
典型场景实践
云端原生录制
直播安全
海外直播
回调事件消息通知
常见第三方工具指南
SDK 实践
0. SDK 接入引导
1. 推流
2. 播放
3. 高级功能
API 文档
History
Introduction
API Category
Making API Requests
Live Pad APIs
Live Stream Mix APIs
Time Shifting APIs
Monitoring Data Query APIs
Billing Data Query APIs
Live Transcoding APIs
Delayed Playback Management APIs
Domain Name Management APIs
Watermark Management APIs
Certificate Management APIs
Stream Pulling APIs
Recording Management APIs
Live Callback APIs
Screencapturing and Porn Detection APIs
Authentication Management APIs
Live Stream Management APIs
Data Types
Error Codes
运维指南
优化视频卡顿
推流失败问题排查
播放失败问题排查
CLS 协助直播问题排查
直播延迟问题排查
拉流视频质量不清晰问题排查
COS bucket 授权给直播实现截图存储
故障处理
直播混流报错:InvalidParameter.OtherError
常见问题
服务地区相关
直播基础相关
推流播放相关
直播计费相关
直播海外相关
直播录制相关
云端混流相关
域名配置相关
云导播台相关
适配苹果 ATS 相关
服务等级协议
云直播服务等级协议
CSS 政策
隐私协议
数据处理和安全协议
词汇表

UA 黑白名单配置

PDF
聚焦模式
字号
最后更新时间: 2025-12-03 17:56:23
云直播支持通过配置 User-Agent 黑白名单规则来实现访问控制。这种方法根据用户 HTTP 请求头中的 User-Agent 信息进行规则判断,以按需放行或拒绝用户访问。

配置原理

配置 UA 白名单:只有配置的 UA 内容能够访问当前直播内容。
配置 UA 黑名单:只有配置的 UA 内容无法访问当前直播内容。

注意事项

开启/关闭 UA 黑白名单,预计15 - 20分钟生效。
若同时配置了 UA 鉴权和其他鉴权方式,优先级顺序为:协议 > IP > 地域 > UA。系统会首先按照协议进行鉴权,然后是 IP、地域,最后才是 UA。

前提条件

已开通云直播服务,并登录 云直播控制台
已添加 播放域名

配置 UA 黑白名单

1. 选择 域名管理,单击需要配置 UA 黑名单的播放域名或右侧的管理,进入域名管理页。

2. 访问控制 > UA 黑白名单配置中,单击

开启 UA 黑白名单。


3. 开启 UA 黑白名单后,进入 UA 黑白名单配置页,并进行如下配置:
黑名单
白名单






配置项
说明
鉴权类型
单击选择配置 UA 白名单黑名单
白名单和黑名单互斥,同一时间仅可生效一种。
空 UA
空 User-Agent 功能默认关闭,支持手动开启。
空 User-Agent 开启后:
黑名单场景下,UA值为空或者不存在UA字段时均允许请求。
白名单场景下,UA值为空时拒绝请求,不存在UA字段时允许请求。
鉴权内容
支持通配符*和多个值,每行一个值,多个值请分行填写,不支持输入英文分号;如:
curl*
*IE*
*Chrome*
*Firefox*
鉴权内容区分大小写,最大支持长度为100个字符。
4. 单击确定即可保存配置。
说明:
UA 黑白名单功能配置完成后约10分钟生效,请耐心等待。

修改 UA 黑白名单

1. 选择 域名管理,单击需修改 UA 黑白名单配置的播放域名或右侧的管理 ,进入域名管理页。

2. 访问控制 > UA 黑白名单配置中,单击编辑进入 UA 黑白名单配置页。

3. 根据您的实际需求修改配置项信息,单击保存即可完成修改。

关闭 UA 黑白名单

开启 UA 黑白名单后,若您需关闭此功能,具体操作如下:
1. 选择 域名管理,单击需关闭 UA 黑白名单配置的播放域名或右侧的管理,进入域名管理页。

2. 访问控制 > UA 黑白名单配置中,单击
img

,选择关闭 UA 黑白名单。

3. 在关闭 UA 黑白名单时,系统会弹出确认窗口。单击确定即可关闭功能。请注意,关闭后预计需要15-20分钟才能生效。


帮助和支持

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

填写满意度调查问卷,共创更好文档体验。

文档反馈