签名工具
有赞云签名工具接入指南
概述
YzCloudSignature 是有赞云 RSA 签名/验签工具类，支持 SHA1WithRSA 算法。本文档介绍如何将其独立接入到您的项目中，无需依赖有赞云 SDK。环境要求
依赖配置
pom.xml 中添加以下依赖：<!-- Apache Commons Lang - 字符串工具 -->
<dependency>
<groupId>commons-lang</groupId>
<artifactId>commons-lang</artifactId>
<version>2.6</version>
</dependency>
<!-- Apache Commons Codec - Base64 编解码 -->
<dependency>
<groupId>commons-codec</groupId>
<artifactId>commons-codec</artifactId>
<version>1.15</version>
</dependency>
<!-- Apache Commons IO - IO 工具 -->
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.11.0</version>
</dependency>
<!-- BouncyCastle - 加密库 -->
<dependency>
<groupId>org.bouncycastle</groupId>
<artifactId>bcprov-jdk15on</artifactId>
<version>1.70</version>
</dependency>
代码获取
YzCloudSignature.java 文件复制到您的项目中：点击查看代码（YzCloudSignature.java）
com.yourpackage.utils.YzCloudSignaturepackage 声明。密钥格式
私钥格式（PKCS8）
MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQC...
-----BEGIN PRIVATE KEY-----
...
-----END PRIVATE KEY-----公钥格式（X509）
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC...
-----BEGIN PUBLIC KEY-----
...
-----END PUBLIC KEY-----使用示例
1. 签名
2. 验签
API 说明
签名方法
| 方法 | 说明 |
|---|---|
String rsaSign(Map<String, String> params, String privateKey) | RSA 签名，返回 Base64 编码的签名 |
String rsaSignContent(String content, String privateKey, String charset) | 对指定内容进行 RSA 签名 |
String getSignContent(Map<String, String> params) | 获取签名内容（过滤空值，参数按字典序排序） |
验签方法
| 方法 | 说明 |
|---|---|
boolean rsaCheck(Map<String, String> params, String publicKey) | RSA 验签，自动从 params 中获取 sign 字段 |
boolean rsaCheckContent(String content, String sign, String publicKey, String charset) | 对指定内容进行 RSA 验签 |
String getSignCheckContent(Map<String, String> params) | 获取验签内容（去除 sign 字段后，参数按字典序排序） |
密钥解析方法
| 方法 | 说明 |
|---|---|
PrivateKey getPrivateKeyFromPKCS8(String algorithm, InputStream ins) | 从 PKCS8 格式字符串解析私钥 |
PublicKey getPublicKeyFromX509(String algorithm, InputStream ins) | 从 X509 格式字符串解析公钥 |
签名规则
1.
2.
3.
key1=value1&key2=value2&key3=value34.
5.
常见问题
Q1: 提示 "RSA私钥格式 不正确"
-----BEGIN RSA PRIVATE KEY-----），需要转换为 PKCS8 格式。Q2: 验签总是失败
1.
2.
3.
4.
Q3: JDK 1.7 兼容性
版本历史
| 版本 | 日期 | 说明 |
|---|---|---|
| 1.0.0 | 2026-02 | 独立版本发布，移除 SDK 依赖 |
修改于 2026-02-09 08:34:26