格尔签名验证客户端(应用服务器)API_C_ActiveX接口说明

-6521 -6522 -6523 -6524 -6525 -6526 -6527 -6528 -6529 -6530 -6531 -6601 -6602 -6603 -6604 -6605 -6606 -6607 -6608 -6701 -6702, -6801 -6802 -6803 -6804 -6805 -6806 -6807

上海格尔软件股份有限公司

将证书转换成X509格式出错 内存空间不足 字符码转换出错 不能根据OID字符创建ASN对象 指定的扩展项不存在 扩展项的字符长度超过预期长度 创建BIO对象失败 主机名不能被解析 创建套接字失败 连接OCSP服务器失败 OCSP服务的Url地址无效 缓冲区长度为无效值 缓冲区为空 B64解码错误 证书信息无效 时间戳签名数据结构无效 找不到内部签名数据 不能解析出数据原文 缓冲区长度不足 未成功解析PKCS#7数据 无效的配置模块指针 无签名配置信息 不能打开指定的文件 文件大小不符合预期范围 无效的证书文件 无效的私钥文件 PKCS#7签名环境未初始化 21

上海市余姚路288号7楼 Tel: (86-21) 62327010 Fax：62327015 URL: http://www.koal.com

-6808 -6809 -6810 -6811 -6812 -6813 -6814 -6815 -6816 -6817 -6818 -7001 无效的参数 接收签名数据的缓冲区太小 不正确的PKCS#7签名请求格式 签名错误 无足够的内存空间创建操作对象 不是PKCS#7数字信封 证书状态无效（针对LDAP方式验证证书） 组装P7报文失败（针对P7签名验证） 待验签名原文HASH长度不合法 从P7包中获取签名证书失败 从P7包中获取签名数据失败 验证P7签名失败 LDAP未初始化（针对LDAP方式验证证书） 获取证书公钥失败（针对普通证书验证） LDAP服务器登录失败（针对LDAP方式验证） 错误的签名算法（针对普通证书验证） LDAP服务器上找不到指定节点 从LDAP服务器查询操作失败(可能是查询条件不合法) 打开文件失败 文件大小超过大小限制 RSA加密失败 RSA解密失败 加密失败 解密失败 从P7数据中获取证书失败 从P7数据中获取签名结果失败 不支持的功能 22

-7002 -7003，-7004 -7005 -7100 -7101 -7102 -7103 -7104 -7105 -7106 -7107 -9000

上海格尔软件股份有限公司

上海市余姚路288号7楼 Tel: (86-21) 62327010 Fax：62327015 URL: http://www.koal.com

3 消息格式定义 3.1 消息格式总体描述

本章定义客户端与服务器端通信的所有消息格式以及接口说明。

与服务器端的通信协议采用TCP端口，默认情况下，服务器TCP端口是5000 消息包括消息头和消息体两个部分，消息头的定义如下： 字段名称 msg_type 字段意义 消息的类型 字段值 0-消息请求 1-正确结果返回 2-错误结果返回 msg_id 消息ID 1000-验证证书 1001-验证签名数据 1002-验证签名及签名证书 1003-验证时间戳 1004-获取证书信息 1005-Attach方式PKCS7格式签名 1006-Attach方式PKCS7格式签名验证 1007-普通格式签名 1008-PKCS7格式签名验证并返回原文数据 1009-验证签名（实时从LDAP下载证书并验证） 1020-对原文数据的HASH值进行验证 1030-服务器私钥加密运算 1031-服务器私钥解密运算（用于数字信封） 1040-Detach方式PKCS7签名 1041- Detach方式PKCS7验证签名 msg_sn

上海格尔软件股份有限公司

上海市余姚路288号7楼 Tel: (86-21) 62327010 Fax：62327015 URL: http://www.koal.com

消息序列号 暂时无效，用于扩展 23

Version 消息版本号 1 注：以下接口例子中的消息体的值仅供参考 3.2 验证数据签名 3.2.1 客户端消息请求格式

0 1001 0 1

签名类型

原文数据长度 B64编码的原文数据 签名证书证书（B64编码） 签名后的结果（B64编码） 0

3.2.2 服务器端验证签名成功的返回消息格式

上海格尔软件股份有限公司

上海市余姚路288号7楼 Tel: (86-21) 62327010 Fax：62327015 URL: http://www.koal.com

24