MFS消息通知

配置点播消息订阅

1. 登录视频点播控制台。
2. 在左侧导航树中选择“全局设置 > 消息订阅”，进入消息订阅页面。
   1. 根据需要勾选订阅事件，并输入回调地址。
   2. （可选）如需鉴权，可单击“生成”，生成鉴权密钥。
      消息通知鉴权验证流程，如MFS消息通知鉴权验证流程所示。

      

      如果用户同时勾选“截图完成事件”和“封面生成完成事件”，不会触发封面通知，都只会触发截图通知。

      图1 配置消息订阅
      
   MFS消息通知，仅支持发送REST消息，对应的JSON消息模板请参考表1 json消息模板说明。

   表1 json消息模板说明

   参数	说明	类型
   event_type	事件类型，当前支持的取值如下： transcodeComplete：转码（加密）完成 thumbnailComplete：截图完成 reviewComplete：审核完成 createComplete：媒资创建完成 audioExtractComplete：音频提取完成 coverComplete：封面生成完成 parseComplete：媒资解析完成	String
   transcode_info	转码（含加密）信息，仅当是转码（加密）事件才有该字段，具体消息说明请参考转码消息体。	TranscodeInfo
   thumbnail_info	截图信息，仅当是截图事件才有该字段，具体消息说明请参考截图消息体。	ThumbnailInfo
   review_info	审核信息，仅当是审核事件才有该字段，具体消息说明请参考审核消息体。	ReviewInfo
   create_info	新创建的媒资信息，仅当是媒资创建事件才有该字段，具体消息说明请参考创建媒资&音频提取消息体。	AssetInfo
   audio_extract_info	新提取的音频信息，仅当是音频提取事件才有该字段，具体消息说明请参考创建媒资&音频提取消息体。	AssetInfo
   cover_info	封面生成消息，仅当是封面生成事件才有该字段，具体消息说明请参考封面生成消息体。	CoverInfo
   parse_info	媒资解析完成消息，仅当是媒资解析完成事件才有该字段，具体消息说明请参考解析媒资消息体。	ParseInfo

3. 单击“确定”，完成消息订阅配置。

MFS消息通知鉴权验证流程

MFS消息通知鉴权验证流程，如下所示：

1. 视频点播服务会根据当前时间生成一个时间戳timestamp，使用2.b中配置的密钥，根据HmacSHA256(VOD_{timestamp}_{body}, key)计算出签名字符串。

   签名字符串和时间戳会在HTTP的消息头中发送至端侧，分别为header[auth_sign]和header[auth_timestamp]。其中，body为消息体中的message属性。

2. 客户收到返回消息后，按照VOD_{timestamp}_{body}格式拼接字符串，再使用消息头中的密钥计算HmacSHA256(VOD_{timestamp}_{body}, key)生成签名字符串和消息头中的签名字符串比较是否一致。如果一致，则鉴权成功。

对应的Java示例代码，如下所示：

        // 时间戳，消息头中参数header[auth_timestamp]
        long reqTime = 1l;
        // 消息体中的message属性
        String message = "";
        // 密钥
        String key = "";
        String algorithm = "HmacSHA256";
        // 生成HmacSHA256密钥
        SecretKeySpec signingKey = new SecretKeySpec(key.getBytes(StandardCharsets.UTF_8), algorithm);
        // 创建Mac对象并初始化
        Mac mac = Mac.getInstance(algorithm);
        mac.init(signingKey);
        String content = "VOD_"+reqTime+"_" + message;
        // 执行HmacSHA256加密
        byte[] rawHmac = mac.doFinal(content.getBytes(StandardCharsets.UTF_8));
        // 将加密结果转换为十六进制字符串
        StringBuilder sign = new StringBuilder();
        for(byte b : rawHmac) {
            sign.append(String.format("%02x", b));
        }
        System.out.println(sign);