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

格尔签名验证服务器 客户端API_C/ActiveX

接口说明

V1.7

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

2006年8月

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

1

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

保密事宜： 本文档包含上海格尔软件股份有限公司的专有商业信息和保密信息。 接受方同意维护本文档所提供信息的保密性，承诺不对其进行复制，或向评估小组以外、非直接相关的人员公开此信息。对于以下三种信息，接受方不向格尔公司承担保密责任： 1 ) 接受方在接收该文档前，已经掌握的信息。 2 ) 可以通过与接受方无关的其它渠道公开获得的信息。 3 ) 可以从第三方，以无附加保密要求方式获得的信息。

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

2

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

目 录

1 接口说明 ............................................................................................. 6

1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 1.10 1.11 1.12 1.13 1.14 1.15 1.16 1.17

客户端初始化 ........................................................................... 6 客户端清理 .............................................................................. 6 验证数据签名 ........................................................................... 6 验证签名数据和签名证书 .......................................................... 7 验证Attach方式的PKCS7数据签名 ........................................... 8 验证Attach方式的PKCS7数据签名并获取原文 .......................... 9 证书验证 .................................................................................. 9 获取证书信息 ......................................................................... 10 Attach方式PKCS7数据签名 .................................................... 11 数据签名（普通签名数据） ..................................................... 11 对文件签名 ............................................................................ 12 对文件签名数据验证签名 ........................................................ 13 对文件解密数字信封 ............................................................... 14 Detach方式的PKCS#7签名 .................................................... 14 验证Detach方式的PKCS#7数据签名 ..................................... 14 验证签名（实时从LDAP下载证书并验证） .............................. 15 验证原文HASH签名 ............................................................... 16

2 错误码说明 ........................................................................................ 17 3 消息格式定义 ..................................................................................... 23

3.1 3.2

消息格式总体描述 .................................................................. 23 验证数据签名 ......................................................................... 24 3.2.1 客户端消息请求格式 ......................................................... 24 3.2.2 服务器端验证签名成功的返回消息格式............................... 24 3.2.3 服务器端验证签名失败的返回消息格式............................... 25 3.3

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

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

验证签名数据和签名证书 ........................................................ 25

3

3.3.1 客户端消息请求格式 ......................................................... 25 3.3.2 服务器端验证签名成功的返回消息格式............................... 26 3.3.3 服务器端验证签名失败的返回消息格式............................... 27 3.4

验证PKCS#7签名数据 ........................................................... 27 3.4.1 客户端消息请求格式 ......................................................... 27 3.4.2 服务器端验证签名成功的返回消息格式............................... 28 3.4.3 服务器端验证签名失败的返回消息格式............................... 28 3.5

证书验证 ................................................................................ 29 3.5.1 客户端消息请求的格式 ...................................................... 29 3.5.2 服务器端验证成功的返回消息格式 ..................................... 29 3.5.3 服务器端验证失败的返回消息格式 ..................................... 30 3.6

获取证书信息 ......................................................................... 30 3.6.1 客户端消息请求格式 ......................................................... 30 3.6.2 服务器端解析证书成功的返回消息格式............................... 31 3.6.3 服务器端解析证书失败的返回消息格式............................... 31 3.7

数据签名（PKCS#7签名数据） ............................................... 32 3.7.1 客户端消息请求格式 ......................................................... 32 3.7.2 服务器端签名成功的返回消息格式 ..................................... 32 3.7.3 服务器端签名失败的返回消息格式 ..................................... 33 3.8

数据签名（普通签名数据） ..................................................... 34 3.8.1 客户端消息请求格式 ......................................................... 34 3.8.2 服务器端签名成功的返回消息格式 ..................................... 34 3.8.3 服务器端签名失败的返回消息格式 ..................................... 35 3.9

对文件签名 ............................................................................ 35 3.9.1 客户端消息请求格式 ......................................................... 35 3.9.2 服务器端签名成功的返回消息格式 ..................................... 36 3.9.3 服务器端签名失败的返回消息格式 ..................................... 36

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

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

4