功能介绍

User-Agent（简称UA）是HTTP请求头的一部分，包含用户访问时所使用的操作系统及版本、浏览器类型及版本等标识信息，因此User-Agent是访客身份的象征，标志访客访问时所使用的工具，通过识别HTTP请求中的User-Agent字段中包含的部分信息，可以规范访客的行为，拦截或允许某一类访客的访问，实现防盗链、防盗刷、防攻击的目的。

• User-Agent白名单：用于配置允许用户使用的访问工具，UA白名单之外的访问工具全部拒绝访问（节点响应403），UA白名单之内的访问工具全部允许访问。
• User-Agent黑名单：用于配置禁止用户使用的访问工具，UA黑名单之外的访问工具全部允许访问，UA黑名单之内的访问工具全部拒绝访问（节点响应403）。

注意事项

1. UA黑名单与UA白名单只能二选一，不可同时配置，为互斥关系。
2. 如果用户请求中携带的User-Agent字段的值命中User-Agent黑名单中的值，则该请求仍可访问到CDN加速节点，但是会被CDN加速节点拒绝并返回403状态码。

配置说明

1. 登录CDN控制台。
2. 单击左侧导航栏【域名管理】-【域名列表】。
3. 在【域名列表】页面，找到目标域名，单击【操作】列的【编辑】。
4. 单击右侧【访问控制】。
5. 在【UA黑白名单】模块，开启功能。
6. 设置类型，选择【白名单】或【黑名单】，使用换行符分隔，使用正则表达式匹配。
7. 单击【保存】，完成配置。

配置示例

示例一：配置UA黑名单

结果说明：当客户端UA包含Chrome字段时，不允许访问该域名下的所有资源，响应403状态码。

示例二：配置UA白名单

结果说明：只有客户端UA包含Firefox时，才能允许访问该域名下的所有资源。