tencent cloud

UA 黑白名单配置
下载PDF
最后更新时间：2025-01-13 10:21:58
UA 黑白名单配置
最后更新时间： 2025-01-13 10:21:58
下载PDF

配置场景

腾讯云 CDN 支持通过配置 User-Agent 黑白名单规则实现访问控制。 通过对用户 HTTP 请求头中的 User-Agent 进行规则判断，按需放行或拒绝用户访问。

配置指南

配置约束

仅支持全部设置为黑名单或全部设置为白名单，不支持同时设置黑、白名单规则。
最多可配置 10 条黑或白名单规则。
规则内容支持通配符*，多个值情况下使用 |分隔。
生效类型支持全部文件、文件类型、文件目录、指定文件路径四种模式，暂不支持正则匹配。

配置说明

登录 CDN 控制台，在菜单栏里选择【域名管理】，单击域名右侧【管理】，即可进入域名配置页面，第二栏【访问控制】中可看到 UA 黑白名单配置，默认情况下为关闭状态：

关闭状态下，单击【新增规则】，可按需逐条添加黑(白)名单：


注意：
1. 支持通配符*和多个值，如 curl*|*IE*|*Chrome*|*firefox*。
^$ 表示为空的User-Agent，如果规则内容中包含了为空的User-Agent，按照如下方式处理：
白名单场景下，如果请求中的 User-Agent 为空，则允许该请求。
黑名单场景下，如果请求中的 User-Agent 为空，则拒绝该请求。
2. 无*情况下，其他字符均为完全匹配。
规则添加完成后，此时整体配置为关闭状态，因此不会影响现网服务：

可通过单击【开启】按钮，将所配置的黑(白)名单发布至现网：



配置示例

若加速域名cloud.tencent.com的 UA 黑白名单配置如下：

当 HTTP Request Header 中 User-Agent 如下时：
user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.61 Safari/537.36
命中黑名单，将直接返回403。
本页内容是否解决了您的问题？
您也可以 联系销售 或 提交工单 以寻求帮助。
是
否

文档反馈