package com.sunyard.inf; import com.sunyard.RetWrap; import com.sunyard.cert.X509; /** * 签名验签相关接口 */ public interface SydSVApi extends SydNakedSVApi, SydAttachedSVApi, SydDetachedSVApi{ } /** * 不经过 CA 授信 * 直接使用公私钥对签名验签 */ interface SydNakedSVApi { /** * 使用指定的证书 DN，从加密设备获取对应的私钥证书，对指定的原始数据编制裸签名(遵循 PKCS#1) * @param orgData 待签名的原始数据 * @param sCertDN 签名者证书 DN * @return 签名数据 */ public byte[] SYD_NakedSign( byte[] orgData, String sCertDN ); /** * 使用指定的证书 DN，对指定的原始数据编制裸验签（遵循PKCS#1） * @param orgData 待签名的原始数据 * @param sign 签名数据 * @param sCertDN 签名者证书 DN * @return 验签是否通过 */ public boolean SYD_NakedVerify( byte[] orgData, byte[] sign, String sCertDN ); } /** * 带原文的签名验签 */ interface SydAttachedSVApi { /** * sm2私钥签名 * 用户id默认为1234567812345678 * 签名结果R/S序列串先进行der编码，再进行base64编码 * * @param flag 私钥标志位，当为1时第二个参数传入存储私钥的索引，当为0时第二个参数传入私钥 * @param privateKey 当私钥标志位为1时传入存储私钥的索引，当为0时传入私钥 * @param publicKey 公钥 * @param orgData 要签名的信息 * @return 签名结果 */ String SM2SignC(int flag, String privateKey, byte[] publicKey, byte[] orgData); String SM2SignC(int flag, String pUserID, String privateKey, byte[] publicKey, byte[] orgData); /** * SM2 私钥签名 * @param pUserID 使用者的 ID，最大长度为 16 位数字，右对齐。 * @param certNo 证书号 * @param nOrgDataType 原始数据类型 0 : hash 1 : 原数据 * @param publicKey 公钥的 DER 编码 * @param orgData 原始数据 * @return 签名的 base64 编码 */ String SM2SignC( String pUserID, String certNo, int nOrgDataType, byte[] publicKey, byte[] orgData ); /** * RSA 私钥签名 * @param HashMark 哈希标识 指示用于哈希证书数据的哈希算法的标识。0: SHA1 1: SHA256 2: MD5。 * @param privateKeyTag 私钥标记 指示私钥位置的标记。数字为存储私钥的索引，除了全9表示使用由命令中提供的密钥。 * 27位的索引号：16位机构号+3位密钥类型+8位密钥索引号 * @param nOrgDataType 原始数据类型 0 : hash 1 : 原数据 * @param orgData 原始数据 * @return 签名的 base64 编码 */ byte[] RSASignC( String privateKeyTag, int HashMark, int nOrgDataType, byte[] orgData); byte[] RSASign( String privateKey, int HashMark, int nOrgDataType, byte[] orgData); /** * 采用 RSA 算法，用指定的公钥对指定的原始数据进行数字签名验证。 * @param HashMark 哈希标识 * @param nOrgDataType 签名方式 * @param publicKey 公钥 * @param orgData 原始数据 * @param sign base64 格式的签名 * @return true 验签通过 false 验签失败 */ boolean RSAVerify( int HashMark, int nOrgDataType, byte[] publicKey, byte[] orgData, byte[] sign); /** * sm2验签 * 用户id默认为1234567812345678 * * @param publicKey 公钥的 DER 编码 * @param orgData 要签名的信息 * @param base64Sign 计算的签名，签名结果R/S序列串先进行der编码，再进行base64编码后的结果 * @return true 验签成功，false 验签失败 */ boolean SM2Verify(byte[] publicKey, byte[] orgData, String base64Sign); /** * 采用 SM2 算法，用指定的公钥对指定的原始数据进行数字签名验证。 * @param certNo id 用于计算SM3-HASH * @param nOrgDataType 原始数据类型 0 : hash 1 : 原数据，用1.2.3章节限定符亦可 * @param publicKey 公钥 * @param orgData 原始数据 * @param sign base64 格式的签名 * @return true 验签通过 false 验签失败 */ boolean SM2Verify( String certNo, int nOrgDataType, byte[] publicKey, byte[] orgData, String sign ); /** * SM2 私钥签名 * @param certNo 证书号 * @param orgData 原始数据 * @return 签名的 base64 编码 */ String SM2SignCustomized( String certNo, byte[] orgData ); /** * 采用 SM2 算法，用指定的公钥对指定的原始数据进行数字签名验证。 * @param certNo 证书号 * @param orgData 原始数据 * @param sign base64 格式的签名 * @return true 验签通过 false 验签失败 */ boolean SM2VerifyCustomized( String certNo, byte[] orgData, String sign ); /** * 带公钥证书与原始数据的数字签名（遵循 PKCS#7） * 使用指定的证书 DN，从加密设备获取对应的私钥证书，对指定的原始数据编制带公钥证书的数字签名（遵循 PKCS#7）。 * * @param orgData 待签名数据 * @param sCertDN 证书DN * @return * 符合PKCS7标准的签名结果 */ String attachedSign(byte[] orgData, String sCertDN); /** * 带公钥证书与原始数据的数字签名验签（遵循 PKCS#7） * 对指定的原始数据核验其带公钥证书签名。如签名有效（含证书无效）且需返回签名者公钥证书信息时，同时返回签名者公钥证书信息。 * * @param sign 已签名数据 * @return true 验签通过 false 验签失败 */ boolean attachedVerify(String sign); /** * 带公钥证书与原始数据的数字签名验签（遵循 PKCS#7） * 对指定的原始数据核验其带公钥证书签名。如签名有效（含证书无效）且需返回签名者公钥证书信息时，同时返回签名者公钥证书信息。 * * @param sign 已签名数据 * @return 成功返回签名的原数据，失败则报错 */ String attachedVerifyRD(String sign); /** * 带公钥证书与原始数据的数字签名验签（遵循 PKCS#7） * 对指定的原始数据核验其带公钥证书签名。如签名有效（含证书无效）且需返回签名者公钥证书信息时，同时返回签名者公钥证书信息。 * * @param sign 已签名数据 * @return * 若发送报文返回证书信息标志位为0，则返回已签名数据, * 若发送报文返回证书信息标志位为1，则返回CERT_INFO结构的证书数据 */ X509 attachedVerifyAndGetX509(String sign); /** * 带公钥证书与原始数据的数字签名验签（遵循 PKCS#7） * 对指定的原始数据核验其带公钥证书签名。如签名有效（含证书无效）且需返回签名者公钥证书信息时，同时返回签名者公钥证书信息。 * * @param sign 已签名数据 * @return * 若发送报文返回证书信息标志位为0，则返回已签名数据, * 若发送报文返回证书信息标志位为1，则返回CERT_INFO结构的证书数据 */ RetWrap attachedVerifyAndGetAll(String sign); } /** * 不带原文的签名验签 */ interface SydDetachedSVApi { /** * 对指定的原始数据核验其带公钥证书签名（PKCS#7） * @param orgData 待签名的原始数据 * @param sign 签名数据 * @return 验签是否通过 */ public boolean SYD_DetachedVerify( byte[] orgData, String sign); /** * 通过指定的私钥对指定的原始数据编制带公钥证书的数字签名（遵循PKCS#7） * @param orgData 待签名的原始数据 * @param sCertDN 签名者证书 DN * @return 签名数据 */ public String SYD_DetachedSign( byte[] orgData, String sCertDN ); /** * 通过指定的私钥对指定的原始数据编制带公钥证书的数字签名（遵循PKCS#7） * 待签名的原始数据将在接口内部进行 sm3 ，然后做 Detach 签名 * @param orgData 待签名的原始数据 * @param publicKey sm3 hash 所用的公钥 * @param sCertDN 签名者证书 DN * @return 签名数据 */ public String sm3AndDetachedSign( byte[] orgData, String publicKey, String sCertDN ); /** * 对指定的原始数据核验其带公钥证书签名（PKCS#7） * 原始数据将在接口内部进行 sm3 ，然后做 Detach 验签 * @param orgData 待签名的原始数据 * @param publicKey sm3 hash 所用的公钥 * @param sign 签名数据 * @return 验签是否通过 */ public boolean sm3AndDetachedVerify( byte[] orgData, String publicKey, String sign); /** * 通过指定的私钥对指定的原始数据编制带公钥证书的数字签名（遵循PKCS#7） * 待签名的原始数据将在接口内部进行不带公钥的 sm3 ，然后做 Detach 签名 * @param orgData 待签名的原始数据 * @param sCertDN 签名者证书 DN * @return 签名数据 */ String sm3WithoutPKDetachedSign(byte[] orgData, String sCertDN); /** * 对指定的原始数据核验其带公钥证书签名（PKCS#7） * 原始数据将在接口内部进行无公钥的 sm3 ，然后做 Detach 验签 * * @param orgData 待签名的原始数据 * @param sign 签名数据 * @return 验签是否通过 */ boolean sm3WithoutPKDetachedVerify(byte[] orgData, String sign); /** * * 通过指定的私钥对指定的原始数据编制带公钥证书的数字签名（遵循PKCS#7） * 数据模式可选 DATA_HASH 或 DATA_ORIGIN * * @param dataType 数据模式,输入的数据为 HASH 后的数据 DATA_HASH = 0 ，输入的数据为原始数据库 DATA_ORIGIN = 1 * @param orgData 输入的数据 * @param sCertDN 签名者证书 DN * @return 签名数据 */ public String detachedSign( int dataType, byte[] orgData, String sCertDN ); /** * 带公钥证书与签名属性的数字签名（遵循 PKCS#7） * @param dataType 数据类型：0，hash 模式，1为非hash模式 * @param orgData 当为hash模式时，值为hash值，当为非hash模式时，值为数据 * @param keyTag 密钥对应的索引号 * @return 签名的 DER 编码 */ public byte[] detachedSign( int dataType, byte[] orgData, int keyTag ); /** * 带公钥证书的PKCS#7数字签名（序列号） * @param dataType 数据类型：0，hash 模式，1为非hash模式 * @param orgData 当为hash模式时，值为hash值，当为非hash模式时，值为要签名的信息 * @param certificateNo X509证书序号 * @return 符合PKCS7标准的签名结果 */ public String detachedSignbysn( int dataType, byte[] orgData, String certificateNo); /** * 对指定的原始数据核验其带公钥证书签名（PKCS#7） * 数据模式可选 DATA_HASH 或 DATA_ORIGIN * * @param dataType 输入的数据为 HASH 后的数据 DATA_HASH = 0 ，输入的数据为原始数据库 DATA_ORIGIN = 1 * @param orgData 待签名的原始数据 * @param sign 签名数据 * @return 验签是否通过 */ boolean detachedVerify( int dataType, byte[] orgData, String sign); /** * 带公钥证书与签名属性的数字签名验签（遵循 PKCS#7） * @param dataType 数据类型：0，hash 模式，1为非hash模式 * @param orgData 当为hash模式时，值为hash值，当为非hash模式时，值为数据 * @param sign 已签名数据 * @return 是否正确 */ boolean detachedVerify( int dataType, byte[] orgData, byte[] sign); /** * 对指定的原始数据核验其带公钥证书签名（PKCS#7）返回证书信息 * 数据模式可选 DATA_HASH 或 DATA_ORIGIN * * @param dataType 输入的数据为 HASH 后的数据 DATA_HASH = 0 ，输入的数据为原始数据库 DATA_ORIGIN = 1 * @param orgData 待签名的原始数据 * @param sign 签名数据 * @return 证书 */ X509 detachedVerifyAndGetX509(int dataType, byte[] orgData, String sign); /** * 计算SM3散列值 * @param packSn 消息块号,0=仅一块,1=第一块,2=中间块,3=最后块 * @param userId 用户 ID,只对“消息块号”为 0、1 时有效 * @param publicKey 公钥的 DER 编码 * @param msg 二进制的消息块 * @param filterData 过渡消息数据,只对“消息块号”为 2、3 时有效 * @return * filterData: 过渡消息数据,只对“消息块号”为 2、1 时有效 * hash: hash */ RetWrap SM3Hash(int packSn, String userId, byte[] publicKey, byte[] msg, byte[] filterData); }