远程鉴权功能是一种访问控制功能，用于保护资源。远程鉴权是指对发送到阿里云CDN边缘节点上的用户请求进行校验，并根据鉴权服务器返回的校验结果来判断如何处理用户的请求。开启远程鉴权意味着资源只能被授权成功的用户访问。本文介绍远程鉴权的实现原理及控制台开启远程鉴权步骤，并提供相关API参考。
实现原理
视频点播服务同时支持URL鉴权和远程鉴权功能以避免站点资源被非法下载或盗用。这两个功能在技术实现方案上有如下差异：
URL鉴权：您把域名的鉴权规则下发给CDN节点，由CDN节点完成鉴权的整个数据交互流程。更多关于URL鉴权的信息，请参见URL鉴权。
远程鉴权：您需要有自己单独设置的鉴权服务器，CDN节点收到需要鉴权的用户请求后，需要把用户请求转发给鉴权服务器完成鉴权，鉴权服务器由您自主管理。
远程鉴权的实现原理如下：
用户发起的资源访问请求到达CDN节点，请求中携带了鉴权参数。
CDN节点收到用户请求，将用户请求转发给鉴权服务器。
鉴权服务器根据用户请求中携带的鉴权参数给出鉴权结果，并返回给CDN节点。
CDN节点根据鉴权服务器返回的鉴权结果来判断如何处理用户的请求。鉴权成功即允许访问，鉴权失败会拒绝访问或进行相应的限制。鉴权结果举例说明如下：
举例1：鉴权成功，CDN节点与用户开始正常的缓存数据访问交互。
举例2：鉴权失败，CDN节点返回403状态码给用户。
举例3：鉴权失败，CDN节点对用户访问进行限速。
举例4：鉴权超时，CDN节点执行鉴权超时的默认动作，即放行用户请求。
使用说明
开启远程鉴权功能后，用户的每次请求都要鉴权，当请求访问量大时，需考虑鉴权服务器的压力和性能。
操作步骤
登录视频点播控制台。
在点播控制台左侧导航栏选择配置管理。
单击分发加速配置 > 域名管理，进入域名管理页面。
选择您要配置的域名，单击配置。
单击访问控制。
单击远程鉴权页签。
开启远程鉴权，配置远程鉴权信息。
参数和说明如下表所示：参数
说明
鉴权服务器地址
鉴权服务器对外可以访问的地址。系统会对您输入的鉴权服务器地址进行校验，包括格式校验和值校验。
格式要求
格式必须为以下几种类型之一：
http://example.com/auth
https://example.com/auth
http://192.0.2.1/auth
https://192.0.2.1/auth
值要求
值不能包含127.0.0.1和localhost，因为这类本地地址属于无效地址。
请求方法
鉴权服务器支持的请求方法。支持GET、HEAD和POST这三种请求方法。
POST
参数在请求体中传输，地址栏不变。
理论上没有限制数据传输的大小。
请求不会被缓存，也不会被保留在浏览器历史记录中。
安全性相对较高。
GET
参数在请求行中传输，地址栏会显示提交的参数值。
受浏览器限制，数据传输最大支持1024字节。
请求可被缓存，也会被保留在浏览器历史记录中。
安全性相对较低。
HEAD
HEAD和GET方法相同，只是服务器响应时，HEAD不返回请求体。
鉴权文件类型
所有文件类型：所有的文件类型都参与鉴权。
指定文件类型：仅指定的文件类型参与鉴权。
指定文件类型时，多个文件类型用竖线（|）分隔，例如：mp4|flv。
文件类型区分大小写，即jpg和JPG是两种不同的文件类型。
保留参数设置
用于控制用户请求URL中需要参与鉴权的参数。可以选择保留所有参数、保留指定参数和删除所有URL参数。
保留指定参数时，多个参数用竖线（|）分隔，例如：user|token。
参数区分大小写，即key和KEY是两种不同的参数。
添加自定义参数
为CDN节点转发给鉴权服务器的请求URL添加自定义参数。
您可以选择自定义设置参数和取值，也可以选择选择参数直接使用点播控制台上预设的变量。
自定义设置参数和取值时，要求如下：
多个参数用竖线（|）分隔，例如：token=$arg_token|vendor=ali_cdn。
参数区分大小写，即key和KEY是两种不同的参数。
使用预设变量时，您可以提取变量的值添加到CDN转发给鉴权服务器的请求上。
例如，选择提取变量$http_host，则用户请求的URL地址会加上host=$http_host，此处的host表示用户请求头中的host值。变量名称与变量含义的介绍，请参见变量名称。
保留请求头设置
用于控制用户请求头中需要参与鉴权的参数。可以选择保留所有参数、保留指定参数和删除所有请求头参数。
保留指定参数时，多个请求头用竖线（|）分隔，例如：user_agent|referer|cookies。
参数不区分大小写，即http_remote_addr和HTTP_Remote_Addr为同一个参数。
说明选择保留所有参数时，CDN节点默认会删除HOST头，如果您需要保留HOST头，可通过保留指定参数或者添加自定义参数来保留。CDN节点默认删除HOST头的原因是CDN节点转发给鉴权服务器的鉴权请求中携带的HOST头是加速域名，这可能会导致鉴权服务器无法识别鉴权请求，从而导致访问404、鉴权失败。
添加自定义参数
为CDN节点转发给鉴权服务器的请求头添加自定义参数。
您可以选择自定义来设置参数和取值，也可以选择选择参数直接使用点播控制台上预设的变量。
自定义设置参数和取值时，要求如下：
多个请求头用竖线（|）分隔，例如：User-Agent=$http_user_agent|vendor=ali_cdn。
参数不区分大小写，即http_remote_addr和HTTP_Remote_Addr为同一个参数。
使用预设变量时，您可以提取变量的值添加到CDN转发给鉴权服务器的请求上。
例如，选择提取变量$http_host，则用户请求的URL地址会加上host=$http_host，此处的host表示用户请求头中的host值。变量名称与变量含义的介绍，请参见变量名称。
鉴权成功状态码
鉴权服务器在鉴权成功时返回的HTTP状态码，即鉴权结果。建议鉴权成功状态码设置为2XX。
例如，将鉴权成功状态码设置为200，当鉴权服务器返回200时，表示鉴权成功。如果鉴权服务器返回的状态码不是成功状态码，也不是失败状态码，结果即为鉴权超时。
鉴权失败状态码
鉴权服务器在鉴权失败时返回的HTTP状态码，即鉴权结果。建议鉴权失败状态码设置为4XX。
例如，将鉴权失败状态码设置为403，当鉴权服务器返回403时，表示鉴权失败。如果鉴权服务器返回的状态码不是成功状态码，也不是失败状态码，结果即为鉴权超时。
响应自定义状态码
鉴权服务器返回鉴权失败状态码给CDN节点，即用户请求鉴权失败时，CDN节点返回给用户的状态码。
例如，将响应自定义状态码设置为403，当用户请求鉴权失败时，CDN节点会返回403给用户。
超时时长
统计的是从CDN节点发起鉴权请求开始，到CDN节点收到鉴权服务器返回的结果为止的时间。
单位为毫秒，最长可以设置为3000毫秒。
超时之后的动作
CDN节点与鉴权服务器之间的数据交互超时后，CDN节点对用户请求的处理。取值：
放行：鉴权超时，CDN节点将直接放行用户的请求。
拒绝：鉴权超时，CDN节点将返回上面配置的响应自定义状态码给用户。
单击确定，完成配置。
成功配置远程鉴权功能后，您可以在远程鉴权页签下，对当前的配置进行修改或关闭远程鉴权功能。
变量名称
添加自定义参数时，您可以选择直接使用点播控制台上预设的变量。变量名称与变量含义见下表。
变量名称 | 变量含义 |
$http_host | 请求头中的host值。 |
$http_user_agent | 请求头中的user_agent值。 |
$http_referer | 请求头中的referer值。 |
$http_content_type | 请求头中的content_type值。 |
$http_x_forward_for | 请求头中的x_forward_for值。 |
$remote_addr | 请求的client ip信息。 |
$scheme | 请求的协议类型。 |
$server_protocol | 请求的协议版本。 |
$uri | 请求的原始uri。 |
$args | 请求的Query String，不包含问号（？）。 |
$request_method | 请求方法。 |
$request_uri | uri+'?'+args的内容。 |