云加密机 接口调用

这里说明 Java 接口调用，实现集成 SDK 至业务系统中。

注意：更多接口详情请 联系我们 获取 EVSM 应用开发手册和 EVSM 接口开发文档。

一、SDK 初始化

hsmGeneralFinancehsm=hsmGeneralFinance.getInstance("./cacipher.ini");

二、调用接口

1. 生成工作密钥。

hsm.genWorkKey(keyType,algFlag,keyIndex,keyLable);

2. 数据加密。

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

3. 数据解密。

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

四、方式1：通过文件形式配置

接口初始化支持直接将配置文件路径传入初始化接口内，指明绝对路径即可。

五、格式说明

1. 注释行以符号“#”起始，不支持行内注释。

2. 配置域以方括号“[”和“]”标识。

3. 配置项格式为“键名（Key）=键值（Value）”。

4. 配置域与键名不区分大小写，但为了直观建议配置域名使用大写。

5. 支持使用空白字符（空格或制表符）等对内容进行对齐操作。

6. 可在接口内拼装字符串传递配置，使用“{”和“}”包括所有内容，可使用“;”表示换行。

六、属性字段说明

接口基本配置属性域包括日志属性和 EVSM 属性，常用设置属性如下：

·日志属性（“[LOGGER]”）：设置有关接口记录日志的属性。

·EVSM 属性（“[HOSTn]”）：每个 EVSM 的属性，其中“n”为该 EVSM 在当前配置中从1开始的序号，接口会按顺序读取多个 EVSM 属性，直到序号无法连续。

七、示例

[LOGGER]logsw=errorlogPath=./[HOST1]hsmModel=SJJ1310linkNum=-5host=192.168.19.19port=8018timeout=5ifHeart=yes

八、方式2：通过内容形式配置

可以直接将配置信息以字符串的形式传入初始化接口内。属性字段 同上述内容一致。

Stringconfig="{"+"[LOGGER];"+"logsw=error;logPath=./;"+"[HOST1];"+"hsmModel=SJJ1310;"+"host=192.168.19.19;"+"port=8018;"+"connTimeout=5;"+"}";

十一、返回

·0号索引下：密钥在 LMK 下加密的密文。

·1号索引下：密钥校验值。

十二、抛出

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

十三、接口定义

public String[] genWorkKey(String keyType, char keyFlag, int storeKeyIndex, String storeKeyLabel) throws cn.tass.exceptions.TAException

十四、请求参数

十五、传参示例

keyType：00AalgFlag：RkeyIndex：1KeyLabel：test

十七、返回

加密之后的密文数据。

十八、抛出

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

十九、接口定义

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

20、请求参数

21、传参示例

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

23、返回

解密后的数据。

24、抛出

cn.tass.exceptions.TAException – 程序运行异常

25、接口定义

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

26、请求参数

27、传参示例

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