回调接口说明

语音通知回调接口签名算法说明

• 签名算法（鉴权）使用前提条件

  当通过创建语音通知接口传入URL，并在“回调url配置”界面中“请输入共享密钥”配置了共享密钥。请参考本节进行签名验证。

• 鉴权过程
  1. 释放事件回调接口请求入参会增加以下字段：

     timestamp：当前时间戳

     nonce：随机字符串

     signature：鉴权签名

  2. 客户侧收到回调后，需要根据签名算法生成鉴权签名，并与入参的signature进行校验，若一致表示验证通过。

• 签名（signature）字符串生成方式：
  1. 根据参数名称对所有的请求参数（除这三个参数外：timestamp、nonce、signature）进行字典排序，然后用英文逗号拼接成字符串。例如将{"b":"2", "a":1}排序拼接为"a=1,b=2"。
  2. 生成timestamp时间戳及nonce随机字符串，并和appSecret（界面配置的共享密钥）及1生成的字符串通过 _ 拼接在一起。格式为 appSecret_timestamp_nonce_1生成的字符串。
  3. 通过SHA256算法加密成byte数组，然后将该数组Base64编码。

• 参考代码

  import javax.crypto.Mac;
  import javax.crypto.spec.SecretKeySpec;
  
  private String generateSinature(TreeMap<String, Object> callbackParametters, String nonce, long timestamp, String appSecret) {
      // appSecret_timestamp_nonce_参数
      // {"b":"2", "a":1}排序拼接后的字符串是："a=1,b=2"
      String paramStr = callbackParametters.toString().replace(" ", "");
      String toSignString = appSecret + "_" + timestamp + "_" + nonce + "_" + 
             paramStr.substring(1, paramStr.length() - 1);
      return Base64.encodeBase64String(tokenByHmacSha256(toSignString.getBytes(StandardCharsets.UTF_8), appSecret));
  }
  
  public static byte[] tokenByHmacSha256(byte[] dataBytes, String appSecret) {
      try {
          Mac mac = Mac.getInstance("HmacSHA256");
          byte[] key = appSecret.getBytes(StandardCharsets.UTF_8);
          SecretKeySpec secretKey = new SecretKeySpec(key, "HmacSHA256");
          mac.init(secretKey);return mac.doFinal(dataBytes);
      } catch (Exception e) {
          LOGGER.error("tokenByHmacSha256 failed: ", e);throw new RuntimeException("HmacSha256 run failed.");
      }
  }