汇丰银行（中国大陆）直联版部署文档（HSBC_DC）

1. 整体介绍

汇丰银行直联版，该版本不存在银行前置机的安装，需要通过金蝶提供的前置代理程序安装部署，取代银行前置机软件的作用，通过代理程序完成余额查询、下载交易明细、付款等全部交易。

汇丰银行传输文件，需要通过SFTP服务器进行传输，需要和汇丰银行交互密钥，需要提前下载生成密钥的工具（winscp），并提供给汇丰银行，才可实现服务器访问。

1.1. 下载途径

金蝶前置机代理程序下载地址（本银行版本部署文档参考本文档即可）：https://vip.kingdee.com/article/95932679937684992

1.2. SFTP

介绍：SFTP是Secure File TransferProtocol（安全文件传送协议）的缩写，可以为文件传输提供一种安全的加密方法。SFTP服务程序可帮助用户通过网络传输文件。

作用：通俗来讲，SFTP服务，就是可以让服务器A访问到服务器B某个文件夹内的文件。（例如：在服务器A上搭建一个SFTP服务，指定A服务器上的一个文件夹作为根目录。服务器B登陆这个SFTP后，就可以通过此SFTP来访问服务器A中指定根目录下的所有内容。服务器A可以理解为银行推送回单文件的服务器，服务器B可以理解为回单程序服务器。）

2. 代理程序安装、配置

本文档是基于windows系统进行说明，非window系统则通过对应系统脚本启动。建议服务器先下载文本工具（如notepad++、editplus等）和解压缩软件。

2.1. 下载安装

(1) 下载压缩包，解开压缩包，解压后的目录结构参考如下：

需要关注的几个文件夹：logs，存放代理程序日志，分析问题时必须要的东西。

lib，存放代理程序所有jar包，部署时一般替换里面的文件。config，存放数据库和登录用户的配置，以及各个银行的配置配置说明，存放本文档。

(2) 启动/停止代理程序服务

系统默认使用9999端口，请确保端口不被占用后启动服务。

Windows启动： start.bat          

Windows后台启动：  start_in_background.bat

Window关闭：stop.bat

Linux 启动：start.sh  

Linux关闭：stop.sh

Window系统脚本启停，通过双击脚本即可，若当前用户不是管理员，则系统右键点击脚本，以管理员身份运行。

Linux系统脚本启停,通过Linux窗口用脚本命令启停，参考如：sh start.sh

注：代理程序只支持64位的系统。

2.2. 配置代理程序参数

首先，启动代理程序服务后，在浏览器输入IP:9999，如ip地址为192.168.123.123，就输入http://192.168.123.123:9999 即可访问代理程序服务

建议使用谷歌浏览器，暂时不支持IE

然后输入用户名密码登录系统，初始账号默认kingdee，默认密码是daili_123

要先修改初始密码，并记得保存后登录密码。

2.2.1. 启动汇丰银行直联版代理程序服务

登录后找到对应的银行版本“汇丰银行直联版”

(1) 配置参数：修改银行参数配置，按下图序号对应修改即可，其他参考无特殊要求不修改

序号1：服务端口：全部业务使用端口，需要保证端口开放，这个端口是要配置到银企平台前置机内的；

序号2：汇丰银行FTP服务用户名：必填，需要由银行提供；

序号3：汇丰银行FTP服务IP：必填，需要由银行提供；

序号4：汇丰银行FTP服务端口：必填，需要由银行提供；

序号5：汇丰银行FTP上传目录：必填，需要由银行提供

序号6：汇丰银行FTP下载目录：必填，需要由银行提供

序号7：FTP证书目录：存放秘钥交换证书的文件目录，包含文件名，证书由winscp生成，具体操作步骤请见常见问题6.1SSH证书生成；该目录需要是完整目录，包括文件名，例如：C:/test/hsbc/ssh。（请注意这里一定要写到生成的ssh的文件名，不能只写文件夹，否则可能访问不到ssh文件）

序号8：允访问IP地址白名单：除了本机IP以外，任何需要访问代理程序的服务IP都需要配置，包含银企云服务器IP、银行前置机服务器IP，如果是公有云一般是通过网络代理程序访问，则对应配置网络代理程序的IP

注意：如果服务上有杀毒软件，请务必保证杀毒软件已经设置了访问IP的白名单。确保银企云与金蝶代理程序和银行前置机之间，银行前置机与银行端的网络通畅，自行检测方式为：服务器上telnet代理程序服务端口号,比如代理程序IP端口提供的是172.20.10.10 ，端口2302 ,那么我们需要确保我们服务器能正常访问，

telnet 172.20.10.10 2302 正常联通，以此类推

(2) 启动代理程序

配置完成后，在代理程序服务处，点击右侧启动按钮，点击后提示启动成功，并且状态变成运行中，则代理程序成功启动，可使用。

3. 安装部署银企云

银企云基于苍穹平台开发，通过在MC系统部署银企云补丁进行环境更新。

3.1. 安装银企云环境

 参考苍穹银企云补丁安装与部署手册进行补丁安装部署

3.2. 配置【查询与支付】参数

3.2.1. 配置银企连接通道配置

(1) 登录金蝶云星瀚，进入银企云的应用【查询与支付】

(2) 进入【银行启用管理】，启用“汇丰银行直联版”

(3) 进行【银企连接通道配置】，新增或修改“汇丰银行直联版”，参数配置说明如下：

基础连接配置：

序号1：客户ID，必填，由汇丰银行提供

序号2：网络ID，必填，由汇丰银行提供

序号3：前置机代理程序（金蝶提供）所在机器的IP:即代理程序安装的服务器的IP；即操作步骤2代理程序登录与密码修改模块内的浏览器登录时使用的IP

序号4:金蝶代理服务器端口号：对应金蝶前置代理程序上启动的汇丰银行直联版的服务端口，务必两边保持端口一致性。

基础配置内的其他参数，如果没有特殊要求，可以不做调整，使用默认值即可。

3.2.2. 配置银企账户

一般情况下，银企账户需要在资金云【账户管理】中维护并同步到银企云，具体步骤需要参考资金的指导文档，本文档只针对在银企云中的参数说明。

1） 进入【基础管理】-【银企账户管理】，新增或者修改银企账户

2） 账户参数说明如下：

1　 付款合同编号：使用xml格式的ach付款需要进行配置，选填

2　 付款银行BIC