UA 黑白名单配置

最近更新时间:2025-05-16 11:21:53

我的收藏
云直播支持通过配置 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分钟才能生效。