EBS网银外联平台用户手册V4.020091106.doc

网银 B2B 外联平台用户手册 网上银行项目四 期 网银外联平台用户手册网银外联平台用户手册 V4.0 网银外联平台用户手册 2 目录目录 1 1 引言引言 3 1.1 概述3 1.2 背景.3 1.3 目的.3 1.4 定义3 2 2 功能介绍功能介绍 5 2.1 交易简述.5 2.2 交易通讯方式.5 3 3 运行系统的支持条件运行系统的支持条件 7 3.1 外联平台的要求.7 3.2 网银与外联平台拓扑图.7 3.3 外联平台的安全要求.8 3.4 外联平台业务处理模式.8 3.5 外联平台网络连接模式.8 3.6 网上银行外联平台 XML 协议 8 3.7 外联平台对运行环境要求.9 4 互联客户端交易流程互联客户端交易流程 10 4.1 简要说明.10 5 网银测试环境网银测试环境 11 5.1 测试环境说明.11 5.2 测试准备工作.11 6 注意事项注意事项 12 7 其他补充说明其他补充说明 13 网银外联平台用户手册 3 1 1引言引言 1.11.1 概述概述 本用户手册描叙了外联系统所具有的功能及基本使用方法，用户据此能够 了解外联系统的用途，以及如何测试使用它。该用户手册可作为对操作人员和 维护人员培训的参考资料。 1.2 背景背景 根据业务发展需要，外联平台新开发了一些用于快速测试开发的程序，方 便分行相关部门对外联平台进行推广。 1.3 目的目的 网上银行外联平台主要是为网上银行 B2B 系统建立标准对外接口标准，实 现企业财务软件与网上银行的互联，对特殊企业客户提供一种不通过网上银行 操作界面而进行网上银行操作的方式。 目前外联平台已在生产环境上部署，为了便于分行进行测试，现就此做相 关测试说明。 该用户手册的预期读者为分行负责推广的业务和技术人员、企业财务软件 接口开发人员。 1.41.4 定义定义 证书：证书是一个经证书认证机构（CA、CCBCA）数字签名的包含用户身份 信息以及公开密钥信息的电子文件。 XML： XML (可扩展标识语言)是通用标识语言标准(SGML)的一个子集，它 是描述网络上的数据内容和结构的标准。 HTTPS: 建立在 SSL 协议之上的超文本传输协议（HTTP） 网银外联平台用户手册 4 TCP/IP：Transfer Control Protocol/Internet Protocol 传输控制/网际 协议 网银外联平台用户手册 5 2 2 功能介绍功能介绍 2.1 交易简述交易简述 外联平台实现了基本帐户查询、转帐、明细查询、代发代扣等二十多支交 易。 2.2 交易通讯方式交易通讯方式 外联平台通过 https 通讯方式与网银系统后台进行通讯。 企业财务软件接口与外联平台采用 TCP/IP 的 Socket 方式进行通讯。 Socket 简介 什么是什么是 socket 所谓 socket 通常也称作“套接字“，用于描述 IP 地址和端口，是一个通信链 的句柄。应用程序通常通过“套接字“向网络发出请求或者应答网络请求。 以 J2SDK-1.4 为例，Socket 和 ServerSocket 类库位于 包中。ServerSocket 用于服务器端，Socket 是建立网络连接时使用的。在连接成功时，应用程序两 端都会产生一个 Socket 实例，操作这个实例，完成所需的会话。对于一个网络 连接来说，套接字是平等的，并没有差别，不因为在服务器端或在客户端而产 生不同级别。不管是 Socket 还是 ServerSocket 它们的工作都是通过 SocketImpl 类及其子类完成的。 Accept 方法用于产生“阻塞“，直到接受到一个连接，并且返回一个客户端 的 Socket 对象实例。“阻塞“是一个术语，它使程序运行暂时“停留“在这个地方， 直到一个会话产生，然后程序继续；通常“阻塞“是由循环产生的。 getInputStream 方法获得网络连接输入，同时返回一个 IutputStream 对象实 例。 getOutputStream 方法连接的另一端将得到输入，同时返回一个 网银外联平台用户手册 6 OutputStream 对象实例。 注意：其中 getInputStream 和 getOutputStream 方法均 会产生一个 IOException，它必须被捕获，因为它们返回的流对象，通常都会被 另一个流对象使用。 开发原理：开发原理： 服务器，使用 ServerSocket 监听指定的端口，端口可以随意指定（由于 1024 以下的端口通常属于保留端口，在一些操作系统中不可以随意使用，所以 建议使用大于 1024 的端口） ，等待客户连接请求，客户连接后，会话产生；在 完成会话后，关闭连接。 客户端，使用 Socket 对网络上某一个服务器的某一个端口发出连接请求， 一旦连接成功，打开会话；会话完成后，关闭 Socket。 外联平台采用 Socket 短连接，企业系统作为客户端向外联服务器发送 XML 报文。在 Socket 通信处理中，通信的内容仅为通信报文的字符串流，不 包含长度。根据报文规范，报文应该以标记结束，当服务器监控到请求 报文并读取到标记时，则认为请求报文结束，外联平台执行请求结束以 后，返回执行结果报文。 网银外联平台用户手册 7 3 3 运行系统的支持条件运行系统的支持条件 3.1 外联平台的要求外联平台的要求 1客户要成为外联平台的客户必须首先成为网银的客户，必须在网银有签 约帐户。 2开通外联平台时需要增加一个操作员“外联平台操作员” ，此操作员的 权限除了没有管理权之外，具有所有其它的权限 3外联平台操作员可以作为一个普通操作员管理（除了删除之外） 4帐户需要开通后才能在外联平台进行操作 3.2 网银与外联平台拓扑图网银与外联平台拓扑图 上上 上上 上上 上上 上 上上上上上 上 上 上上上 上上上上上 上上上上 HTTPS 上 XML Internet 图 1 图 1 中的企业系统是位于企业端的所有系统的总称。由上图可见，建行网 银外联平台对外联客户端的要求非常简单，只有两点：安全性和数据格式标准 性，只要符合这两点都可以和网银外联平台相连。 为了方便客户端的开发，目前建行提供了一个客户端服务，此客户端服务 是一个 socket 服务器，提供一个监听端口（端口可配置） ，接收客户端发来的报 网银外联平台用户手册 8 文（报文格式见下面的说明） ，然后客户端服务对数据进行签名，加密，和外联 平台进行通讯，把报文送给外联系统。目前建行客户端只能运行在 windows 系 列操作系统上。 建行客户端服务部署在企业内部的服务器上，其安全控制由企业内部进行 管理。因此采用通过建行客户端服务进行连接，则企业系统不需要进行加密， 只要将明文的 XML 流传输给建行客户端即可。 3.3 外联平台的安全要求外联平台的安全要求 外联平台对客户端要求采用双端 CA 认证，客户端需要有建行网银的根证 书和客户自己的证书，以对数据进行加密和签名 3.4 外联平台业务处理模式外联平台业务处理模式 外联平台采用请求-应答的服务模式，一次请求只能有一个交易（注：批量 代发代扣也是一个交易） ，不支持批量请求-批量应答模式。 3.5 外联平台网络连接模式外联平台网络连接模式 外联平台同局域网中客户端的通讯采用 socket 通讯，通讯端口可以自行定 义。 3.6 网上银行外联平台网上银行外联平台 XML 协议协议 1对一个企业来说，所有企业内部账号只用一个客户号 2所有交易密码必须填写 3同一客户的请求序列码不能重复，即使一笔转账失败了，这笔交易所用 的序列码也不能再用，否则会报错，例如转账时填写的请求序列码是 20060516000001，最终查询得到结果是交易处理失败，再次转账时不能再使用 此序列码 20060516000001 4所有出现在接口里面的金额都是以元为单位，即一百二十三元五角六分 应该用 123.56 来表示 网银外联平台用户手册 9 5请求 XML 文件中的所有 tag 都必须严格按照协议说明上的填写，大小 写不能有错，即不能写成，不能写成 ，同时银行返回的数据中这些 tag 也会跟 XML 协议上的 tag 严格一致 6请求 XML 文件中的 tag 是否必须填写，这要根据各交易的报文格式说 明中的“是否可以为空”列的说明，如果是“T” ，则可以为空，如果是“F” ， 则必须填写 7请求 XML 文件中的 tag 顺序必须按照文档中的顺序进行，银行返回的 也会按照文档的顺序填写 3.7 外联平台对运行环境要求外联平台对运行环境要求 1外联平台运行于 windows XP 、Windows 2000 Server、Windows Server2003 中文简体 32 位操作系统上。 2如果日交易量大于 10，000 笔，则系统稳定运行时的可用内存应大于 500M。 网银外联平台用户手册 10 4 互联客户端交易流程互联客户端交易流程 4.1 简要说明简要说明 外联互联客户端在 B2B 企业客户的电脑上启动 Socket 服务，在指定端口上 进行监听（端口可配置） ，Socket 服务采用 TCP/IP 连接方式与企业财务软件接 口相互通讯，客户端收到企业财务软件接口发送过来的 XML 请求报文， 调用 API 对数据进行签名、加密，然后再发送到网银后台交易服务器，随后收到网 银交易服务器处理返回的 XML 报文， 互联客户端再将处理后的 XML 报文发 送给企业财务软件接口. 交易步骤如下： 1企业财务软件组织业务数据 2企业财务软件将报文发送到互联客户端加密 3客户端对报文进行加密然后发送到网银外联平台 4网银外联平台将业务请求发往业务系统进行业务处理 5网银外联平台得到后台核心业务系统处理结果 6互联客户端将处理后的 XML 报文结果返回给企业财务软件接口 4.2 交 易处理流程 网银外联平台用户手册 11 5 网银测试环境网银测试环境 5.1 测试环境说明测试环境说明 具体环境及配置，请咨询客户经理。 5.2 测试准备工作测试准备工作 1、首先需要为 B2B 客户开通外联平台服务，分行在 manager 后台管理里 “客户管理-银企互联客户管理”进行设置开通。 2、分行为 B2B 客户新增外联平台专用操作员所需要的 U 盾证书信息，实现 证书和操作员的绑定。 3、B2B 客户主管完成新增外联平台操作员，以及开启外联平台服务。其他 相关管理设置在主管的“管理设置-互联管理”中进行。转帐交易必须设置帐 户金额控制限额。IP 设置请不要随意更改，暂时可不用进行设置。 4、若 USBKEY 或 IC 卡驱动程序。 5、安装 建行外联平台客户端应用。 网银外联平台用户手册 12 6 注意事项注意事项 1、外联系统传给外联平台客户端的数据中如果需要签名，只要传一个空的 对就可以了，因为里面的签名信息是由客户端生成的。 2、外联系统和客户端的连接必须等到客户端返回应答信息之后才能断开， 客户端不会主动跟外联系统连接，也不