本文介绍了中国银行银企直连对接的微前置一键部署包使用说明,包括准备资料、前置机程序部署等步骤。通过该部署包,可以简化配置工作,提高投产效率。文档详细说明了USBKEY的安装、配置文件的修改、TOMCAT端口的调整以及服务启动等步骤,并提供了关于电子回单配置和SFTP服务密码重置的额外信息。同时,也强调了使用配置助手时的注意事项及后续版本规划。
关键词:银企直联、中国银行、公网、投产正式环境、微前置一键部署包
参考文档:中国银行银企对接-微前置-郑照、银企对接微前置机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 | 电子银行客户号 | 用于银企直连查询、支付等使用,对应银行接口文档中字段:网银客户号custid,一般为9位。 注意:如果是集团型客户办理中国银行的银企直连,需要注意此处的电子银行客户号需要单独向银行客户经理询问,因为如果是集团走银企,有可能是通过集团办的网银走的,而非集团公司所使用的自己公司用的企业网银。 |
2 | 核心客户号 | 用于下载电子回单使用,即使用银行的SFTP时登录用的用户名。一般为9位。另外请向银行获取SFTP密码。 |
3 | 电子银行操作员标识 | 用于银企直连查询、支付等使用,对应银行接口文档中字段:操作员号cusopr,一般为9位。 |
4 | 银企对接IP | 用于银企直连查询、支付等使用,对应银行接口文档中字段:中行报文头终端号termid。此处显示IP如:59.58.9.158,转换成报文头终端号为E059058009158 |
5 | USBKEY号 | 对应上述USBKEY中行logo背面的证书编号。 |
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其他注意事项
一键版配置助手使用的注意事项
因为配置助手的设计目的是初始安装一次性使用的,所以每次开启配置助手,看到的界面都是默认的参数,不是已调试配置好的参数
生产系统已调试安装好后,最好删除或者隐藏配置助手,以防二次打开配置助手,误点击“保存”按钮后相关参数丢失,引发UKEY被锁继而前置机无法正常工作的严重后果
没有配置助手的情况下,若需要手工启动或停止中国银行服务,建议使用”控制面板“->”管理工具“->”服务”->“中国银行银企对接前置机”->鼠标右键,也可以用管理员方式运行命令行,执行如下命令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.银企平台配置
同步银行账号,在银企平台中查询余额校验,可以用即可。
推荐阅读