如何设置防盗链？
描述
设置加速域名的Refer防盗链功能
请求参数
| 参数名 | 类型 | 必须？ | 说明 |
| Action | String | 是 | 操作接口名，系统规定参数，取值：SetRefererConfig |
| DomainName | String | 是 | 您的加速域名 |
| ReferType | String | 是 | refer类型，取值：block：黑名单；allow：白名单 |
| ReferList | String | 否 | 逗号隔开的域名列表 |
| AllowEmpty | String | 否 | 是否允许空refer访问,取值：on：允许；off：不允许；默认值：on |
返回参数
| 名称 | 类型 | 描述 |
| RequestID | String | 该条任务请求ID |
特殊错误码
| 错误代码 | 描述 | Http 状态码 | 语义 |
| InvalidReferType.ValueNotSupported | The specified value of parameter ReferType is not supported. | 400 | 指定的 ReferType 不合法（超出可选范围） |
| InvalidAllowEmpty.ValueNotSupported | The specified value of parameter AllowEmpty is not supported. | 400 | 指定的 AllowEmpty 不合法（超出可选范围） |
| InvalidReferList.Malformed | The specified value of parameter ReferList is malformed. | 400 | 指定的 ReferList 不合法（格式错误） |
示例
请求示例：
http://cdn.aliyuncs.com/?Action=SetRefererConfig
&DomainName=www.macaron.org.cn
&ReferList=www.aliyun.com%2Cwww.taobao.com
&ReferType=allow
&AllowEmpty=on
&<公共请求参数>
返回示例
JSON格式：
- [backcolor=transparent]{
- [backcolor=transparent] [backcolor=transparent]"RequestId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"04F0F334-1335-436C-A1D7-6C044FE73368"
- [backcolor=transparent]}
XML格式：
<SetRefererConfigResponse>
<RequestId>AED00EC1-32A8-4D48-BEB9-BD782AF3C6BD</RequestId>
</SetRefererConfigResponse>
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
在阿里云CDN服务中，设置加速域名的Refer防盗链功能是一项重要的安全配置，它可以帮助你控制哪些外部网站可以引用你的CDN资源，从而防止未经授权的访问和盗用。根据您提供的信息，下面是如何使用API来设置这一功能的详细说明：
请求参数说明
-
Action: 必须参数，固定值
SetRefererConfig，表示设置Refer防盗链配置的操作。 -
DomainName: 必须参数，类型为String，填写你需要设置防盗链的加速域名。
-
ReferType: 必须参数，类型为String，指定refer类型的策略，可选值为：
block: 表示黑名单模式，列出的域名将被禁止访问。allow: 表示白名单模式，只有列出的域名可以访问。
-
ReferList: 可选参数，类型为String，当你设置了ReferType后，需要提供一个逗号分隔的域名列表。这些域名根据ReferType的设定（允许或阻止）来决定访问权限。
-
AllowEmpty: 可选参数，默认值为
on，类型为String，用于控制是否允许空refer头的访问：on: 允许空refer访问。off: 不允许空refer访问。
返回参数说明
- RequestID: String类型，返回该条任务请求的唯一标识ID，可用于追踪操作状态。
特殊错误码
-
InvalidReferType.ValueNotSupported: HTTP状态码400，表示指定的ReferType值不支持，即超出
block或allow这两个合法选项。 -
InvalidAllowEmpty.ValueNotSupported: HTTP状态码400，意味着指定的AllowEmpty值不合法，只接受
on或off。 -
InvalidReferList.Malformed: HTTP状态码400，指出ReferList格式错误，可能是因为输入的域名格式不正确或不符合规范。
示例请求
http://cdn.aliyuncs.com/
?Action=SetRefererConfig
&DomainName=your.accelerate.domain.com
&ReferType=allow
&ReferList=example.com,anotherallowed.com
&AllowEmpty=on
在这个示例中，我们为域名your.accelerate.domain.com设置了Refer防盗链的白名单模式，允许example.com和anotherallowed.com这两个域名访问，并且允许空referer访问。
请确保在实际操作前，已获取并设置好阿里云的AccessKey ID和AccessKey Secret，并通过签名机制对请求进行授权，以保证请求的安全性。此外，也可以通过阿里云的管理控制台或者SDK来进行这项配置，以获得更直观和便捷的操作体验。
