支付宝接口的数字签名

时间:2023-01-30 18:02:57

通过阅读本篇文章,你可以了解到数字签名技术,了解支付宝接口的签名和验签的流程

签名

某些情况下(例如用户扫码支付成功时),支付宝会给商户系统发送异步通知。在发送异步通知时,支付宝会对通知参数进行签名,并将 “签名字符串 sign” 作为通知参数发送给商户系统。支付宝签名的步骤是:

  1. 拼接 “待签名字符串”;
  2. 调用签名方法 sign();
  3. 拼接完整的请求 URL。

技术是为了解决问题而生的,进行数字签名的目的是:

  • 确保信息是由签名者发送的。防止有人冒充支付宝向商户系统发送异步通知;
  • 确保信息自签名后 到 收到为止,信息未被修改过。防止有人篡改请求参数的值。

如果商家设置的通知地址为 https://api.xx.com/receive_notify.htm,对应收到的通知示例如下:

https://api.xx.com/receive_notify.htm?

total_amount=2.00&buyer_id=2088102116773037&body=大乐透2.1&trade_no=2016071921001003030200089909&refund_fee=0.00&notify_time=2016-07-19 14:10:49&subject=大乐透2.1&sign_type=RSA2&charset=utf-8&notify_type=trade_status_sync&out_trade_no=0719141034-6418&gmt_close=2016-07-19 14:10:46&gmt_payment=2016-07-19 14:10:47&trade_status=TRADE_SUCCESS&version=1.0&

sign=kPbQIjX+xQc8F0/A6/AocELIjhhZnGbcBN6G4MM/HmfWL4ZiHM6fWl5NQhzXJusaklZ1LFuMo+lHQUELAYeugH8LYFvxnNajOvZhuxNFbN2LhF0l/KL8ANtj8oyPM4NN7Qft2kWJTDJUpQOzCzNnV9hDxh5AaT9FPqRS6ZKxnzM=&

gmt_create=2016-07-19 14:10:44&app_id=2015102700040153&seller_id=2088102119685838&notify_id=4a91b7a78a503640467525113fb7d8bg8e

1 、拼接 “待签名字符串”

支付宝对要发送的通知参数进行签名的第一步是:拼接 “待签名字符串”。

  1. 对需要签名的参数进行字典排序:字典排序是按照参数的第一个字符的 ASCII 码递增排序(字母升序排序)。如果参数的第一个字符相同,则按照参数的第二个字符的 ASCII 码递增排序,以此类推。
  2. 对排序后的参数进行拼接,得到 “待签名字符串”:将排序后的参数与其对应值,组合成参数=参数值的格式,参数与参数之间用 & 字符连接起来,此时生成的字符串为 “待签名字符串”。

2、调用签名方法 sign()

支付宝对要发送的通知参数进行签名的第二步是:调用签名算法对应的签名方法 sign(),生成签名字符串 sign。

调用签名算法对应的签名方法时,需要提供以下几个参数:待签名字符串 content、字符编码方案 charset(UTF-8、GBK)和 签名者的私钥 privateKey。签名方法 sign() 的处理逻辑如下:

  1. 对 “待签名字符串” 进行编码,得到字节数组:使用指定的字符编码方案,将 “待签名字符串” 编码为字节数组(byte 类型的数组)
  2. 进行签名、Base64 编码,得到签名字符串 sign:使用签名者的私钥 privateKey 对 “待签名字符串” 对应的字节数组进行签名,并对签名结果进行 Base64 编码,以便在网络上传输。经过 Base64 编码后的字符串即为 “签名字符串 sign”。String sign = new String(Base64.encodeBase64(signed));

3、拼接完整的请求 URL

支付宝对要发送的通知参数进行签名的第三步是:拼接完整的请求 URL。

  1. 拼接 sign 参数:将生成的签名字符串作为 sign 参数的 value 拼接到请求数据中。
  2. Encode 请求数据:对所有一级 key 的 value 值进行 UrlEncode 编码。
  3. 拼接完整的请求 URL:将编码后的请求数据发送至商户系统指定的 URL。

验签

验签的全称是:验证指定内容的签名是否正确。

商户系统收到支付宝发送的异步通知后,商户系统需要对支付宝发送的通知参数进行验签处理。商户系统验签的步骤是:

  1. 拼接 “待验签字符串”;
  2. 获取签名字符串 sign;
  3. 调用验签方法 verify(),获得验签结果。

1、拼接 “待验签字符串”

对支付宝发送的通知参数进行验签的第一步是:拼接 “待验签字符串”。

  1. 获取签名的参数:在通知返回的参数列表中,除去 sign、sign_type 两个参数外,凡是通知返回的参数都是签名的参数。
  2. 对签名的参数进行 UrlDecode 解码
  3. 对签名的参数进行字典排序:字典排序是按照参数的第一个字符的 ASCII 码递增排序(字母升序排序)。如果参数的第一个字符相同,则按照参数的第二个字符的 ASCII 码递增排序,以此类推。
  4. 对排序后的参数进行拼接,得到 “待验签字符串”:将排序后的参数与其对应值,组合成参数=参数值的格式,参数与参数之间用 & 字符连接起来,此时生成的字符串为 “待验签字符串”。
body=大乐透2.1&buyer_id=2088102116773037&charset=utf-8&gmt_close=2016-07-19 14:10:46&gmt_payment=2016-07-19 14:10:47&notify_time=2016-07-19 14:10:49&notify_type=trade_status_sync&out_trade_no=0719141034-6418&refund_fee=0.00&subject=大乐透2.1&total_amount=2.00&trade_no=2016071921001003030200089909&trade_status=TRADE_SUCCESS&version=1.0

2、取出签名字符串 sign

对支付宝发送的通知参数进行验签的第二步是:从通知返回的参数列表中,取出签名字符串 sign。

3、调用验签方法 verify()

对支付宝发送的通知参数进行验签的第三步是:调用签名算法对应的验签方法 verify(),根据验签方法 verify() 的返回结果判定是否验签通过。


调用签名算法对应的验签方法时,需要提供以下几个参数:待验签字符串 content、字符编码方案 charset、签名字符串 sign 和 签名者的公钥 publicKey。验签方法 verify() 的处理逻辑如下:

  1. 对 “待验签字符串” 进行编码,得到字节数组:使用指定的字符编码方案,将 “待验签符串” 编码为字节数组(byte 类型的数组)
  2. 对 “签名字符串 sign” 进行 Base64 解码,得到字节数组:得到的这个字节数组即为当时签名之后的初始字节数组(密文)。
  3. 使用公钥验证签名boolean varifyResult = boosignature.verify(Base64.decodeBase64(sign.getBytes()))
    1. 使用签名者的公钥 publicKey 对 密文 进行 解密,得到 “支付宝通知的摘要”;
    2. 对 “待验签符串” 对应的字节数组做摘要,得到摘要结果;
    3. 将 “商户计算出的摘要结果” 和 “解密得到的摘要” 作比较:如果二者相同,则说明验签成功;否则说明验签失败。

验签成功后,商户系统根据通知参数进行业务处理。

参考资料

自行实现签名 - 支付宝文档中心 (alipay.com)

自行实现验签 - 支付宝文档中心 (alipay.com)