远程鉴权配置

背景信息

远程鉴权功能类似URL鉴权，区别如下：

• URL鉴权：鉴权由CDN节点完成。
• 远程鉴权：CDN节点转发用户请求到您指定的鉴权服务器，由鉴权服务器完成鉴权功能。

远程鉴权用户请求流程如下：

图1 远程鉴权流程

注意事项

• 远程鉴权功能默认关闭。
• 后台有特殊配置的域名，暂不支持使用远程鉴权功能。

操作步骤

1. 登录华为云控制台，在控制台首页中选择“CDN与智能边缘 > 内容分发网络 CDN”，进入CDN控制台。
2. 在左侧菜单栏中，选择“域名管理”。
3. 在域名列表中，单击需要修改的域名或域名所在行的“设置”，进入域名配置页面。
4. 选择“访问控制”页签，单击“远程鉴权配置”，进入配置弹窗。
   图2 配置远程鉴权
   

   表2 参数说明

   参数	说明	示例
   鉴权服务器地址	可访问的服务器地址。 输入的URL必须带有“http”或“https”。 不能是localhost或127.0.0.1这类本地地址。 不能是CDN的加速域名。 远程鉴权服务器默认为80/443端口，如需修改，请提交工单申请。	https://example.com/auth
   请求方法	鉴权服务器支持的请求方法，支持GET、POST、HEAD。	GET
   鉴权文件类型	所有文件类型：所有文件均参与鉴权。 指定文件类型：指定类型的文件参与鉴权。 示例：jpg|MP4。 文件类型不区分大小写，即：jpg和JPG代表同一种文件类型，多个文件类型用“|”分割。	所有文件类型
   保留参数设置	设置用户请求中需要参与鉴权的参数，可选保留所有URL参数、忽略所有URL参数、保留指定URL参数。 参数填写规范：不区分大小写，多个参数用“|”分割。	保留所有URL参数
   自定义URL参数	设置CDN节点转发用户请求到远程鉴权服务器时需添加的参数。您可以选择预设参数或自定义参数（参数值不区分大小写）。 自定义：不支持变量，采用字符串形式下发。 选择参数：选择预设的参数或自定义参数，取值支持配置变量。	选择参数：http_host 取值：$http_host
   保留请求头设置	设置用户请求中参与鉴权请求头，可选保留所有请求头参数、保留指定请求头参数、忽略所有请求头参数。 参数填写规范：不区分大小写，多个参数用“|”分割。	保留所有请求头参数
   自定义请求头参数	设置CDN节点转发用户请求到远程鉴权服务器时需要添加的请求头，可以选择系统预设的请求头，也可以自定义请求头（参数值不区分大小写）。 自定义：不支持变量，采用字符串形式下发。 选择参数：选择预设的参数或自定义参数，取值支持配置预设变量。	选择参数：http_referer 取值：$http_referer
   鉴权成功状态码	设置鉴权成功时远程鉴权服务器返回给CDN节点的状态码。 取值范围：2xx/3xx。	200
   鉴权失败状态码	设置鉴权失败时远程鉴权服务器返回给CDN节点的状态码。 取值范围：4xx/5xx。	403
   响应自定义状态码	设置鉴权失败时CDN节点返回给用户的状态码。 取值范围：2xx/3xx/4xx/5xx。	403
   鉴权超时时间	设置从CDN转发鉴权请求开始，到CDN节点收到远程鉴权服务器返回的结果为止的时间。单位为毫秒，值为0或50~3000。	60
   鉴权超时之后的动作	设置鉴权超时后，CDN节点如何处理用户请求。 通过：鉴权超时后允许用户请求，返回对应的资源。 拒绝：鉴权超时后拒绝用户请求，返回配置的响应自定义状态码给用户。	拒绝

   表3 预设参数

   变量名	变量含义	说明
   $http_host	请求头中的Host值。	只有客户端请求携带这些值时才可以获取到。
   $http_user_agent	请求头中的User-Agent值。
   $http_referer	请求头中的Referer值。
   $http_x_forwarded_for	请求头中的X-Forwarded-For值。
   $http_content_type	请求头中的Content-Type值。
   $remote_addr	请求的Client IP信息。	-
   $scheme	请求的协议类型。	-
   $server_protocol	请求的协议版本。	-
   $request_uri	uri+'?'+args的内容。	-
   $uri	请求的原始URI。	-
   $args	请求的query string，不包含'?'。	-
   $request_method	请求方法。	-

5. 根据参数提示填写相关参数，单击“确定”完成配置。
6. （可选）关闭远程鉴权配置。
   • 关闭“状态”开关即可关闭远程鉴权配置，此时所有配置将被清空，下次启用远程鉴权功能时需要重新配置相关参数。