关键词：银企直联、中国银行、公网、投产正式环境、微前置一键部署包

参考文档：中国银行银企对接-微前置-郑照、银企对接微前置机v1.2安装手册（BOCMB2EC.zip一键安装包版）.doc

更新日志：

20230114V1.0.0：初稿，投产正式环境使用说明（针对公网对接银行银企直连，本文采取微前置一键部署包，操作更加便捷高效，默认自带tomcat7.0和jdk1.6，与金蝶银企平台一致；如由需要tomcat8和jdk1.8可自行配置安装）

20230115V1.0.1：新增关于USBKEY厂商不同（针对飞天/握奇），在填写相关配置时需注意。

20230127V1.0.2：补充业务背景说明，补充关于集团型客户在获取电子银行客户号时需注意事项。

后续版本规划：后续再补充完善电子回单配置说明和银企云相关配置说明

0.业务背景说明

在实际上线中国银行银企直连对接时，会发现在配置前置机和相关投产准备，总有很多细节点需要注意，光光逐一核对配置文件就很花时间。

而中国银行前置机部署的方式有两种，本文采取中国银行提供的微前置一体安装包，减少配置工作量，没准备tomcat和jdk安装包等材料，更省时省力，同时在配置时也能有的放矢。

1.准备资料

1.1银企专用USBKEY及对应USBKEY密码

到柜台办理银企直联后，银行会提供一个银企直连专用的USB KEY，如下图所示（下图为飞天诚信）。中国银行还支持握奇版本的USB KEY。

1.前置机插入USB-KEY，将自动安装驱动

2.如果未自动安装，在“我的电脑”中，有一个虚拟光驱，

       内有USB-KEY驱动，手动点击安装

3.驱动安装结束后，弹出界面要求输入初始密码，推荐8位长度（实测，中国银行使用飞天诚信的USBKEY，USBKEY密码设置必须为8位，不能带特殊字符，建议小写字母+数字方式。）

       提醒客户财务人员记录并保管该密码，若干年后，USB-KEY证书到期时，

       更新证书时需要该密码。

1.2电子银行企业服务签约单相关重要信息

关键信息如下圈示：

1.3操作员登录密码（柜台办理后会有一条短信）

记得修改登录密码

1.4确保前置机所在网络能正常访问银行服务

准备工作：网络通讯联通性测试

公网模式：命令行方式运行telnet  b2enew.bankofchina.com 443

安装工具（配置助手）里的测试（PING）是无效的，因为总行服务器禁PING

2.前置机程序部署

本文采取微前置一键部署包方式部署（更加高效快捷），可以理解微前置一键部署包属于中行配置文件生成器+服务自动安装的程序。

2.1设置USBKEY密码

1.前置机插入USB-KEY，将自动安装驱动

2.如果未自动安装，在“我的电脑”中，有一个虚拟光驱，

       内有USB-KEY驱动，手动点击安装

3.驱动安装结束后，弹出界面要求输入初始密码，推荐8位长度。

       提醒客户财务人员记录并保管该密码，若干年后，USB-KEY证书到期时，

       更新证书时需要该密码。

2.2查看证书是否正常、是否在有效期内（检查到期时间）

桌面右下角出现中行图标，双击查看证书状态，有两个证书即为正常。

点击一张证书，再点查看证书，检查证书有效期是否正确，若已过期需要到柜台处理

系统检测，查看服务是否正常启动。注意看下方的密码重试次数。

2.3提取微前置一键部署包BOCMEB2EC.zip

从总行下发版本包（例如：BOCEIP-D-B2EC_V01.0J08_SP.zip）中提取出BOCMB2EC.zip，参见下图

将BOCMB2EC.zip解压缩至任意盘符根目录上（例如：D盘）参见下图

2.4修改配置文件中的专用信任证书为正式环境专用

删除\BOCMB2EC\tomcat7.0\webapps\B2EC\WEB-INF\classes\trustedcerts.jks

将\BOCMB2EC\tomcat7.0\webapps\B2EC\WEB-INF\classes\trustedcerts.jks.product重命名为trustedcerts.jks，确保trustedcerts.jks为5KB大小

2.5禁用tomcat下的APJ

用记事本打开\BOCMB2EC\tomcat7.0\conf\server.xml,  关闭APJ 。

操作方法：搜索8009，定位后为其下一行加上注释标记（如下红色所示）

0J19及以上版本无需执行本步骤

<!-- Define an AJP 1.3 Connector on port 8009 -->

    <!--<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" /> -->

2.6TOMCAT默认端口修改

避免被其他程序占用TOMCAT端口

用记事本打开\BOCMB2EC\tomcat7.0\conf\server.xml

（1）修改tomcat监听的shutdown关闭端口，这个端口时负责监听关闭tomcat的请求（如：8005→18005）

（2）修改tomcat下的http端口（如8080→9191，用于金蝶银企访问），https端口（如8443→18443）

2.7鼠标右键“中国银行微前置安装工具.exe”，以管理员身份运行

2.8【基本属性管理】中，点击按钮【生产环境】

注意：私钥证书库，如果是使用飞天诚信的USB KEY，填写feitian.cfg；如果是使用握奇的USB KEY，填写watch.cfg

2.9修改前置机运行日志保存地址

\BOCMB2EC_J20\tomcat7.0\webapps\B2EC\WEB-INF\classes下的log4j.xml文件。

将默认的前置机运行日志存放路径修改为指定位置，如D:/BOCMB2EC_J20/Log_M_B2EC/b2ec.log

2.10启动微前置服务

建议点启动，然后点退出最小化前置机服务。

启动后会自动在服务中新增tomcat7的服务，且自动创建日志存放文件夹。

2.11其他注意事项

一键版配置助手使用的注意事项

1. 因为配置助手的设计目的是初始安装一次性使用的，所以每次开启配置助手，看到的界面都是默认的参数，不是已调试配置好的参数

2. 生产系统已调试安装好后，最好删除或者隐藏配置助手，以防二次打开配置助手，误点击“保存”按钮后相关参数丢失，引发UKEY被锁继而前置机无法正常工作的严重后果

3. 没有配置助手的情况下，若需要手工启动或停止中国银行服务，建议使用”控制面板“->”管理工具“->”服务”->“中国银行银企对接前置机”->鼠标右键，也可以用管理员方式运行命令行，执行如下命令net start tomcat7或net stop tomcat7

2.12配置电子回单下载

修改\BOCMB2EC\tomcat7.0\webapps\B2EC\WEB-INF\classes\configure.properties

ftp.trans.mode=00 | 20

根据交易码，修改相关交易类型的参数，以7801为例

7801.custid=299820158  #此处填入核心客户号，即SFTP用户名

2.13重置SFTP服务密码

生产默认密码BOChq99901!，投产时需要用WinSCP工具用SFTP协议登陆一次，会提示要求修改密码。

密码要求英文+特殊字符+数字

2.14修改\BOCMB2EC\tomcat7.0\webapps\B2EC\WEB-INF\classes\batchconfig\config.sftp

#host=219.141.191.163 #生产公网-电信

#host=123.124.191.163 #生产公网-联通

#port=21000   #生产

username=299820158  #此处填入核心客户号

password=修改后密码    #生产默认密码BOChq99901!，投产时需要用WinSCP工具用SFTP协议登陆一次，会提示要求修改密码

downloaddirectory=/

localdownloaddir=D:/huidan/  #如前置机D盘上需创建文件夹huidan，再创建子目录7801

download.isbranch=false

backflag=true

remoutbackupdirectory=/Inbox/

3.银企平台配置

同步银行账号，在银企平台中查询余额校验，可以用即可。