取现-斗拱平台

v2版接口加签验签

最近更新时间：2024.9.1

适用范围

所有以下出口接口： https://api.huifu.com/v2/

公私钥

查看联调公私参数获取说明；

參數形式

• 接口都是以POST方法请求一个完整的JSON对象（不是JSON字符串）

• body.data 是完整的业务参数
• body.data是JSON对象，不是JSON字符串
• body.data内层复杂对象类型请参考API文档（大部分是字符串类型）
• 详细样例，请参考具体文档或者下面的例子

• body.data提出了完整的业务参数，第一层是基本类型（String、Int），没有复杂类型JSON
• body.data第一层所有提交的参数参与签名

如果出现楼层，则以JSON字符串形式传递。例如下面的terminal_device_info

{
    "sys_id":"test",
    "product_id":"HSK",
    “data”: {
        "devs_id": "TYXJL0623715525894234",
        "auth_code": "134558771750600000",
        "terminal_device_info": "{\"devs_id\":\"TYXJL0623715525894234\"}"
    },
    “sign”:”签名”
}复制代码复制失败复制成功

如何加签

只需对body.data中的内容进行加签。

1. body.data中的数据，去掉换行、空格等格式字符后，按照参数字典顺序排序生成字符串（参数名ASCII码到大排序（字典序）；参数名区分大小写；）以上文为排序后

{
 "auth_code": "134558771750600000",
 "devs_id": "TYXJL0623715525894234",
 "terminal_device_info": "{\"devs_id\":\"TYXJL0623715525894234\"}"
}复制代码复制失败复制成功

注：如果是JSON字符串，不需要进行排序，例如terminal_device_info的值不需要排序

2. 对第一步生成的字符串结合您的私钥进行加签；注：如果你有自己的私钥可以用自己的。如果没有看到联调公私钥参数获取后续说明
3. 首先将json对象按照参数字典顺序（参数名ASCII码到大排序，参数名区分大小写）排序生成字符串，然后进行加签和验签。
   JSON数据排序代码示例

java代码示例

import java.util.TreeMap;

import com.alibaba.fastjson.JSON;

import com.alibaba.fastjson.JSONObject;

JSON.toJSONString(JSONObject.parseObject(inputDataJSON, TreeMap.class))复制代码复制失败复制成功

python代码示例

# json 数据排序示例
def sort_dict(params):
    """
    排序json 对象，按ASCII顺序排序。多层结构只排序第一层
    :param params:
    :return:
    """
    keys = sorted(params.keys())
    result = {}
    for key in keys:
        value = params.get(key)
        if type(value).__name__ == 'dict':
            result[key] = value
        elif type(value).__name__ == 'list' and len(value) != 0:
            result[key] = params.get(key)
        elif params.get(key) is not None:
            result[key] = params.get(key)
    return result复制代码复制失败复制成功

PHP代码示例

/** @param array $data 原数据( 排序后的json字符串; 数组参数排序后转json字符串(数据的中文和斜杠均不转码):**/
    ksort($post_data); 
    json_encode($post_data, JSON_UNESCAPED_SLASHES|JSON_UNESCAPED_UNICODE); )复制代码复制失败复制成功

C#代码示例

//排序
public static string sort4JsonString(string sourceJson)  
{  
  
    var dic = JsonConvert.DeserializeObject<SortedDictionary<string, object>>(sourceJson);  
    SortedDictionary<string, object> keyValues = new SortedDictionary<string, object>(dic);  
    var result = keyValues.OrderBy(m => m.Key);//升序 把Key换成Value 就是对Value进行排序  
    //var result = keyValues.OrderByDescending(m => m.Key);//降序  
      
    //简化为如下代码  
    Dictionary<string, object> resultDic = result.ToDictionary(x => x.Key, x => x.Value);  
      
    return JsonConvert.SerializeObject(resultDic);  
  
}复制代码复制失败复制成功

1. 概要如下

java代码示例

/**
 * RSA私钥签名：签名方式SHA256WithRSA
 * @param data 待签名字符串
 * @param privateKeyBase64 私钥（Base64编码）
 * @return 签名byte[]
 * @throws Exception
 */
public static String sign(String data, String privateKeyBase64) {
        // Base64 --> Key
        try {
                byte[] bytes = Base64.getDecoder().decode(privateKeyBase64);
                PKCS8EncodedKeySpec keySpec = new PKCS8EncodedKeySpec(bytes);
                KeyFactory keyFactory;
                keyFactory = KeyFactory.getInstance("RSA");
                PrivateKey privateKey = keyFactory.generatePrivate(keySpec);
                // Sign
                Signature signature = Signature.getInstance("SHA256WithRSA");
                signature.initSign(privateKey);
                signature.update(data.getBytes("UTF-8"));
                return Base64.getEncoder().encodeToString(signature.sign());
        } catch (Exception e) {
                return null;
        }
}复制代码复制失败复制成功

python代码示例

# 私钥加签
def rsa_sign(private_key, message, charset='utf-8'):
    try:
        private_key = add_start_end(private_key, "-----BEGIN PRIVATE KEY-----\n", "\n-----END PRIVATE KEY-----")
        msg = message.encode(charset)
        private_key = RSA.importKey(private_key)
        # message做“哈希”处理，RSA签名这么要求的
        hash_obj = SHA256.new(msg)
        signature = pkcs1_15.new(private_key).sign(hash_obj)
        return True, base64.b64encode(signature).decode(charset)
    except Exception as ex:
        return False, str(ex)复制代码复制失败复制成功

PHP代码示例

/**
 * 私钥加签（对数据源排序），可用于 V2 版本接口数据加签
 *
 * @param array $data 原数据( 排序后的json字符串; 数组参数排序后转json字符串(数据的中文和斜杠均不转码): 
                            ksort($post_data); json_encode($post_data, JSON_UNESCAPED_SLASHES|JSON_UNESCAPED_UNICODE); )
 *
 * @param string $rsaPrivateKey 私钥
 * @param int $alg 默认 OPENSSL_ALGO_SHA256
 *
 * @return string 签名串
 */
function sha_with_rsa_sign($data, $rsaPrivateKey, $alg=OPENSSL_ALGO_SHA256){
    $key = "-----BEGIN PRIVATE KEY-----\n".wordwrap($rsaPrivateKey, 64, "\n", true)."\n-----END PRIVATE KEY-----";
    $signature= '';
    try {
        openssl_sign($data, $signature, $key, $alg);
    } catch (\Exception $e) {
        echo $e->getMessage();
    }
    return base64_encode($signature);
}复制代码复制失败复制成功

C#代码示例

//私钥加签
public static string sign(string signaturePrivateKey, string signatureData, string hashAlgorithm = "SHA256", string encoding = "UTF-8")  
    {  
    RSACryptoServiceProvider rsa = new RSACryptoServiceProvider();  
    // var privateJavaKey = signaturePrivateKey;  
    // var privateCSharpKey = RSAPrivateKeyJava2DotNet(privateJavaKey);  
    // rsa.FromXmlString(privateCSharpKey);  
    rsa.FromPrivateKeyJavaString(signaturePrivateKey);  
      
    byte[] signatureBytes = rsa.SignData(Encoding.GetEncoding(encoding).GetBytes(signatureData), hashAlgorithm);  
    return Convert.ToBase64String(signatureBytes);  
      
    }复制代码复制失败复制成功

提示：您可以通过斗拱CLI工具提供的verify_sign命令验证生成的签文是否正确；参见CLI工具介绍

如何签

仅对数据中的内容进行验签

1. 数据中的数据，同步返参参数字典顺序排序生成字符串，自动返参不需要排序。

以上文为例整理后

{
 "auth_code": "134558771750600000",
 "devs_id": "TYXJL0623715525894234",
 "terminal_device_info": "{\"devs_id\":\"TYXJL0623715525894234\"}"
}复制代码复制失败复制成功

注：如果是JSON字符串，不需要进行排序，例如terminal_device_info不需要排序；

2. 对第一步生成的字符串结合斗拱平台进行验签
3. 經驗訂閱如下

java代码示例

/**
 * 使用汇付RSA公钥验签
 * @param data 待签名字符串
 * @param publicKeyBase64 公钥（Base64编码）
 * @return 验签结果
 * @throws Exception
 */
public static boolean verify(String data, String publicKeyBase64, String sign) {
   // Base64 --> Key
   try {
          byte[] bytes = Base64.getDecoder().decode(publicKeyBase64);
          X509EncodedKeySpec keySpec = new X509EncodedKeySpec(bytes);
          KeyFactory keyFactory;
          keyFactory = KeyFactory.getInstance("RSA");
          PublicKey publicKey = keyFactory.generatePublic(keySpec);
          // verify
          Signature signature = Signature.getInstance("SHA256WithRSA");
          signature.initVerify(publicKey);
          signature.update(data.getBytes("UTF-8"));
          return signature.verify(Base64.getDecoder().decode(sign));
   } catch (Exception e) {
          logger.error("Exception", e);
          return false;
   }
 
}复制代码复制失败复制成功

python代码示例

# 使用汇付公钥验签
def rsa_design(signature, message, my_rsa_public):
    try:
        my_rsa_public = fill_public_key_marker(my_rsa_public)
        message = message.encode("utf-8")
        public_key = RSA.importKey(my_rsa_public)
        # message做“哈希”处理，RSA签名这么要求的
        hash_obj = SHA256.new(message)

        pkcs1_15.new(public_key).verify(hash_obj, base64.b64decode(signature))
        return True, ''
    except (ValueError, TypeError) as ex:
        return False, str(ex)复制代码复制失败复制成功

PHP代码示例

/**
 * 汇付公钥验签（对数据源排序），可用于 V2 版本接口返回数据验签
 *
 * @param string $signature 签文
 * @param array $data 原数据(array)
 * @param string $rsaPublicKey 公钥
 * @param int $alg 默认 OPENSSL_ALGO_SHA256
 *
 * @return false|int 验证结果：成功/失败
 */
function verifySign_sort($signature, $data, $rsaPublicKey, $alg=OPENSSL_ALGO_SHA256){
    $key = "-----BEGIN PUBLIC KEY-----\n".wordwrap($rsaPublicKey, 64, "\n", true)."\n-----END PUBLIC KEY-----";
    ksort($data);
    return openssl_verify(json_encode($data, JSON_UNESCAPED_SLASHES|JSON_UNESCAPED_UNICODE), base64_decode($signature), $key, $alg);
}复制代码复制失败复制成功

C#代码示例

//使用汇付公钥验签
public static bool verfySign(string publicKey, string signature, string content, string hashAlgorithm = "SHA256", string encoding = "UTF-8")  
{  
  
    RSACryptoServiceProvider rsa = new RSACryptoServiceProvider();  
    //导入公钥，准备验证签名  
    rsa.FromPublicKeyJavaString(publicKey);  
    //返回数据验证结果  
    byte[] Data = Encoding.GetEncoding(encoding).GetBytes(content);  
    byte[] rgbSignature = Convert.FromBase64String(signature);  
      
    return rsa.VerifyData(Data, hashAlgorithm, rgbSignature);  
}