使用 EVSM 实现应用层敏感数据加解密

接口说明

hsm.generalDataEnc(algType,keyType,sm4SymmKey,disperFactor,sessionType,sessionFactor,padFlag,inData,IV);

public byte[] generalDataEnc(int algType,
                             String keyType,
                             Object key,
                             String disperFactor,
                             int sessionType,
                             String sessionFactor,
                             int padFlag,
                             byte[] inData,
                             String IV)
                      throws cn.tass.exceptions.TAException

algType：1
keyType："00A"
key：symmKey[0] // 加密的对称密钥密文，使用 EVSM 内部的索引密钥，使用内部密钥时为 int 类型。
disperFactor：null
sessionType：0
sessionFactor：null
padFlag：1
inData：根据应用业务自行输入数据内容。
IV："00000000000000000000000000000000"

cn.tass.exceptions.TAException // 接口自定义异常。 

hsm.generalDataDec(algType,keyType,sm4SymmKey,disperFactor,sessionType,sessionFactor,padFlag,symmEnc,IV);

public byte[] generalDataDec(int algType,
                            String keyType,
                             Object key,
                            String disperFactor,
                            int sessionType,
                            String sessionFactor,
                             int padFlag,
                            byte[] inData,
                             String IV)
                      throws cn.tass.exceptions.TAException

algType：1
keyType："00A"
key：symmKey[0] // 加密的对称密钥密文，使用 EVSM 内部的索引密钥，使用内部密钥时为 int 类型。
disperFactor：null
sessionType：0
sessionFactor：null
padFlag：1
inData：自行输入加密后的数据。
IV："00000000000000000000000000000000"

cn.tass.exceptions.TAException // 接口自定义异常。

代码示例

public class SensitiveDataEnc {

    public static void main(String[] args) throws TAException {
        // 接口初始化，采用配置文件的方式。
        hsmGeneralFinance hsm = hsmGeneralFinance.getInstance("./cacipher.ini");
        // 接口初始化 2，采用配置内容的方式。
//        String config =
//                "{"
//                        + "[LOGGER];"
//                        + "logsw=error;logPath=./;"
//                        + "[HOST1];"
//                        + "hsmModel=SJJ1310;"
//                        + "host=192.168.19.19;"
//                        + "port=8018;"
//                        + "connTimeout=5;"
//                        + "}";
//
//        hsmGeneralFinance hsm = hsmGeneralFinance.getInstance(config);

        // 测试 1 产生随机密钥 keyIndex 为可变参数。
        // 当该密钥索引值取值为 0 时，表示不需要加密机保存生成的该条随机对称密钥。
        // 当 keyIndex 取值为 1~2048 时，表示将对称密钥存储在加密机中，且相同索引会执行覆盖操作。
        int keyIndex = 0;

        switch (keyIndex) {
            case 0:
                // 产生随机 SM4 算法对称密钥。
                String keyType = "00A";
                char algFlag = 'R';
                String keyLable = "sm4Key";
                // 调用产生随机密钥接口。
                String[] symmKey = hsm.genWorkKey(keyType, algFlag, keyIndex, keyLable);
                System.out.println("对称密钥lmk下的密文值：" + symmKey[0]);
                System.out.println("对称密钥校验值：" + symmKey[1]);

                // 测试 2。
                String str = "要加密的数据";
                // CBC 模式。
                int algType = 1;
                // 密钥类型固定。
                keyType = "00A";
                // 执行加密的对称密钥密文。
                String sm4SymmKey = symmKey[0];
                // 也可以使用加密机内部的索引密钥，使用内部密钥时为 int 类型。
                String disperFactor = null;
                int sessionType = 0;
                String sessionFactor = null;
                // 遵循强制 80 填充。
                int padFlag = 1;
                byte[] inData = str.getBytes();
                String IV = "00000000000000000000000000000000";
                // 调用数据加密接口。
                byte[] symmEnc = hsm.generalDataEnc(algType, keyType, sm4SymmKey, disperFactor, sessionType, sessionFactor,
                        padFlag, inData, IV);
                System.out.println("16进制字符串输出对称加密结果：" + Forms.byteToHexString(symmEnc)
                        + ",如果进行解密，可使用接口功能函数'Forms.hexStringToByte()'将16进制字符串转换为byte[]参与解密。");
                // 调用数据解密接口。
                byte[] symmDec = hsm.generalDataDec(algType, keyType, sm4SymmKey, disperFactor, sessionType, sessionFactor,
                        padFlag, symmEnc, IV);
                System.out.println("解密结果与加密数据比较结果：" + Arrays.equals(symmDec, inData));
                System.out.println("还原解密结果，通过字符集还原原文：" + new String(symmDec));
                break;
            // 此时生成对称密钥到 1 号索引位置，若已经存在，会执行覆盖操作。
            case 1:
                str = "要加密的数据";
                // CBC 模式。
                algType = 1;
                // 密钥类型固定。
                keyType = "00A";
                // 执行加密的对称密钥密文，使用加密机内部的索引密钥，使用内部密钥时为 int 类型。
                int sm4SymmKeyIndex = 1;
                disperFactor = null;
                sessionType = 0;
                sessionFactor = null;
                // 遵循强制 80 填充。
                padFlag = 1;
                inData = str.getBytes();
                IV = "00000000000000000000000000000000";
                // 调用数据加密接口。
                symmEnc = hsm.generalDataEnc(algType, keyType, sm4SymmKeyIndex, disperFactor, sessionType, sessionFactor,
                        padFlag, inData, IV);
                System.out.println("16进制字符串输出对称加密结果：" + Forms.byteToHexString(symmEnc)
                        + ",如果进行解密，可使用接口功能函数'Forms.hexStringToByte()'将16进制字符串转换为byte[]参与解密。");
                // 调用数据解密接口。
                symmDec = hsm.generalDataDec(algType, keyType, sm4SymmKeyIndex, disperFactor, sessionType, sessionFactor,
                        padFlag, symmEnc, IV);
                System.out.println("解密结果与加密数据比较结果：" + Arrays.equals(symmDec, inData));
                System.out.println("还原解密结果，通过字符集还原原文：" + new String(symmDec));
                break;
            default:
                break;
        }

    }

}