签名
某些情况下(例如用户扫码支付成功时),支付宝会给商户系统发送异步通知。在发送异步通知时,支付宝会对通知参数进行签名,并将 “签名字符串 sign” 作为通知参数发送给商户系统。支付宝签名的步骤是:
- 拼接 “待签名字符串”;
- 调用签名方法 sign();
- 拼接完整的请求 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¬ify_time=2016-07-19 14:10:49&subject=大乐透2.1&sign_type=RSA2&charset=utf-8¬ify_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¬ify_id=4a91b7a78a503640467525113fb7d8bg8e
1 、拼接 “待签名字符串”
支付宝对要发送的通知参数进行签名的第一步是:拼接 “待签名字符串”。
- 对需要签名的参数进行字典排序:字典排序是按照参数的第一个字符的 ASCII 码递增排序(字母升序排序)。如果参数的第一个字符相同,则按照参数的第二个字符的 ASCII 码递增排序,以此类推。
- 对排序后的参数进行拼接,得到 “待签名字符串”:将排序后的参数与其对应值,组合成
参数=参数值
的格式,参数与参数之间用 & 字符连接起来,此时生成的字符串为 “待签名字符串”。
2、调用签名方法 sign()
支付宝对要发送的通知参数进行签名的第二步是:调用签名算法对应的签名方法 sign(),生成签名字符串 sign。
调用签名算法对应的签名方法时,需要提供以下几个参数:待签名字符串 content、字符编码方案 charset(UTF-8、GBK)和 签名者的私钥 privateKey。签名方法 sign() 的处理逻辑如下:
- 对 “待签名字符串” 进行编码,得到字节数组:使用指定的字符编码方案,将 “待签名字符串” 编码为字节数组(byte 类型的数组)
- 进行签名、Base64 编码,得到签名字符串 sign:使用签名者的私钥 privateKey 对 “待签名字符串” 对应的字节数组进行签名,并对签名结果进行 Base64 编码,以便在网络上传输。经过 Base64 编码后的字符串即为 “签名字符串 sign”。
String sign = new String(Base64.encodeBase64(signed));
3、拼接完整的请求 URL
支付宝对要发送的通知参数进行签名的第三步是:拼接完整的请求 URL。
- 拼接 sign 参数:将生成的签名字符串作为 sign 参数的 value 拼接到请求数据中。
- Encode 请求数据:对所有一级 key 的 value 值进行 UrlEncode 编码。
- 拼接完整的请求 URL:将编码后的请求数据发送至商户系统指定的 URL。
验签
验签的全称是:验证指定内容的签名是否正确。
商户系统收到支付宝发送的异步通知后,商户系统需要对支付宝发送的通知参数进行验签处理。商户系统验签的步骤是:
- 拼接 “待验签字符串”;
- 获取签名字符串 sign;
- 调用验签方法 verify(),获得验签结果。
1、拼接 “待验签字符串”
对支付宝发送的通知参数进行验签的第一步是:拼接 “待验签字符串”。
- 获取签名的参数:在通知返回的参数列表中,除去 sign、sign_type 两个参数外,凡是通知返回的参数都是签名的参数。
- 对签名的参数进行 UrlDecode 解码
- 对签名的参数进行字典排序:字典排序是按照参数的第一个字符的 ASCII 码递增排序(字母升序排序)。如果参数的第一个字符相同,则按照参数的第二个字符的 ASCII 码递增排序,以此类推。
- 对排序后的参数进行拼接,得到 “待验签字符串”:将排序后的参数与其对应值,组合成
参数=参数值
的格式,参数与参数之间用 & 字符连接起来,此时生成的字符串为 “待验签字符串”。
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¬ify_time=2016-07-19 14:10:49¬ify_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() 的处理逻辑如下:
- 对 “待验签字符串” 进行编码,得到字节数组:使用指定的字符编码方案,将 “待验签符串” 编码为字节数组(byte 类型的数组)
- 对 “签名字符串 sign” 进行 Base64 解码,得到字节数组:得到的这个字节数组即为当时签名之后的初始字节数组(密文)。
使用公钥验证签名:
boolean varifyResult = boosignature.verify(Base64.decodeBase64(sign.getBytes()))
- 使用签名者的公钥 publicKey 对 密文 进行 解密,得到 “支付宝通知的摘要”;
- 对 “待验签符串” 对应的字节数组做摘要,得到摘要结果;
- 将 “商户计算出的摘要结果” 和 “解密得到的摘要” 作比较:如果二者相同,则说明验签成功;否则说明验签失败。
验签成功后,商户系统根据通知参数进行业务处理。