中国联通营业厅无纸化安全能力服务平台对接说明.docVIP

中国联通无纸化营业受理 安全能力服务平台对接说明 目录 1 安全能力服务平台功能说明 3 2 对接说明 4 2.1 印章管理 4 2.2 接口地址 4 3 流程描述 4 3.1 印章管理 4 3.2 PDF电子签章 5 4 接口描述 5 4.1 PDF文档签名接口 5 4.1.1 接口功能 5 4.1.2 接口参数 6 4.1.3 接口示例 8 4.2 PDF文档签名验证接口 9 4.2.1 接口功能 9 4.2.2 接口参数 10 4.2.3 接口示例 11 附录：错误码定义 12 安全能力服务平台功能说明 中国联通无纸化营业受理安全能力服务平台功能结构如下图所示： 功能列表 详细描述 PDF文档签章 针对PDF格式文档进行电子签章，在PDF文件上显示签章图片和签章信息。 PDF签章取证 验证PDF文档签章的有效性、完整性，获取证据信息。 印模制作 按照要求制作印模，包括印章形状、印章文字（内容及字体）等。 印章审批 审批已经制作好的印模，形成印章。 印章发布 发布经过审批的印章，并为该印章向CA申请印章证书。 印章证书管理 和CA对接，实现印章证书生命周期管理，包括申请、下载、更新、冻结、解冻、吊销等。 业务统计 统计签章使用情况，采用多种方式对签章使用情况进行分析。 日志管理 自行记录日志，保存到数据库中。 密钥托管 安全存储用于签章的数字证书，加密保存在数据库中。 PDF文档解析 实现PDF文档解析功能 证据保全 存储签章操作中的签名信息、签名证书、签名时间等信息，并将这些信息安全保全在数据库中。在出现纠纷时，保全的数据作为可调取的数字签名证据，还原数字签名，验证电子单据内容的有效性和合法性。 对接说明 印章管理 印章管理页面采用用户名、口令登录，测试使用的用户名和口令如下： 用户名：admin 口令接口地址 接口地址如下： 62:7080/wppoa/ 流程描述 印章管理 印章管理流程包含印章申请、印章审批、印章管理三大环节。流程如下： PDF电子签章 接口描述 PDF文档签名接口 接口功能 使用分公司印章证书对PDF文档添加数字签名，并显示印章图片。 支持对PDF文档同时加盖多个印章 接口消息序列号trans_id：省代码+1000000000000000（每次自增1，保证不重复） 接口参数 请求的URL：http://[server-url] /wppoa/servlet/ElecFileSignServlet 请求方式为post。 请求的参数列表 参数名称 中文描述 字段长度 备注 In command 接口命令字，这里为acceptSignReq 32 必选 trans_id 接口消息序列号 32 Long，必选 hall_id 分公司标示 32 String，必选（唯一标示），由安全能力服务平台分配 hall_name 分公司名称 64 String，必选（唯一标示） stamp_type 印章类型： 1—公章； 2—稽核章； 3—作废章； 其它—待定； 4 Int，必选 stamp_width 印章宽度 必选，印章宽度，以像素点为单位。 stamp_height 印章高度 必选，印章高度，以像素点为单位 tag_type 印章定位类型, 结合tag_value确定盖章位置： 0：基于坐标定位， 1：基于文字定位（印章盖在文字中心） 2：基于文字定位（印章盖在文字右侧） 3：基于书签定位 目前仅支持0（基于坐标定位） tag_value 印章定位对象数据，针对不同tag_type，具有不同含义： tag_type=0：指定页面坐标，格式为页码:x坐标:y坐标，xy坐标均以像素点为单位。 tag_type=1或2：指定文字 tag_type=3：书签名 1:30:40 例如：1:30:40表示在第一页左下角为原点的二维坐标（30,40）位置 accept_id 受理单流水号 64 String唯一标识该受理工单的ID，必选 doc_type 受理单文件类型： 1：PDF格式 其它：预留 1 Int，必选 doc_content 受理单文件数据内容 Clob 必选，内容经Base64编码 响应的参数列表 参数名称 中文描述 字段长度 备注 Out command 接口命令字，这里为acceptSignResp 必选 trans_id 接口消息序列号，与请求的trans_id对应 32 Long，必选 ret_code 签名结果。 0：成功； 1：失败； 2~999：参见7.8 0 必选 err_desc 错误描述 ret_code为非0时必选 accept_id 受理工单流水号