全部产品
云市场

HLS标准加密

更新时间:2019-07-09 19:55:07

简介

视频加密是对视频内容保护的一种手段。对视频中的内容进行加密,可有效防止视频泄露和盗链问题。目前,视频加密广泛用于在线教育及财经等领域。

说明:阿里视频云点播目前支持加密方式: 私有加密,HLS标准加密。此文档主要介绍HLS标准加密。

整体架构

标准加密

相关概念

  • 密钥管理服

    密钥管理服务(Key Management Service,简称KMS,是一种安全管理服务,主要负责数据密钥的生产、加密、解密等工作。

  • 数据密钥

    数据密钥(Data Key,简称DK)也称明文密钥。DK为加密数据使用的明文数据密钥。

  • 信封数据密钥

    信封数据密钥(Enveloped Data Key,简称EDK)也称密文密钥。EDK为通过信封加密技术保密后的密文数据密钥。

  • 访问控制

    访问控制(Resource Access Management 简称RAM)是阿里云为客户提供的用户身份管理与资源访问控制服务。

准备工作

  • 搭建密钥管理服务,封装阿里云秘钥管理服务(KMS),生成AES_128密钥,详细参 GenerateDataKey
  • 搭建令牌颁发服务,生成MtsHlsUriToken。
  • 解密密钥:EDK(密文密钥),调用KMS服务的解密接口进行解密,详细参见 Decrypt
  • 解密拿到DK即明文密钥,需要base64decode后再返回给播放器。

接入流程

标准加密必须按照以下流程接入。

1.创建转码模板

HLS标准加密转码需要创建两个转码模板。

加密模板

在视频点播控制台 全局设置—>转码设置,创建HLS模板并勾选HLS加密选项(必须勾选,否则不加密),详细设置请参考 转码设置,该模板在调用 提交媒体处理作业 接口时通过TemplateGroupId参数传递,如此视频点播将按照设置的模板和传递的秘钥信息进行标准加密转码。如下图所示:加密模板配置

不转码模板

不转码即分发模板,用户可在点播控制台 全局设置—>转码设置 激活,该模板是用来上传视频用。

说明:目前点播上传视频默认都会自动触发转码(自动触发暂不支持HLS标准加密),因此对于标准加密为防止自动触发转码,需要先使用不转码模板上传视频(该类模板不会自动触发转码),然后再调用 提交媒体处理作业 接口发起标准加密转码

如下图所示:激活不转码

说明:如果不转码模板已经存在则无须再次激活。

2.RAM授权

使用RAM服务给视频点播授权访问业务方秘钥管理服务(KMS)的权限,请点击 RAM授权 给视频点播授权,如下图所示:RAM授权

3.创建Service Key

Service Key为秘钥管理服务的一种加密主Key,接入标准加密的秘钥生成必须要使用该Service Key是生成,由于视频点播控制台暂不支持用户自主创建Service Key,请提工单申请创建Service Key。

注意:

  • Service Key与视频存储的源站区域必须一致,例如:视频存储在华东2,则Service Key必须是华东2

问题: 如何查看Service Key?

Service Key 可在业务方自己的秘钥管理服务控制台可看到描述为 vod 的加密主Key。如下图所示:秘钥截图

问题: 如何使用Service Key生成秘钥?

调用秘钥管理服务(KMS)的 GenerateDataKey 接口通过Service Key生成AES_128密钥,代码示例详细请参考 提交媒体处理作业 标准加密Demo。

注意:GenerateDataKey接口只需要传:KeyId(上述中的Service Key)和KeySpec(固定为:AES_128)即可,其他参数不用传,否则可能加密失败。

问题: 如何使用生成的秘钥?

GenerateDataKey接口会返回两种秘钥:一种是密文秘钥(CipherText),另一种是明文秘钥(PlainText)。用户只需要将密文秘钥传递给视频点播服务即可,具体参数传递详细请参考 提交媒体处理作业 中的 EncryptConfig 参数,代码示例详细请参考 提交媒体处理作业 标准加密Demo。

说明:

  • 强烈推荐业务方对生成的密文秘钥和明文秘钥进行缓存。
  • 创建的Service Key不可删除、不可更新,只用于生成加密密钥。
  • 关于密钥相关费用,参见 密钥管理服务-计费方式-API调用费用

4.上传视频

使用上述Step1中激活的不转码即分发模板用于创建视频上传凭证和地址,视频点播控制台上传详细请参考 控制台上传,服务端接口上传详细请参考 服务端上传

5.接收上传完成回调消息

接收到上传完成回调消息表明文件已经上传到视频点播。

问题: 如何设置接收上传完成回调消息?

视频点播控制台设置上传消息回调,接收到上传完成回调消息后可通过 提交媒体处理作业 接口发起标准加密转码,上传完成回调接收设置详细请参考 回调设置

6.发起标准加密转码

调用媒体处理作业接口传递Step1中创建的加密模板ID和标准加密参数发起标准加密转码,参数详情请参考 提交媒体处理作业 文档。

问题:如何验证加密转码是否成功?

可通过以下三种方式来逐步判断标准加密是否成功。

  • 如果视频只有m3u8格式输出,那么视频状态为审核中或者正常状态,则一般表明视频标准加密成功,否则视频状态会为转码失败
  • 如果视频不只有m3u8格式输出,那么需要到视频点播控制台视频管理详情查看是否存在加密标志的m3u8文件地址输出,如果有一般表明标准加密成功。
  • 如果前面两种方式都不能判断,那么可以将带有加密标志的m3u8文件的地址拷贝出来,使用curl -v “m3u8文件地址”,查看获取到的m3u8内容是否存在URI=”<业务方在发起标准加密时传递的解密地址,即EncryptConfig中的DecryptKeyUri参数值>”关键信息,有则表明为标准加密且加密成功,参数详细请参考 EncryptConfig,例如URI=”http://decrypt.demo.com?CipherText=ZjJmZGViNzUtZWY1Mi00Y2RlLTk3MTMt

7.标准加密视频播放

标准加密视频的播放需要业务方先依据秘钥管理服务解密接口搭建解密服务,详细请参考 Decrypt。如果业务方需要对解密接口进行安全验证,则需要提供令牌生成服务,生成的令牌能够在解密服务中被解析验证。

注意:解密接口返回的数据为 GenerateDataKey 生成的两种秘钥中的明文秘钥(PlainText)经过base64decode之后的数据。

问题:生成的令牌如何传递到解密接口?

要将令牌重写到解密接口上,业务方必须使用域名进行加速播放,在请求m3u8地址时需要将生成的令牌通过MtsHlsUriToken参数传递,CDN域名会自动将该参数重写到解密接口上并请求解密接口。

注意:

  • 域名MtsHlsUriToken参数重写功能需要提工单申请开通,默认不开通。
  • 如若开启MtsHlsUriToken参数重写,不能开启CDN域名鉴权功能,否则重写失效。

问题:播放器如何解密播放?

标准加密视频对于支持HLS协议播放的播放器都可以解密播放,播放器解密标准加密的大致步骤如下:

问题:如何快速验证加密播放?

可以通过阿里云播放器诊断平台播放对标准加密的m3u8地址快速验证播放是否正常,拷贝m3u8文件地址(如有MtsHlsUriToken参数一并拷贝)到 阿里云播放器诊断平台 尝试标准加密的解密播放。

说明:由于播放需要请求解密接口,所以请先确保解密服务是否正常。

解密播放最佳实践

标准加密视频解密播放最佳实践详细请参考 标准加密安全播放

其它常见问题

  • 接口提示:

    SubmitTranscodeJobs 调用提示KeyNotFound相关信息,请先联系点播后台在相应的区域(例如:华北2、华东2)创建Service Key 并用于生成加密密钥。

  • 非加密文件:

    生成的文件未加密,请确认转码模板是否勾选了HLS加密(标准加密、私有加密必须勾选),导致输出文件都是未加密。

  • 自定义密钥:

    加密的明文密钥必须使用 GenerateDataKey 生成,不能使用自定义字符串生成加密密钥,否则加密转码失败。

  • 加密失败:

    标准加密转码失败或没有任何加密文件生成,请确认 GenerateDataKey 生成的密钥类型是否为AES_128密钥,否则加密转码会失败导致不会生成任何加密文件。

  • 解密失败:

    标准加密文件解密播放失败,请确认是解密接口应该将KMS生成的明文密钥再次base64decode之后给播放器解密播放,不然解密播放会失败。

  • 重复生成:

    标准加密转码触发都是由用户主动触发,如果重复生成加密文件,请确认是否重复调用 SubmitTranscodeJobs接口。