在支付宝开放平台的应用体系中,应用私钥是最核心的安全要素,使用密钥管理服务KMS(Key Management Service)保护私钥,可以极大的提高支付宝应用和小程序的安全性,帮助应用开发者保障业务和资金安全。
背景信息
支付宝开放平台的应用管理体系采用公私钥的机制,以保障商户应用和支付宝交互的安全性。这一机制包括以下两部分:
商户应用使用自己的私钥对消息加签后,将消息和签名传递给支付宝,支付宝则使用应用的公钥验证消息的真实性(来自于合法应用的真实消息)。
对于支付宝返回消息给商户应用的情形,应用则使用支付宝的平台公钥来验证返回消息的真实性。
该机制的前提是:商户应用必须保障应用私钥的安全性,从而保障应用和支付宝交互的安全性。反之,一旦私钥发生泄露,商户会面临较大的安全风险。如果应用和支付宝的交互涉及到资金类接口则风险更大。
产品价值
相比于在应用中使用应用私钥的明文来对消息进行加签,KMS存在以下优势:
保障私钥安全性:用户可以将签名私钥安全存放在KMS托管密码机内。用户通过KMS的OpenAPI使用私钥加签时,私钥会在密码机的硬件安全边界之内,完成运算后返回签名值,从而防止私钥的泄露。托管密码机详情,请参见托管密码机概述。
控制私钥使用者:用户可以通过阿里云访问控制RAM(Resource Access Management),集中管控KMS密钥使用成员,用于应用加签。
审计对私钥的调用日志:通过阿里云操作审计(ActionTrail)可以查看每一次调用KMS的记录;而商家应用自行保管私钥则很难产生客观的审计事件。
灵活响应安全事件:在应用系统遭遇恶意者攻击等情形下,可以通过多种手段阻止恶意者对私钥的非法使用。例如:用户可以通过RAM撤销对私钥的使用权限,或者通过KMS禁用私钥等。
使用KMS控制台为支付宝应用或小程序加签
在KMS中创建密钥。
登录密钥管理服务控制台。
在页面左上角的地域下拉列表,选择密钥所在的地域。
建议您选择和支付宝应用或小程序相同的地域。
在左侧导航栏,单击用户主密钥。
单击创建密钥。
在弹出的创建密钥对话框,根据以下表格进行配置。
配置项
说明
KMS实例
选择默认。
密钥类型
选择RSA_2048。
密钥用途
选择Sign/Verify。
别名
输入密钥别名信息。
保护级别
选择Hsm:通过KMS系统的硬件加密机产生和保护密钥。
描述
输入密钥描述信息。
轮转周期
默认为不开启。
单击确定。
在支付宝配置密钥。
支付宝开放平台提供了普通公钥方式和公钥证书方式两种密钥配置方法。公钥证书方式是对普通公钥方式的增强机制,从数字签名的角度来看,二者机制大同小异,商户应用只需要选择其中一种即可。
说明对于涉及到资金往来的商户应用,应当使用公钥证书的方式。
方法一:普通公钥方式
从KMS获取应用公钥,注册到支付宝开放平台对应的应用中。
登录密钥管理服务控制台。
在页面左上角的地域下拉列表,选择密钥所在的地域。
在左侧导航栏,单击用户主密钥。
找到已创建的RSA_2048类型密钥,单击别名进入详情页。
在密钥版本区域,单击查看公钥。
在查看公钥对话框,复制或下载公钥。
登录支付宝开放平台。
打开需要加密的应用,在左侧导航栏选择开发设置。
在开发设置页面,单击接口加密方式右侧的设置,阅读接口加签方式注意事项,然后点击确定进入配置流程。
设置加签方式,选择
。生成密钥文件。
下载并安装支付宝开放平台密钥工具。
打开密钥工具,进入生成密钥功能。
加签方式选择密钥,加签算法选择RSA2。(开放平台暂未开放SM2的支持)
点击生成密钥,可以在结果页中看到生成的应用公钥、应用私钥。
说明RSA2加密算法默认生成格式为PKCS8(Java适用),如需PKCS1格式(非Java适用),可使用格式转换。
复制应用公钥字符串。
返回开放平台控制台中,点击下一步。
上传应用公钥。粘贴复制的应用公钥字符串,点击确认上传。此时需要输入短信验证码或支付密码,完成安全验证。
密钥配置完成。
方法二:公钥证书方式
从KMS获取私钥证书请求CSR,到支付宝开放平台完成应用证书注册和签发。
登录密钥管理服务控制台。
在页面左上角的地域下拉列表,选择密钥所在的地域。
在左侧导航栏,单击用户主密钥。
找到已创建的RSA_2048类型密钥,单击别名进入详情页。
在密钥版本区域,单击生成CSR。
在生成CSR对话框,根据控制台提示填写证书信息。
说明企业/单位名称必须和支付宝开发者中心门户账号信息的公司名称保持一致,否则会导致后续步骤中上传CSR证书文件校验失败。
登录支付宝开放平台。
打开需要加密的应用,在左侧导航栏选择开发设置。
在开发设置页面,单击接口加密方式右侧的设置,阅读接口加签方式注意事项,然后点击确定进入配置流程。
设置加签方式,选择证书>下一步。
生成CSR文件。
下载并安装支付宝开放平台密钥工具。
打开密钥工具,进入生成密钥功能。
加签方式选择证书,加签算法选择RSA2。(开放平台暂未开放SM2的支持)
填写组织/公司,必须与开放平台主账号名称完全相同。
点击生成CSR文件,可以点击打开文件位置查看生成的应用私钥、应用公钥和CSR文件。
返回开放平台控制台中,点击下一步。
上传生成的CSR文件,选择证书到期后的处理方式(默认为自动签发),设置安全联系人信息,签署开放平台服务协议。点击确认上传。此时需要输入短信验证码或支付密码,完成安全验证。
证书配置完成。
使用支付宝SDK调用KMS为支付宝应用或小程序加签
支付宝开放平台新版SDK(EasySDK)集成了KMS作为加签提供器(Sign Provider),以简化加签操作。以Java SDK为例,您需要在支付宝应用中引用EasySDK 2.0.1以及之后的版本。
<dependency>
<groupId>com.alipay.sdk</groupId>
<artifactId>alipay-easysdk</artifactId>
<version>2.0.1</version>
</dependency>
如果遵循支付宝开放API的签名规则,也可以不使用EasySDK,通过调用阿里云KMS的AsymmetricSign接口自行实现签名。
代码示例:普通公钥方式
阿里云账号AccessKey拥有所有OpenAPI的访问权限,建议您使用RAM用户进行API访问或日常运维。强烈建议不要把AccessKey ID和AccessKey Secret保存到工程代码里,否则可能导致AccessKey泄露,威胁您账号下所有资源的安全。
本示例以将AccessKey配置在环境变量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET的方式来实现身份验证为例。
更多认证信息配置方式,请参见Credentials 设置。
不同操作系统的环境变量配置方法不同,具体操作,请参见在Linux、macOS和Windows系统配置环境变量。
package com.aliyun.kms.samples;
import com.alipay.easysdk.base.qrcode.models.AlipayOpenAppQrcodeCreateResponse;
import com.alipay.easysdk.factory.Factory;
import com.alipay.easysdk.kms.aliyun.AliyunKMSConfig;
import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.util.Map;
/**
* Alipay-easysdk使用KMS签名示例,本示例展示了公钥方式调用。
*/
public class KmsAlipayEasySDKPublicKeyDemo {
public static void main(String[] args) {
Factory.setOptions(getOptions());
try {
AlipayOpenAppQrcodeCreateResponse response = Factory.Base.Qrcode().create("page/component/component-pages/view/view", "x=1", "二维码描述");
if ("10000".equals(response.code)) {
System.out.println("调用成功");
} else {
System.err.println("调用失败,原因:" + response.msg + "," + response.subMsg);
}
} catch (Exception e) {
System.err.println("调用遭遇异常,原因:" + e.getMessage());
throw new RuntimeException(e.getMessage(), e);
}
}
private static AliyunKMSConfig getOptions() {
AliyunKMSConfig config = new AliyunKMSConfig();
config.protocol = "https";
config.gatewayHost = "openapi.alipay.com";
config.signType = "RSA2";
//请更换为您的AppID。
config.appId = "202100****";
//请修改如下的支付宝公钥字符串为自己的支付宝公钥。
config.alipayPublicKey = "MIIBIjANB...";
//如果使用阿里云KMS签名,则需要指定签名提供方名称,阿里云KMS的名称为"AliyunKMS"。
config.signProvider = "AliyunKMS";
config.aliyunAccessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
config.aliyunAccessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
//如果使用阿里云KMS签名,请更换为您的KMS服务密钥ID。
config.kmsKeyId = "4358f298-8e30-4849-9791-****";
//如果使用阿里云KMS签名,请更换为您的KMS服务密钥版本ID。
config.kmsKeyVersionId = "e71daa69-c321-4014-b0c4-****";
//如果使用阿里云KMS签名,需要更换为您的KMS服务地址。
//KMS服务地址列表详情,请参考:
//https://help.aliyun.com/document_detail/69006.html
config.kmsEndpoint = "kms.cn-hangzhou.aliyuncs.com";
return config;
}
}
代码示例:公钥证书方式
使用公钥证书方式时,EasySDK的使用方式和上述示例类似,区别主要在于配置了商户应用和支付宝平台的公钥证书。更多信息,请参见阿里云KMS Github代码样例库。