创新互联百度小程序教程:签名与验签

  • 签名与验签
    • 基本限定
    • 签名规则
  • 签名计算过程示例
  • 签名工具参考代码
  • 验证
    • 加签逻辑验证
    • 验签逻辑验证

    签名与验签

    本章节主要介绍百度收银台使用的双向RSA加密签名规则与相关示例。

    10年积累的网站建设、成都网站制作经验,可以快速应对客户对网站的新想法和需求。提供各种问题对应的解决方案。让选择我们的客户得到更好、更有力的网络服务。我虽然不认识你,你也不认识我。但先建设网站后付款的网站建设流程,更有天涯免费网站建设让你可以放心的选择与我们合作。

    基本限定

    1.统一字符集:UTF-8
    百度收银台接口中的所有参数字符集均保持为 UTF-8 ,与收银台交互接入或者计算签名时,要统一使用 UTF-8 ,暂不支持其他字符集,请接入业务方自行转换;
    2.请求接口的参数列表均为字符串类型键值对;
    3.键值中如果为复杂数据类型,比如结构体、数组、对象都必须先转化为 JSON 结构字符串;
    4.参数中包含汉字的部分,需要做 URLEncode 处理。

    签名规则

    1.排除参数列表中名为 sign 和 sign_type 的参数;
    2.将剩余参数按参数名字典序正序排列;
    3.将参数与其对应的值使用 “=” 连接,组成参数字符串,将参数字符串按排序结果,使用 “&” 连接,组成待签名字符串;
    4.将待签名字符串和业务方私钥使用 SHA1WithRSA 签名算法得出最终签名。

    签名计算过程示例

    使用密钥生成中的示例公私钥来做计算演示。

    1.初始请求业务参数

    参数名 示例取值
    appKeyMMMabc
    dealId470193086
    tpOrderId3028903626
    totalAmount11300

    2.生成待签名字符串

     
     
     
    1. appKey=MMMabc&dealId=470193086&totalAmount=11300&tpOrderId=3028903626

    3.生成最终签名串

     
     
     
    1. TN0ZNPyQeTnPjCN5hUa7JwrXOhR8uDASXPazidVQHFSiGCH5aouBkVvJxtf8PeqzGYWAASwS2oOt2eJfunzC5dTFd/pWJeJToMgCSgRY7KtQUCCDnMrtpqiMAf+dLiXps3HpWhVB4CK6MXfHc64ejP5a2fu5bg8B0BTcHrqaGc0=

    4.签名的完整请求参数

    参数名 示例取值
    appKeyMMMabc
    dealId470193086
    tpOrderId3028903626
    totalAmount11300
    rsaSignTN0ZNPyQeTnPjCN5hUa7JwrXOhR8uDASXPazidVQHFSiGCH5aouBkVvJxtf8PeqzGYWAASwS2oOt2eJfunzC5dTFd/pWJeJToMgCSgRY7KtQUCCDnMrtpqiMAf+dLiXps3HpWhVB4CK6MXfHc64ejP5a2fu5bg8B0BTcHrqaGc0=

    签名工具参考代码

    • PHP签名工具类
     
     
     
    1. // 通用签名工具,基于openssl扩展,提供使用私钥生成签名和使用公钥验证签名的接口
    2. class RSASign
    3. {
    4. /**
    5. * @desc 使用私钥生成签名字符串
    6. * @param array $assocArr 入参数组
    7. * @param string $rsaPriKeyStr 私钥原始字符串,不含PEM格式前后缀
    8. * @return string 签名结果字符串
    9. * @throws Exception
    10. */
    11. public static function sign(array $assocArr, $rsaPriKeyStr)
    12. {
    13. $sign = '';
    14. if (empty($rsaPriKeyStr) || empty($assocArr)) {
    15. return $sign;
    16. }
    17. if (!function_exists('openssl_pkey_get_private') || !function_exists('openssl_sign')) {
    18. throw new Exception("openssl扩展不存在");
    19. }
    20. $rsaPriKeyPem = self::convertRSAKeyStr2Pem($rsaPriKeyStr, 1);
    21. $priKey = openssl_pkey_get_private($rsaPriKeyPem);
    22. if (isset($assocArr['sign'])) {
    23. unset($assocArr['sign']);
    24. }
    25. // 参数按字典顺序排序
    26. ksort($assocArr);
    27. $parts = array();
    28. foreach ($assocArr as $k => $v) {
    29. $parts[] = $k . '=' . $v;
    30. }
    31. $str = implode('&', $parts);
    32. openssl_sign($str, $sign, $priKey);
    33. openssl_free_key($priKey);
    34. return base64_encode($sign);
    35. }
    36. /**
    37. * @desc 使用公钥校验签名
    38. * @param array $assocArr 入参数据,签名属性名固定为rsaSign
    39. * @param string $rsaPubKeyStr 公钥原始字符串,不含PEM格式前后缀
    40. * @return bool true 验签通过|false 验签不通过
    41. * @throws Exception
    42. */
    43. public static function checkSign(array $assocArr, $rsaPubKeyStr)
    44. {
    45. if (!isset($assocArr['rsaSign']) || empty($assocArr) || empty($rsaPubKeyStr)) {
    46. return false;
    47. }
    48. if (!function_exists('openssl_pkey_get_public') || !function_exists('openssl_verify')) {
    49. throw new Exception("openssl扩展不存在");
    50. }
    51. $sign = $assocArr['rsaSign'];
    52. unset($assocArr['rsaSign']);
    53. if (empty($assocArr)) {
    54. return false;
    55. }
    56. // 参数按字典顺序排序
    57. ksort($assocArr);
    58. $parts = array();
    59. foreach ($assocArr as $k => $v) {
    60. $parts[] = $k . '=' . $v;
    61. }
    62. $str = implode('&', $parts);
    63. $sign = base64_decode($sign);
    64. $rsaPubKeyPem = self::convertRSAKeyStr2Pem($rsaPubKeyStr);
    65. $pubKey = openssl_pkey_get_public($rsaPubKeyPem);
    66. $result = (bool)openssl_verify($str, $sign, $pubKey);
    67. openssl_free_key($pubKey);
    68. return $result;
    69. }
    70. /**
    71. * @desc 将密钥由字符串(不换行)转为PEM格式
    72. * @param string $rsaKeyStr 原始密钥字符串
    73. * @param int $keyType 0 公钥|1 私钥,默认0
    74. * @return string PEM格式密钥
    75. * @throws Exception
    76. */
    77. public static function convertRSAKeyStr2Pem($rsaKeyStr, $keyType = 0)
    78. {
    79. $pemWidth = 64;
    80. $rsaKeyPem = '';
    81. $begin = '-----BEGIN ';
    82. $end = '-----END ';
    83. $key = ' KEY-----';
    84. $type = $keyType ? 'PRIVATE' : 'PUBLIC';
    85. $keyPrefix = $begin . $type . $key;
    86. $keySuffix = $end . $type . $key;
    87. $rsaKeyPem .= $keyPrefix . "\n";
    88. $rsaKeyPem .= wordwrap($rsaKeyStr, $pemWidth, "\n", true) . "\n";
    89. $rsaKeyPem .= $keySuffix;
    90. if (!function_exists('openssl_pkey_get_public') || !function_exists('openssl_pkey_get_private')) {
    91. return false;
    92. }
    93. if ($keyType == 0 && false == openssl_pkey_get_public($rsaKeyPem)) {
    94. return false;
    95. }
    96. if ($keyType == 1 && false == openssl_pkey_get_private($rsaKeyPem)) {
    97. return false;
    98. }
    99. return $rsaKeyPem;
    100. }
    101. }
    • Java签名工具类
     
     
     
    1. /*
    2. * Copyright (C) 2020 Baidu, Inc. All Rights Reserved.
    3. */
    4. package com.baidu.*;
    5. import static org.springframework.util.Assert.isTrue;
    6. import static org.springframework.util.Assert.notNull;
    7. import java.io.UnsupportedEncodingException;
    8. import java.net.URLEncoder;
    9. import java.security.KeyFactory;
    10. import java.security.NoSuchAlgorithmException;
    11. import java.security.PrivateKey;
    12. import java.security.PublicKey;
    13. import java.security.Signature;
    14. import java.security.spec.InvalidKeySpecException;
    15. import java.security.spec.PKCS8EncodedKeySpec;
    16. import java.security.spec.X509EncodedKeySpec;
    17. import java.util.Base64;
    18. import java.util.Comparator;
    19. import java.util.Map;
    20. import java.util.TreeMap;
    21. import org.springframework.util.CollectionUtils;
    22. import org.springframework.util.StringUtils;
    23. // 百度收银台双向RSA签名工具,JDK版本要求:1.8+
    24. public class RSASign {
    25. private static final String CHARSET = "UTF-8";
    26. private static final String SIGN_TYPE_RSA = "RSA";
    27. private static final String SIGN_ALGORITHMS = "SHA1WithRSA";
    28. private static final String SIGN_KEY = "rsaSign";
    29. /**
    30. * 使用私钥生成签名字符串
    31. *
    32. * @param params 待签名参数集合
    33. * @param privateKey 私钥原始字符串
    34. *
    35. * @return 签名结果字符串
    36. *
    37. * @throws Exception
    38. */
    39. public static String sign(Map params, String privateKey) throws Exception {
    40. isTrue(!CollectionUtils.isEmpty(params), "params is required");
    41. notNull(privateKey, "privateKey is required");
    42. String signContent = signContent(params);
    43. Signature signature = Signature.getInstance(SIGN_ALGORITHMS);
    44. signature.initSign(getPrivateKeyPKCS8(privateKey));
    45. signature.update(signContent.getBytes(CHARSET));
    46. byte[] signed = signature.sign();
    47. return new String(Base64.getEncoder().encode(signed));
    48. }
    49. /**
    50. * 使用公钥校验签名
    51. *
    52. * @param params 入参数据,签名属性名固定为rsaSign
    53. * @param publicKey 公钥原始字符串
    54. *
    55. * @return true 验签通过 | false 验签不通过
    56. *
    57. * @throws Exception
    58. */
    59. public static boolean checkSign(Map params, String publicKey) throws Exception {
    60. isTrue(!CollectionUtils.isEmpty(params), "params is required");
    61. notNull(publicKey, "publicKey is required");
    62. // sign & content
    63. String content = signContent(params);
    64. String rsaSign = params.get(SIGN_KEY).toString();
    65. // verify
    66. Signature signature = Signature.getInstance(SIGN_ALGORITHMS);
    67. signature.initVerify(getPublicKeyX509(publicKey));
    68. signature.update(content.getBytes(CHARSET));
    69. return signature.verify(Base64.getDecoder().decode(rsaSign.getBytes(CHARSET)));
    70. }
    71. /**
    72. * 对输入参数进行key过滤排序和字符串拼接
    73. *
    74. * @param params 待签名参数集合
    75. *
    76. * @return 待签名内容
    77. *
    78. * @throws UnsupportedEncodingException
    79. */
    80. private static String signContent(Map params) throws UnsupportedEncodingException {
    81. Map sortedParams = new TreeMap<>(Comparator.naturalOrder());
    82. for (Map.Entry entry : params.entrySet()) {
    83. String key = entry.getKey();
    84. if (legalKey(key)) {
    85. String value =
    86. entry.getValue() == null ? null : URLEncoder.encode(entry.getValue().toString(), CHARSET);
    87. sortedParams.put(key, value);
    88. }
    89. }
    90. StringBuilder builder = new StringBuilder();
    91. if (!CollectionUtils.isEmpty(sortedParams)) {
    92. for (Map.Entry entry : sortedParams.entrySet()) {
    93. builder.append(entry.getKey());
    94. builder.append("=");
    95. builder.append(entry.getValue());
    96. builder.append("&");
    97. }
    98. builder.deleteCharAt(builder.length() - 1);
    99. }
    100. return builder.toString();
    101. }
    102. /**
    103. * 将公钥字符串进行Base64 decode之后,生成X509标准公钥
    104. *
    105. * @param publicKey 公钥原始字符串
    106. *
    107. * @return X509标准公钥
    108. *
    109. * @throws InvalidKeySpecException
    110. * @throws NoSuchAlgorithmException
    111. */
    112. private static PublicKey getPublicKeyX509(String publicKey) throws InvalidKeySpecException,
    113. NoSuchAlgorithmException, UnsupportedEncodingException {
    114. if (StringUtils.isEmpty(publicKey)) {
    115. return null;
    116. }
    117. KeyFactory keyFactory = KeyFactory.getInstance(SIGN_TYPE_RSA);
    118. byte[] decodedKey = Base64.getDecoder().decode(publicKey.getBytes(CHARSET));
    119. return keyFactory.generatePublic(new X509EncodedKeySpec(decodedKey));
    120. }
    121. /**
    122. * 将私钥字符串进行Base64 decode之后,生成PKCS #8标准的私钥
    123. *
    124. * @param privateKey 私钥原始字符串
    125. *
    126. * @return PKCS #8标准的私钥
    127. *
    128. * @throws Exception
    129. */
    130. private static PrivateKey getPrivateKeyPKCS8(String privateKey) throws Exception {
    131. if (StringUtils.isEmpty(privateKey)) {
    132. return null;
    133. }
    134. KeyFactory keyFactory = KeyFactory.getInstance(SIGN_TYPE_RSA);
    135. byte[] decodedKey = Base64.getDecoder().decode(privateKey.getBytes(CHARSET));
    136. return keyFactory.generatePrivate(new PKCS8EncodedKeySpec(decodedKey));
    137. }
    138. /**
    139. * 有效的待签名参数key值
    140. * 非空、且非签名字段
    141. *
    142. * @param key 待签名参数key值
    143. *
    144. * @return true | false
    145. */
    146. private static boolean legalKey(String key) {
    147. return StringUtils.hasText(key) && !SIGN_KEY.equalsIgnoreCase(key);
    148. }
    149. }

    验证

    加签逻辑验证

    开发者实现加签逻辑之后,使用计算示例中步骤 1 的初始请求参数作为输入,结合密钥生成中的示例私钥,进行 RSA 签名的生成,如果结果与步骤 3 中最终签名串一致,说明加签逻辑正确。

    验签逻辑验证

    使用计算示例中步骤 4 完整请求参数作为输入,结合密钥生成中的示例公钥,进行 RSA 签名的 check ,返回 true 则说明验签逻辑正确。

    网站栏目:创新互联百度小程序教程:签名与验签
    链接URL:http://www.mswzjz.cn/qtweb/news37/17587.html

    攀枝花网站建设、攀枝花网站运维推广公司-贝锐智能,是专注品牌与效果的网络营销公司;服务项目有等

    广告

    声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 贝锐智能