交易安全认证系统开发接口V.docx

1、交易安全认证系统开发接口V交易安全认证系统接口编写：评审：批准：项目名称：日期：2012年3月2日文档修订记录版本号修改日期编写评审修改内容1.02012-03-02创建文档1 文档说明本文档预期读者为交易业务系统的系统设计、开发、测试人员。2 应用场景本系统作为交易业务系统的安全支撑系统，主要提供以下功能：2.1 管理服务功能 随机生成密钥 打印密钥2.2 联机服务功能 工作密钥TAK、TPK更新 文件加密、解密 数据加密、解密 MAC计算、校验 PIN转加密 证书处理3 联机服务接口3.1 密钥管理接口3.1.1 工作密钥更新3.1.1.1 接口定义int HisuApplyKeyByZM

2、K( char *designID, char *nodeID, char *keyModelID, char *nodeID01, char *keyModelID01, char *keyValue, int sizeOfKeyValue, char *checkValue, int sizeOfCheckValue);3.1.1.2 接口说明3.1.1.2.1 输入参数域标识值域值备注designID安全系统提供（可配置）保护密钥方案标识nodeID安全系统提供（可配置）保护密钥节点标识keyModelID安全系统提供（可配置）保护密钥模板标识nodeID01安全系统提供（可配置）工作密

3、钥节点标识（keyModelID01安全系统提供（可配置）工作密钥模板标识sizeOfKeyValue业务系统提供密钥接收缓冲区大小sizeOfCheckValue业务系统提供密钥校验值接收缓冲区大小3.1.1.2.2 输出参数域标识值域值备注keyValue安全系统返回ZMK加密的工作密钥密文，十六进制表示checkValue安全系统返回工作密钥校验值，十六进制表示3.1.1.2.3 返回值 =0 正确 =0 正确 =0 正确 =0 正确 =0 正确 =0 正确 =0 正确 =0 正确 =0 正确 =0 正确 =0 正确 =0 正确 0 错误3.2.4.3 接口示例3.3 文件处理接口3.3.1 文件加密3.3.1.1 接口定义int HisuEncryptFileInBinaryBySpecKey( char *designID, char *nodeID, char *zekKeyModelID, char *zakKeyModelID, char *plainTextFileName, char *cipherTextFileName);3.3.1.2 接口说明3.3.