Cookie黑白名单_访问控制_Dynamic Web Acceleration-文档中心

Cookie是网站为了识别用户身份和跟踪会话而存储在用户本地终端的数据。当用户再次访问同一网站时，浏览器会自动将存储的Cookie发送到服务器，这使得服务器能够通过Cookie信息实现访问控制。当CDN节点接收到来自客户端的请求时，它会检查HTTP请求头中的Cookie字段，并根据预设的Cookie黑白名单，决定允许或禁止某些用户的请求。

如何设置Cookie黑白名单

登录您的CDNetworks账号，控制台选择对应的产品。
在域名管理界面，选择您需要配置Cookie黑白名单的域名，单击修改配置。
选择左侧配置导航栏的访问控制-Cookie黑白名单，并单击添加。
根据您的需要，配置以下配置项。

生效范围
访问的生效范围，即配置针对哪些请求进行Cookie黑白名单的访问控制。这里我们提供如下生效范围供您选择。

配置项	说明
所有请求	即该访问控制规则，将所有类型的请求都生效。
仅首页	仅针对域名根目录格式的请求生效，比如`http://domain/`或`https://domain/`。
指定文件类型	仅对特定类型的文件生效，您可以在左侧选择对应的文件类型，也可以自定义文件类型。对于自定义文件类型，多个文件类型之前请通过分号`;`分割，例如：`jpg;png`。
指定URI	访问控制仅对指定URI的内容请求生效，这里我们提供两种URI匹配模式，精准匹配和忽略参数匹配。精准匹配：指定完整的URI，包括参数。比如，`path/index.html?abc=123`。忽略参数匹配：仅填入问号前的路径，无需指定参数。比如，`path/index.html`。
指定目录	仅对部分目录下的请求进行访问控制，比如，当配置为`/file/abc/`表示对`http://domain/file/abc/*`下所有的内容都会生效。注意：目录必须以`/`作为开头和结尾，只能包含由字母、数字及部分特殊符号（包含下划线、减号、百分号、点）任意组合，当有多个目录时，目录间需要进行换行分隔。
URL正则匹配	通过正则表达式来控制生效范围。比如`*.jpg$`代表访问控制将对所有的以`jpg`结尾的URL生效。

规则类型
您可以设置Cookie黑名单或者Cookie白名单。

类型	说明
Cookie黑名单	当请求的Cookie中包含特定内容时，将禁止访问指定生效范围内的资源。
Cookie白名单	只有当请求的Cookie中包含特定内容时，才允许访问指定生效范围内的资源。

该配置需要通过正则表达式来指定Cookie的内容，例如，GOOGLE=70238C3E代表匹配所有Cookie中含有GOOGLE=70238C3E的请求。
最多只支持添加一条Cookie白名单配置。当您有多个白名单规则时，请添加在同一条白名单配置中。

控制动作
当请求携带的Cookie不符合设定的规则，用户的请求被CDN拒绝时，直接返回错误码还是跳转到其他URL。其中：

禁止访问：访问校验不通过的请求，CDN返回403。
跳转URL：访问校验不通过的请求，CDN返回跳转的URL。您需要在跳转到URL中指定URL跳转的页面。

允许空Cookie访问
配置白名单后，是否允许cookie为空的请求访问。

优先级
当您配置了多条访问控制规则，CDN将按照优先级大小先后执行，数字大的规则将被优先执行判断。

部署到线上

完成上述配置后，请点击确认，然后选择下一步提交您的配置。为了避免配置影响您的生产环境，我们推荐您先预部署，把配置生效到测试环境中。测试环境与线上环境完全隔离，确保不会对您的线上服务造成任何影响。预部署完成后，我们将提供测试环境的IP地址，您可以通过设置本地HOST将域名绑定到这些IP地址，以验证配置的有效性。关于预部署测试的更多细节，请参考相关教程通过预部署来验证配置是否生效。
当配置确定无误后，单击直接部署将配置正式生效到线上环境，通常约3-5分钟后，配置将正式生效到线上环境。