推/播流地址鉴权

更新时间:
复制 MD 格式

为防止站点资源被恶意下载盗用,除了通过配置访问Referer黑名单和白名单来实现对访客身份的识别和过滤,您还可以使用URL鉴权功能对推播流地址进行鉴权,更安全有效地保护用户源站资源。本文介绍URL鉴权的使用方式,原理、和注意事项。

鉴权URL组成

鉴权URL适用于PC端、移动端、第三方推流和播放工具。由直播推流地址或播放地址+鉴权串组成,示例如下:

rtmp://push.aliyundoc.com/app/stream?auth_key=1740562218-0-0-183e22e*********

参数auth_key即鉴权串。

鉴权串结构

timestamp-rand-uid-md5hash
  • timestamp:UNIX时间戳,单位秒,最终失效时间由该值加上域名URL鉴权有效时长决定。

    使用控制台直播地址生成器生成地址时,timestamp默认为当前时间。即使用直播地址生成器生成地址时,有效期为:当前时间+域名URL鉴权有效时长。

    通过代码自定义生成地址时,可以指定timestamp。比如您设置timestamp为:当前时间+3600秒,那最终失效时间为:当前时间+3600秒+域名URL鉴权有效时长。如果设置timestamp为:当前时间,那最终失效时间为:当前时间+域名URL鉴权有效时长。

  • rand:随机数,一般为0。

    如要确保每次生成的URL不同,建议使用UUID格式,不能包含中划线(-),如:477b3bbc253f467b8def6711128c7****。

  • uid:附加参数,暂未使用,一般为0。

  • md5hash:通过md5算法计算出的验证串。数字和小写英文字母混合,固定长度32。

    加密内容:

    sstring = "URI-timestamp-rand-uid-PrivateKey" 
    md5hash = md5sum(sstring)

    比如推流地址:rtmp://push.aliyundoc.com/app/stream,加密内容为:/app/stream-timestamp-rand-uid-域名鉴权Key。

示例:根据地址计算失效时间

以rtmp://push.aliyundoc.com/app/stream?auth_key=1740562218-0-0-183e22e*********为例:

  1. 取出auth_key第一段的数字1740562218,这就是timestamp。将它按UNIX时间戳(单位:秒)转换为北京时间,结果是2025-02-26 17:30:18。

  2. 在该地址所属域名的域名配置中,查看 URL鉴权有效时长,例如30分钟。

  3. 将两者相加,得到该地址的失效时间:2025-02-26 18:00:18。

推流地址和播流地址分别属于推流域名和播流域名,需要分别查看对应域名的有效时长。即使两个地址的timestamp相同,失效时间也可能不同。

使用方法

使用鉴权URL,需要推/播流域名开启URL鉴权功能(域名初次添加时,默认已开启URL鉴权,相关配置可参见URL鉴权配置)。鉴权URL可通过直播地址生成器或代码自定义生成,具体信息,可参见生成直播地址。

功能原理

当开启URL鉴权功能后,服务器获取请求后会进行如下验证:

  1. 判断请求中的失效时间是否小于当前时间。

    • 如果小于当前时间,则认为过期失效并返回HTTP 403错误。

    • 如果大于当前时间,则构造出一个同样的字符串(参见下文sstring构造方式)。

  2. 使用MD5算法算出HashValue,再和请求中带来的md5hash进行比对。

    • 比对结果一致,则认为鉴权通过,返回直播流。

    • 否则鉴权失败,返回HTTP 403错误。

HashValue是通过以下字符串计算出来的:

sstring = "URI-timestamp-rand-uid-PrivateKey"
HashValue = md5sum(sstring)

示例说明

  • 假设情况:

    1. 通过req_auth请求对象,rtmp://demo.aliyundoc.com/video/standard****。

    2. 鉴权KEY设置为:aliyunliveexp1234(控制台设置的主KEY或副KEY,由用户自行设置)。

    3. 生成鉴权URL时间为:北京时间2021年05月28日16:49:57。

    4. 控制台中,鉴权URL设置的有效时长为40分钟。

    5. rand和uid字段都设置为0。

  • 则:

    1. 计算出来的鉴权URL的Unix时间戳为1622194197(北京时间2021年05月28日17:29:57)。

    2. 服务器会构造一个用于计算Hashvalue的签名字符串。

      /video/standard-1622194197-0-0-aliyunliveexp1234

    3. 服务器会根据该签名字符串计算HashValue。

      HashValue = md5sum("/video/standard-1622194197-0-0-aliyunliveexp1234") = 5552ff52b5e4e20387c6dc18afce****

    4. 请求时URL为rtmp://demo.aliyundoc.com/video/standard****?auth_key=1622194197-0-0-5552ff52b5e4e20387c6dc18afce****

      说明

      auth_key即为鉴权URL所带的鉴权信息。

    5. 计算出来的HashValue与用户请求中带的md5hash = 5552ff52b5e4e20387c6dc18afce****值一致,于是鉴权通过。

注意事项

  • 鉴权功能默认为开启状态,建议您保持默认开启状态,否则会出现直播被盗录、盗播的风险。如果您想要关闭鉴权功能,需要了解盗刷风险并在控制台URL鉴权页面签署《关闭URL鉴权免责协议》。

  • 鉴权功能默认为开启状态,但是配置鉴权auth_key参数必须需要业务端根据鉴权原理自行实现,暂时没有提供API接口计算鉴权auth_key参数。

  • 开启鉴权后推流或播流地址均需要添加鉴权auth_key参数才可正常播放。暂时不支持仅推流或者播流一个地址开启鉴权的功能。

  • 鉴权URL提供的是过期时间戳的限制,即在该时间段内该地址可以一直访问,不会有任何限制,鉴权还无法实现设置某个URL仅能够一次访问的功能。

  • 鉴权auth_key参数是根据去掉queryString后的URI计算MD5值后拼接得到的,参见前述设置鉴权参数小节。因此,推流和播流地址的URI均为AppName/StreamName。建议用户业务逻辑中如果推流地址有泄漏的情况下设置过期时间戳在业务许可范围内尽量短一些,避免播流地址被恶意访问。

  • 针对RTMP、FLV、RTS格式的推播流地址鉴权仅会在推流或者播流开始的时候进行验证,在推流或者播流过程中不会验证,即推流或者播流过程中如果超过了鉴权时间戳也可以继续播放。

  • 针对M3U8格式的播流地址鉴权会在播流开始以及播流过程中进行验证,即在播流过程中如果超过了鉴权时间戳,M3U8格式的播流地址将不能正常播放。

  • 若您需要动态控制URL鉴权设置有效期的话,可通过相关SDK,以动态传入AppName和StreamName的方式进行控制,并参考相关链接鉴权代码示例。

  • auth_key 生成策略选择:播放地址的 auth_key 支持预生成和实时生成两种方式。无严格安全要求且需要在有效期内复用播放地址的场景,可提前生成 auth_key,例如将 timestamp 设置为当前时间 + 7200 秒。需要降低 URL 泄露风险或按请求发放访问授权的场景,建议每次请求播放地址时实时生成有效期较短的 auth_key,例如将 timestamp 设置为当前时间 + 300 秒。M3U8 格式的播流地址在播流开始及播流过程中会持续验证鉴权时效,建议采用实时生成策略,避免鉴权在播流过程中到期。

  • 针对摄像头等无法远程更新配置的固定IP推流设备,若鉴权有效期过期导致断流,建议在安全性和可用性之间平衡设置有效期,或改用推流IP白名单功能替代URL鉴权。

  • 针对阿里云实时音视频ARTC协议,建议正式使用时务必开启URL鉴权以防止资源被盗用产生额外费用;仅在临时测试播放时可暂时关闭以确保地址可访问。

  • 推流域名和播流域名的鉴权主KEY可设置为相同值,推流地址和播流地址的鉴权及正常推流、播放均不受影响。鉴权主KEY长度建议不少于16位,控制台对不足8位的KEY会拒绝保存并提示安全风险。

常见问题

未进行直播操作或已停止使用服务仍产生高额流量费用

发现异常推流或播放用量时,可参考以下步骤进行处理:

  1. 确认异常来源:在视频直播控制台的数据中心查看计费用量,同时查看在线流,记录异常发生的时间段、域名、AppName 和 StreamName。如需进一步确认异常流量的来源,可通过以下方式查询:

    • 推流端 IP:调用DescribeLiveStreamsPublishList - 查询域名历史流列表接口查询异常时段的历史流,返回参数ClientAddr即为推流端 IP。该接口最多可查询近 30 天的历史流。控制台流管理 > 历史流页签可查看推流时间、结束时间和断流原因,但不显示推流端 IP。

    • 播放端 IP:在数据中心 > 数据监控 > 日志管理中,下载异常域名在对应时段的访问日志,日志中的访问IP即为请求来源 IP。日志一般在 24小时内生成,仅支持下载最近30天的日志,请尽早下载留存。日志下载无需开通日志服务 SLS,详情请参见日志管理。

  2. 禁推异常流:确认这些流不属于正常业务后,通过流管理或ForbidLiveStream - 禁止直播流接口禁止推流。

  3. 开启URL鉴权:为推流域名和播流域名开启URL鉴权。如果鉴权Key已经泄露,请更换Key,并同步更新正常业务使用的地址。

  4. 检查媒体处理配置:异常流如果命中录制、转码、截图配置,也会产生相应费用。请删除不再需要的配置。其中,录制模板的AppName或 StreamName配置为*时,异常流也会被录制:

    • 每一路被录制的异常流都会计入当月录制并发路数。月录制服务费按当月录制并发峰值路数计费,通常在次月 1 日凌晨出账,因此处置完成后,次月仍可能收到一笔集中扣除的月录制服务费。详情请参见月录制服务费如何计费。

    • 已保存在OSS或视频点播中的录制文件,仍可能产生存储和播放费用,请按需清理。

  5. 检查AccessKey:如果怀疑AccessKey已经泄露,请检查调用记录,并及时禁用或更换泄露的AccessKey。

说明
  • Referer防盗链不能替代URL鉴权。

  • 用量统计有延迟,此前已经产生的费用不会自动取消。

  • 鉴权关闭期间,可以按域名/AppName/StreamName的格式自行拼接出可用的推流或播放地址,无需调用接口、使用地址生成器或 AccessKey。因此,这类地址不会留下生成记录,操作审计中也可能查不到相关事件;排查来源请以步骤1中的推流端 IP 和访问日志为准。

  • 建议配置带宽峰值监控及云监控告警(支持短信、邮件、钉钉通知),及时发现异常流量。

未开启 URL 鉴权时,代码中 push_auth_key 和 pull_auth_key 参数如何配置?

若域名未开启访问鉴权,推流和播流地址无需携带鉴权参数。代码配置中将 push_auth_key 和 pull_auth_key 留空或不配置即可正常使用。

使用 PHP Demo 生成鉴权串时报错 $matches[4] 缺失如何处理?

不能直接删除 $args = $matches[4] 代码行,因为后续逻辑依赖该变量判断 URL 中查询参数的拼接符号(? 或 &)。可保留赋值语句,当 $matches[4] 不存在时将其赋值为空字符串,示例如下:

$args = isset($matches[4]) ? $matches[4] : '';

这样可以确保鉴权串格式正确,同时避免 PHP 语法错误。

开启或关闭URL鉴权后是否立即生效?是否需要重新推流?

  1. 开启或关闭URL鉴权配置后立即生效,无需等待。

  2. 开启鉴权后,若当前推流会话未中断且AppName和StreamName保持不变,则不需要重新推流;仅新生成的推流地址和播流地址需要携带鉴权参数。

  3. 若开启鉴权后影响业务,可随时在控制台URL鉴权页面关闭鉴权,关闭后直播服务立即恢复正常访问。

开启URL鉴权后返回403错误为何仍产生少量流量费用?

原因分析

非法请求虽被拦截并返回HTTP 403错误,但CDN边缘节点仍需处理该请求并进行交互,因此会产生少量的请求数计费或边缘节点交互流量费用。

解决与预防

建议推流域名和播流域名均开启URL鉴权,从源头最大程度减少异常请求产生的费用。