签名与验签

更新时间：2021-10-15

签名与验签

一、注意事项

1. 平台使用RSA2(SHA256WithRSA)签名方式,密钥为 pkcs#8格式
2. 接口中的所有参数的编码都是UTF-8，所以跟平台交互或者计算签名的时候字符编码都是UTF-8；
3. 如果参数的值为空不参与签名；
4. 参数名区分大小写；
5. 参数名为sign参数不参与签名

二、密钥说明

测试环境公钥、私钥，联调时百度配置
线上环境公钥、私钥重新配置

1）测试环境交互方私钥

----- BEGIN PRIVATE KEY -----
MIIEvwIBADANBgkqhkiG9w0BAQEFAASCBKkwggSlAgEAAoIBAQC+/7DBc/a/M8Ks
CK6bbIWsznkLJo6msytb5YITvRGl5jJQJKx6+injGn0eMJnbKAXp4JDGOk542utQ
c27wIRaLBzOPEsI3bz3X9xAr6kWv+HCk3V7YRfPiGZwsonc4d4tBYQ/S5ez0pfm/
C76biG/jDHJkuE7ep3/OV1MDQYaNZsmofzIdbYz0Y6s4isqOQjOfrHo/Xm4wIUZE
8W5nx8oy/u7ZjtteEe7QSPa7e0XX/0nKkAhT4uLbob/RZhgBNBXFQTfq4BRJvv/q
WdW3GsjMdmVy0g803bMpuFGRmC48Ap49ezdUDynDt9jijOmASpqucs4AJZBAuZa3
8P0sE78PAgMBAAECggEBAKxaSSNYxKmnSJ07PG0OUdYtf3b7dTCib5b+lRHAxGMj
RfWiEm7qvc+swIj0rHHiPOvedGYciWFvk3bGo65W/WO5vOH3uICThogS72nhfr8b
fnKXPJYHEdvO5mo0tUakQWpe7wuN5fSiraqjK35ocSa+vZ973df36FHH5SYEBCol
rmzXzmTrKBWQ5KMc+uGXz/Y2m8iZsO3zF1uT/7RwKsIjFm4Xz0j7K0d5oBBmiyHU
paOs230a8AMvA9BZQ7EzK//5G9+f2YcUJ8jQ5tOilQHZ9Pdz/+pYKdi9ALtbp+ya
kIiEwwVPBV55yIj7uifp4/pwhxJLaoea2ifJNInHSFkCgYEA6K2bVksYCGFlaZpy
reJl9LjneJ3k8QwxVj31DyhsH92dvtYvoOG0A8nskfI3KzVFP5Cw7sUSqimAHmDs
acU90PTSIdxd0jqPc5W06njIWmYQchJZzsFpg/0Fba5Ale/K9dKJUgVJwqWL2AoZ
gbb5dbY/MHuKEsGJn/ykasOvZyMCgYEA0iSdPf/o0VeRVsFGn/PFfKSN0rJ52aOw
MeZbtT7deeJqm95O0htSfA/0M6v0BOu8qUFsTdhtRO7KXvk/TFCqyo9eFDsoN/pW
9UB5MyIyNHqeP1CfSGbHYNxexFIsuK4kHOIi/8clUSxQOOH0p1a+FCjQ5kSw1hKE
EZxSHZznvSUCgYEA2dEDdOHxio7ap+Rs7LjfJxwdnH17P+hhG1H+4gS+S4pkTK0n
gx0nLtDNxMaRvMIupFXoPG2CjocxJ78mMdHyj3VQbWBk+BPYDKUd6s3NCUs4pADn
z7Sh+WxYs5eHYJVNU5iW8pB+v1fINSMnQ5Ytq3NDbjiIRgylsH6K0GOGBS8CgYBy
jf8h4zV5mTDjiC0F2Q+ZKOMfLqf6Gp9cNGVd4k09uk2/dmqlYruOYewPlvdJD3Ej
G0T9ErROVZYAPANjiL3x+kGg6ba8/T0WKPVpCIUx0n4dqceK4mxhwv/uKZWzf0q0
bBoEMP2IyI1a1OJXrpOjzbRDMsLrj+Bq8TpaZkR1+QKBgQDJoaNX5Jgi1ifR+3rR
ghEruB2qze/PNFTHD7LmTHlqfgTzIvccZ0bd41kC0CSKbkrTYQ/ihQnKp3YRLUiC
n700qN+EjrIPVqH1O7wJcAvBuw43wtoC1dushs4FkArHQYEGomA4zlgk1Q9kE9l/
X0YZriBvP/2YtUt2kyyo+n0fJw==
-----END PRIVATE KEY-----

2）测试环境交互方公钥

3）测试环境平台私钥

4）测试环境平台公钥

三、签名步骤

1.筛选并排序
  获取所有请求参数，不包括字节类型参数，如文件、字节流，剔除sign字段，剔除值为空的参数，并按照第一个字符的键值ASCII码递增排序（字母升序排序），如果遇到相同字符则按照第二个字符的键值ASCII码递增排序，以此类推。
2.拼接
将排序后的参数与其对应值，组合成“参数=参数值”的格式，并且把这些参数用&字符连接起来，此时生成的字符串为待签名字符串。
3.调用签名函数
使用各自语言对应的SHA256WithRSA签名函数利用商户私钥对待签名字符串进行签名，并进行Base64编码。
4.把生成的签名赋值给sign参数，拼接到请求参数中。

四、生成签名和验证签名方法示例（PHP）

    /**
     * @desc 私钥生成签名字符串
     * @param array $assocArr 参与签名参数数组
     * @param string $rsaPriKeyStr  用户私钥
     * @return string   密钥串   返回不为空字符串表示生成签名成功
     * @throws Exception
     */
    public  function genSignWithRsa(array $assocArr, $rsaPriKeyStr)
    {
        $sign = '';
        if (empty($assocArr) || !is_array($assocArr) || empty($rsaPriKeyStr)) {
            return $sign;
        }

        //需要参与sign计算的参数
        $arrNeedSignParams = [];
        foreach ($assocArr as $key => $val) {
            if ($val === null || $val === ""
                || (is_array($val) && empty($val))
            ) {
                continue;
            } else {
                $arrNeedSignParams[$key] = $val;
            }
        }


        if (!function_exists('openssl_pkey_get_private') || !function_exists('openssl_sign')) {
            throw new Exception("openssl扩展不存在");
        }

        $priKey = openssl_pkey_get_private($rsaPriKeyStr);

        if (isset($arrNeedSignParams['sign'])) {
            unset($arrNeedSignParams['sign']);
        }

        ksort($arrNeedSignParams); //按字母升序排序
        if (empty($arrNeedSignParams)) {
            return $sign;
        }

        $parts = array();
        foreach ($arrNeedSignParams as $k => $v) {
            $parts[] = $k . '=' . $v;
        }
        $str = implode('&', $parts);
        openssl_sign($str, $sign, $priKey,'SHA256');
        openssl_free_key($priKey);

        return base64_encode($sign);
    }


    /**
     * @desc 签名校验
     * @param array $assocArr  参与签名参数数组
     * @param string $rsaPubKeyStr  平台公钥
     * @return bool  $result    验签结果  true 验签成功 false 验签失败
     * @throws Exception
     */
    private function checkSignWithRsa(array $assocArr, $rsaPubKeyStr)
    {

        $arrNeedSignParams = [];

        if (empty($assocArr) || !is_array($assocArr) || empty($rsaPubKeyStr)) {
            return false;
        }

        foreach ($assocArr as $key => $val) {
            if ($val === NULL || $val === ""
                || (is_array($val) && empty($val))
            ) {
                continue;
            } else {
                $arrNeedSignParams[$key] = $val;
            }
        }

        if (!isset($arrNeedSignParams['sign']) || empty($arrNeedSignParams)) {
            return false;
        }

        if (!function_exists('openssl_pkey_get_public') || !function_exists('openssl_verify')) {
            throw new Exception("openssl扩展不存在");
        }

        $sign = $arrNeedSignParams['sign'];
        unset($arrNeedSignParams['sign']);

        if (empty($arrNeedSignParams)) {
            return false;
        }
        ksort($arrNeedSignParams); //按字母升序排序
        $parts = array();
        foreach ($arrNeedSignParams as $k => $v) {
            $parts[] = $k . '=' . $v;
        }
        $str = implode('&', $parts);

        $sign = base64_decode($sign);
        $pubKey = openssl_pkey_get_public($rsaPubKeyStr);
        $result = (bool)openssl_verify($str, $sign, $pubKey, 'SHA256');
        openssl_free_key($pubKey);

        return $result;
    }

开发者订单数据传输接入文档申请退款后退款审核接口