cn.hutool.crypto.asymmetric

Class SM2

java.lang.Object

cn.hutool.crypto.asymmetric.BaseAsymmetric<T>

cn.hutool.crypto.asymmetric.AbstractAsymmetricCrypto<SM2>

cn.hutool.crypto.asymmetric.SM2

All Implemented Interfaces:

AsymmetricDecryptor, AsymmetricEncryptor, Serializable

public class SM2
extends AbstractAsymmetricCrypto<SM2>

国密SM2非对称算法实现，基于BC库
SM2算法只支持公钥加密，私钥解密
参考：https://blog.csdn.net/pridas/article/details/86118774

国密算法包括：

1. 非对称加密和签名：SM2
2. 摘要签名算法：SM3
3. 对称加密：SM4

Since:

4.3.2

Author:

looly

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected org.bouncycastle.crypto.engines.SM2Engine	engine
protected org.bouncycastle.crypto.signers.SM2Signer	signer

Fields inherited from class cn.hutool.crypto.asymmetric.BaseAsymmetric

algorithm, lock, privateKey, publicKey

Constructor Summary

Constructors

Constructor and Description
SM2() 构造，生成新的私钥公钥对
SM2(byte[] privateKey, byte[] publicKey) 构造 私钥和公钥同时为空时生成一对新的私钥和公钥 私钥和公钥可以单独传入一个，如此则只能使用此钥匙来做加密或者解密
SM2(byte[] privateKey, byte[] publicKeyPointX, byte[] publicKeyPointY) 构造 私钥和公钥同时为空时生成一对新的私钥和公钥 私钥和公钥可以单独传入一个，如此则只能使用此钥匙来做加密或者解密
SM2(org.bouncycastle.crypto.params.ECPrivateKeyParameters privateKeyParams, org.bouncycastle.crypto.params.ECPublicKeyParameters publicKeyParams) 构造 私钥和公钥同时为空时生成一对新的私钥和公钥 私钥和公钥可以单独传入一个，如此则只能使用此钥匙来做加密或者解密
SM2(PrivateKey privateKey, PublicKey publicKey) 构造 私钥和公钥同时为空时生成一对新的私钥和公钥 私钥和公钥可以单独传入一个，如此则只能使用此钥匙来做加密或者解密
SM2(String privateKeyStr, String publicKeyStr) 构造 私钥和公钥同时为空时生成一对新的私钥和公钥 私钥和公钥可以单独传入一个，如此则只能使用此钥匙来做加密或者解密
SM2(String privateKeyHex, String publicKeyPointXHex, String publicKeyPointYHex) 构造 私钥和公钥同时为空时生成一对新的私钥和公钥 私钥和公钥可以单独传入一个，如此则只能使用此钥匙来做加密或者解密

Method Summary

Modifier and Type	Method and Description
byte[]	decrypt(byte[] data) 使用私钥解密
byte[]	decrypt(byte[] data, org.bouncycastle.crypto.CipherParameters privateKeyParameters) 解密
byte[]	decrypt(byte[] data, KeyType keyType) 解密
byte[]	encrypt(byte[] data) 使用公钥加密，SM2非对称加密的结果由C1,C3,C2三部分组成，其中： C1 生成随机数的计算出的椭圆曲线点 C3 SM3的摘要值 C2 密文数据
byte[]	encrypt(byte[] data, org.bouncycastle.crypto.CipherParameters pubKeyParameters) 加密，SM2非对称加密的结果由C1,C2,C3三部分组成，其中： C1 生成随机数的计算出的椭圆曲线点 C2 密文数据 C3 SM3的摘要值
byte[]	encrypt(byte[] data, KeyType keyType) 加密，SM2非对称加密的结果由C1,C3,C2三部分组成，其中： C1 生成随机数的计算出的椭圆曲线点 C3 SM3的摘要值 C2 密文数据
byte[]	getD() 获得私钥D值（编码后的私钥）
BigInteger	getDBigInteger() 获得私钥D值
String	getDHex() 获得私钥D值（编码后的私钥）
byte[]	getQ(boolean isCompressed) 获得公钥Q值（编码后的公钥）
SM2	init() 初始化 私钥和公钥同时为空时生成一对新的私钥和公钥 私钥和公钥可以单独传入一个，如此则只能使用此钥匙来做加密（签名）或者解密（校验）
SM2	initKeys() 生成公钥和私钥
SM2	setDigest(org.bouncycastle.crypto.Digest digest) 设置Hash算法
SM2	setEncoding(org.bouncycastle.crypto.signers.DSAEncoding encoding) 设置DSA signatures的编码
SM2	setMode(org.bouncycastle.crypto.engines.SM2Engine.Mode mode) 设置SM2模式，旧版是C1C2C3，新版本是C1C3C2
SM2	setPrivateKey(PrivateKey privateKey) 设置私钥
SM2	setPrivateKeyParams(org.bouncycastle.crypto.params.ECPrivateKeyParameters privateKeyParams) 设置私钥参数
SM2	setPublicKey(PublicKey publicKey) 设置公钥
SM2	setPublicKeyParams(org.bouncycastle.crypto.params.ECPublicKeyParameters publicKeyParams) 设置公钥参数
byte[]	sign(byte[] data) 用私钥对信息生成数字签名，签名格式为ASN1 * 在硬件签名中，返回结果为R+S，可以通过调用SmUtil.rsAsn1ToPlain(byte[])方法转换之。
byte[]	sign(byte[] data, byte[] id) 用私钥对信息生成数字签名，签名格式为ASN1 在硬件签名中，返回结果为R+S，可以通过调用SmUtil.rsAsn1ToPlain(byte[])方法转换之。
String	signHex(String dataHex) Deprecated. 歧义，使用signHexFromHex(String)
String	signHex(String dataHex, String idHex) Deprecated. 歧义，使用signHexFromHex(String, String)
String	signHexFromHex(String dataHex) 用私钥对信息生成数字签名
String	signHexFromHex(String dataHex, String idHex) 用私钥对信息生成数字签名
SM2	usePlainEncoding() 设置DSA signatures的编码为PlainDSAEncoding
boolean	verify(byte[] data, byte[] sign) 用公钥检验数字签名的合法性
boolean	verify(byte[] data, byte[] sign, byte[] id) 用公钥检验数字签名的合法性
boolean	verifyHex(String dataHex, String signHex) 用公钥检验数字签名的合法性
boolean	verifyHex(String dataHex, String signHex, String idHex) 用公钥检验数字签名的合法性

Methods inherited from class cn.hutool.crypto.asymmetric.BaseAsymmetric

getKeyByType, getPrivateKey, getPrivateKeyBase64, getPublicKey, getPublicKeyBase64, init, setKey

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface cn.hutool.crypto.asymmetric.AsymmetricEncryptor

encrypt, encrypt, encrypt, encrypt, encryptBase64, encryptBase64, encryptBase64, encryptBase64, encryptBcd, encryptBcd, encryptHex, encryptHex, encryptHex, encryptHex

Methods inherited from interface cn.hutool.crypto.asymmetric.AsymmetricDecryptor

decrypt, decrypt, decryptFromBcd, decryptFromBcd, decryptStr, decryptStr, decryptStrFromBcd, decryptStrFromBcd

Field Detail

engine

protected org.bouncycastle.crypto.engines.SM2Engine engine

signer

protected org.bouncycastle.crypto.signers.SM2Signer signer

Constructor Detail

SM2

public SM2()

构造，生成新的私钥公钥对

SM2

public SM2(String privateKeyStr,
           String publicKeyStr)

构造
私钥和公钥同时为空时生成一对新的私钥和公钥
私钥和公钥可以单独传入一个，如此则只能使用此钥匙来做加密或者解密

Parameters:

privateKeyStr - 私钥Hex或Base64表示，必须使用PKCS#8规范

publicKeyStr - 公钥Hex或Base64表示，必须使用X509规范

SM2

public SM2(byte[] privateKey,
           byte[] publicKey)

构造
私钥和公钥同时为空时生成一对新的私钥和公钥
私钥和公钥可以单独传入一个，如此则只能使用此钥匙来做加密或者解密

Parameters:

privateKey - 私钥，可以使用PKCS#8、D值或PKCS#1规范

publicKey - 公钥，可以使用X509、Q值或PKCS#1规范

SM2

public SM2(PrivateKey privateKey,
           PublicKey publicKey)

构造
私钥和公钥同时为空时生成一对新的私钥和公钥
私钥和公钥可以单独传入一个，如此则只能使用此钥匙来做加密或者解密

Parameters:

privateKey - 私钥

publicKey - 公钥

SM2

public SM2(String privateKeyHex,
           String publicKeyPointXHex,
           String publicKeyPointYHex)

构造
私钥和公钥同时为空时生成一对新的私钥和公钥
私钥和公钥可以单独传入一个，如此则只能使用此钥匙来做加密或者解密

Parameters:

privateKeyHex - 私钥16进制

publicKeyPointXHex - 公钥X16进制

publicKeyPointYHex - 公钥Y16进制

Since:

5.2.0

SM2

public SM2(byte[] privateKey,
           byte[] publicKeyPointX,
           byte[] publicKeyPointY)

构造
私钥和公钥同时为空时生成一对新的私钥和公钥
私钥和公钥可以单独传入一个，如此则只能使用此钥匙来做加密或者解密

Parameters:

privateKey - 私钥

publicKeyPointX - 公钥X

publicKeyPointY - 公钥Y

Since:

5.2.0

SM2

public SM2(org.bouncycastle.crypto.params.ECPrivateKeyParameters privateKeyParams,
           org.bouncycastle.crypto.params.ECPublicKeyParameters publicKeyParams)

构造
私钥和公钥同时为空时生成一对新的私钥和公钥
私钥和公钥可以单独传入一个，如此则只能使用此钥匙来做加密或者解密

Parameters:

privateKeyParams - 私钥，可以为null

publicKeyParams - 公钥，可以为null

Method Detail

init

public SM2 init()

初始化
私钥和公钥同时为空时生成一对新的私钥和公钥
私钥和公钥可以单独传入一个，如此则只能使用此钥匙来做加密（签名）或者解密（校验）

Returns:

this

initKeys

public SM2 initKeys()

Description copied from class: BaseAsymmetric

生成公钥和私钥

Overrides:

initKeys in class BaseAsymmetric<SM2>

Returns:

this

encrypt

public byte[] encrypt(byte[] data)
               throws CryptoException

使用公钥加密，SM2非对称加密的结果由C1,C3,C2三部分组成，其中：

 C1 生成随机数的计算出的椭圆曲线点
 C3 SM3的摘要值
 C2 密文数据
 

Parameters:

data - 被加密的bytes

Returns:

加密后的bytes

Throws:

CryptoException - 包括InvalidKeyException和InvalidCipherTextException的包装异常

Since:

5.7.10

encrypt

public byte[] encrypt(byte[] data,
                      KeyType keyType)
               throws CryptoException

加密，SM2非对称加密的结果由C1,C3,C2三部分组成，其中：

 C1 生成随机数的计算出的椭圆曲线点
 C3 SM3的摘要值
 C2 密文数据
 

Parameters:

data - 被加密的bytes

keyType - 私钥或公钥 KeyType

Returns:

加密后的bytes

Throws:

CryptoException - 包括InvalidKeyException和InvalidCipherTextException的包装异常

encrypt

public byte[] encrypt(byte[] data,
                      org.bouncycastle.crypto.CipherParameters pubKeyParameters)
               throws CryptoException

加密，SM2非对称加密的结果由C1,C2,C3三部分组成，其中：

 C1 生成随机数的计算出的椭圆曲线点
 C2 密文数据
 C3 SM3的摘要值
 

Parameters:

data - 被加密的bytes

pubKeyParameters - 公钥参数

Returns:

加密后的bytes

Throws:

CryptoException - 包括InvalidKeyException和InvalidCipherTextException的包装异常

Since:

5.1.6

decrypt

public byte[] decrypt(byte[] data)
               throws CryptoException

使用私钥解密

Parameters:

data - SM2密文，实际包含三部分：ECC公钥、真正的密文、公钥和原文的SM3-HASH值

Returns:

加密后的bytes

Throws:

CryptoException - 包括InvalidKeyException和InvalidCipherTextException的包装异常

Since:

5.7.10

decrypt

public byte[] decrypt(byte[] data,
                      KeyType keyType)
               throws CryptoException

解密

Parameters:

data - SM2密文，实际包含三部分：ECC公钥、真正的密文、公钥和原文的SM3-HASH值

keyType - 私钥或公钥 KeyType

Returns:

加密后的bytes

Throws:

CryptoException - 包括InvalidKeyException和InvalidCipherTextException的包装异常

decrypt

public byte[] decrypt(byte[] data,
                      org.bouncycastle.crypto.CipherParameters privateKeyParameters)
               throws CryptoException

解密

Parameters:

data - SM2密文，实际包含三部分：ECC公钥、真正的密文、公钥和原文的SM3-HASH值

privateKeyParameters - 私钥参数

Returns:

加密后的bytes

Throws:

CryptoException - 包括InvalidKeyException和InvalidCipherTextException的包装异常

Since:

5.1.6

signHexFromHex

public String signHexFromHex(String dataHex)

用私钥对信息生成数字签名

Parameters:

dataHex - 被签名的数据数据

Returns:

签名

signHex

@Deprecated
public String signHex(String dataHex)

Deprecated. 歧义，使用signHexFromHex(String)

用私钥对信息生成数字签名

Parameters:

dataHex - 被签名的数据数据

Returns:

签名

signHexFromHex

public String signHexFromHex(String dataHex,
                             String idHex)

用私钥对信息生成数字签名

Parameters:

dataHex - 被签名的数据数据

idHex - 可以为null，若为null，则默认withId为字节数组:"1234567812345678".getBytes()

Returns:

签名

signHex

@Deprecated
public String signHex(String dataHex,
                                   String idHex)

Deprecated. 歧义，使用signHexFromHex(String, String)

用私钥对信息生成数字签名

Parameters:

dataHex - 被签名的数据数据

idHex - 可以为null，若为null，则默认withId为字节数组:"1234567812345678".getBytes()

Returns:

签名

sign

public byte[] sign(byte[] data)

用私钥对信息生成数字签名，签名格式为ASN1
* 在硬件签名中，返回结果为R+S，可以通过调用SmUtil.rsAsn1ToPlain(byte[])方法转换之。

Parameters:

data - 加密数据

Returns:

签名

sign

public byte[] sign(byte[] data,
                   byte[] id)

用私钥对信息生成数字签名，签名格式为ASN1
在硬件签名中，返回结果为R+S，可以通过调用SmUtil.rsAsn1ToPlain(byte[])方法转换之。

Parameters:

data - 被签名的数据数据

id - 可以为null，若为null，则默认withId为字节数组:"1234567812345678".getBytes()

Returns:

签名

verifyHex

public boolean verifyHex(String dataHex,
                         String signHex)

用公钥检验数字签名的合法性

Parameters:

dataHex - 的数据

signHex - 签名

Returns:

是否验证通过

Since:

5.2.0

verify

public boolean verify(byte[] data,
                      byte[] sign)

用公钥检验数字签名的合法性

Parameters:

data - 数据

sign - 签名

Returns:

是否验证通过

verifyHex

public boolean verifyHex(String dataHex,
                         String signHex,
                         String idHex)

用公钥检验数字签名的合法性

Parameters:

dataHex - 数据的Hex值

signHex - 签名的Hex值

idHex - ID的Hex值

Returns:

是否验证通过

Since:

5.2.0

verify

public boolean verify(byte[] data,
                      byte[] sign,
                      byte[] id)

用公钥检验数字签名的合法性

Parameters:

data - 数据

sign - 签名

id - 可以为null，若为null，则默认withId为字节数组:"1234567812345678".getBytes()

Returns:

是否验证通过

setPrivateKey

public SM2 setPrivateKey(PrivateKey privateKey)

Description copied from class: BaseAsymmetric

设置私钥

Overrides:

setPrivateKey in class BaseAsymmetric<SM2>

Parameters:

privateKey - 私钥

Returns:

this

setPrivateKeyParams

public SM2 setPrivateKeyParams(org.bouncycastle.crypto.params.ECPrivateKeyParameters privateKeyParams)

设置私钥参数

Parameters:

privateKeyParams - 私钥参数

Returns:

this

Since:

5.2.0

setPublicKey

public SM2 setPublicKey(PublicKey publicKey)

Description copied from class: BaseAsymmetric

设置公钥

Overrides:

setPublicKey in class BaseAsymmetric<SM2>

Parameters:

publicKey - 公钥

Returns:

this

setPublicKeyParams

public SM2 setPublicKeyParams(org.bouncycastle.crypto.params.ECPublicKeyParameters publicKeyParams)

设置公钥参数

Parameters:

publicKeyParams - 公钥参数

Returns:

this

usePlainEncoding

public SM2 usePlainEncoding()

设置DSA signatures的编码为PlainDSAEncoding

Returns:

this

Since:

5.3.1

setEncoding

public SM2 setEncoding(org.bouncycastle.crypto.signers.DSAEncoding encoding)

设置DSA signatures的编码

Parameters:

encoding - DSAEncoding实现

Returns:

this

Since:

5.3.1

setDigest

public SM2 setDigest(org.bouncycastle.crypto.Digest digest)

设置Hash算法

Parameters:

digest - Digest实现

Returns:

this

Since:

5.3.1

setMode

public SM2 setMode(org.bouncycastle.crypto.engines.SM2Engine.Mode mode)

设置SM2模式，旧版是C1C2C3，新版本是C1C3C2

Parameters:

mode - SM2Engine.Mode

Returns:

this

getD

public byte[] getD()

获得私钥D值（编码后的私钥）

Returns:

D值

Since:

5.5.9

getDHex

public String getDHex()

获得私钥D值（编码后的私钥）

Returns:

D值

Since:

5.7.17

getDBigInteger

public BigInteger getDBigInteger()

获得私钥D值

Returns:

D值

Since:

5.7.17

getQ

public byte[] getQ(boolean isCompressed)

获得公钥Q值（编码后的公钥）

Parameters:

isCompressed - 是否压缩

Returns:

Q值

Since:

5.5.9