1. 背景

配置之前，先要和银行申请环境和资料，以下配置只涉及系统配置，对于公有云和私有云的环境配置，请单独咨询。

相关资料请参考：

（1） 银行给客户提供测试账号、银行前置机、前置机相关证书、部署文档等

（2） 客户可能向银行前置机服务器的IP地址，供银行设置白名单

请仔细阅读文档。清晰步骤了再进行配置。。

2. 实施流程

银企实施部署流程

3.搭建九江银行前置机程序

3.1.1 银行前置机配置

①银行提供了前置机程序的压缩包（免ukey版一般是测试环境的）

②解压压缩包，里面一般会有前置机的部署文档，部署步骤可以参考本帖，也可以参考银行的文档，可能银行文档会有更新

③前置机程序安装：

1、将安装包（etmp.zip）拷贝置服务器C盘下（建议咨询下银行是否可以装其他目录）；

2、在C盘下解压etmp.zip（例如C:\Kingdee\etmp）；

3、安装JDK：

 1）进入C:\Kingdee\etmp\JDK目录，双击jdk-8u311-windows-x64.exe，根据提示默认下一步安装完成即可；

2）开始 -》运行 -》cmd，在命令行窗口输入：java -version，如下图则安装成功。

4、启动前置机：

1）进入C:\Kingdee\etmp\direct目录，双击运行start.bat文件，启动前置机程序；

问题1：为什么会提示找不到指定路径

解答：因为银行提供的包，start.bat路径默认是C:\etmp

而不同用户部署时，可能换了目录，例如上面就把C:\etmp换成了C:\Kingdee\etmp,因此需要去修改路径，3个地方都要改，保存后重新启动start.bat。

2）开始-》运行-》cmd ，在命令行输入以下命令，查看nginx服务是否运行正常，(启动界面似乎没有信息显示）如下图说明nginx服务启动正常；

netstat -ano | findstr "8911"

3） 进入C:\Kingdee\etmp\nginx-1.22.0\bin目录，双击执行nginx_deploy.bat文件；

同样，如果路径变更也需要修改

4） 开始-》运行-》cmd ，在命令行输入以下命令，查看nginx服务是否运行正常，如下图说明nginx服务启动正常

netstat -ano | findstr "80"

5） 修改服务器host文件：

进入C:\Windows\System32\drivers\etc目录，用管理员权限打开hosts文件，在文件中最后一行添加如下内容后保存。

127.0.0.1 etmp.jjccb.com

5、前置机程序启动完成后，进行系统登录的相关操作

5.1、安装扩展插件

1、进入对应的扩展插件的目录，双击运行CryptoKit.JJCCB.exe文件。

1、打开火狐浏览器(目前暂时仅支持火狐，或许后续银行会支持其他浏览器，以银行的说明为准)，将CryptoKitExtension.JJCCB.xpi文件拖入浏览器中并点击“添加”按钮。

2、勾选后点击Okay按钮，完成插件的安装操作

5.2、安装U-key证书（测试环境一般是免key的，可以跳过本步骤）

1、在电脑上插入提供的U-key；

2、在电脑磁盘空间找到插入的U-key，双击运行，进行U-key安装；

3、等待安装，安装完成后点击“关闭”，证书安装成功；

4、在C:\Windows\System32目录下，存在如下图文件，则安装成功。

5.3、完成以上部署，登录系统

1、在火狐浏览器输入登录地址：http://etmp.jjccb.com/#/login?isYQZL=1 ，打开登录页面

2、选择证书，输入账号和密码后点击登录。

5.4、登录后，进行参数配置

1、在银企通讯平台，进入“参数配置”页面

2、修改配置信息如下（需要按银行提供的配置，以下仅供参考）：

① dmz区url地址：

顺1地址如下：  url=http://yinqi.eqianjin.com.cn:8043/tmc-openbank-transfer-service/

② 交易端口号：8015

③ 文件服务端口号：8016

配置完成后，点击确定按钮保存

4. 安装部署银企云

前提：需要更新银企云最新补丁（建议更新该版本最新的紧急补丁）

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

4.1.1. 配置银企连接通道配置参数

（1） 登录金蝶云星瀚，进入银企云的应用【查询与支付】，银行启用管理，先启用九江银行JJCCB_CMP

（2） 进入【银企连接通道配置】页面，选择九江银行JJCCB_CMP，然后点击新增

（3） 进入新增页面，对以下参数进行配置

①前置机IP地址：安装九江银行前置机的服务器IP地址

②端口号：对应的九江银行的交易服务端口号

③并发锁数量：3个并发锁数量之和不能大于该前置机的最大并发数，设置时需要和银行确认后才能改（目前不支持电票，可以忽略电票的数量）

④金蝶代理程序端口号：由于该银行的明细就是文件格式，需要通过部署代理程序才能下载解析，对应金蝶前置代理程序上启动的九江银行的服务端口，务必两边保持端口一致性，具体配置参考4.2章节。

（4） 以上配置完成后，点击保存，然后点击测试连接；

注意：点击测试连接，代表银企到银行前置机的服务端口连通；如果不通的话，请检查连接配置。

4.1.2. 配置银企账户

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

4.1.3. 银企联通测试

银企账户配置完成之后，可以尝试测试余额及明细的查询；

在【查询与支付】-银行账户查询内，查询余额，如果余额能够成功查询，代表与银行的通讯是成功的（如果代理程序没通，明细也下不了，需要后续步骤验证）；

4.1.4. 银行参数配置

银行参数配置本身有默认参数，如果没有特殊情况可以不用配置。以下对常用的参数进行说明：

银行参数，根据实际用途分类为以下分类，可以根据实际使用时进行编辑调整；

1、支付/非支付通道开关说明

2、业务单据防重付款验证开关

3、回单明细限制查询日期：

4、交易明细摘要取值：

5、付款摘要特殊字符池：

6、 代发业务参数：

是否启用代发工资业务：默认不启用，如需通过银企代发工资（工资代发单）则开启参数，不控制报销代发单。

关联接口：仅查看作用，仅查看银行代发工资有哪些接口，不影响实际路由走向

7、 基础参数：

• 银行前置机公用开关：支持相同集群下不同的数据中心的前置机共用一个；

4.2. 配置【金蝶代理程序】参数

4.2.1. 配置九江银行参数

l  下载金蝶前置机代理程序安装包，解压后启动

l  进入“九江银行”页面进行配置

服务端口：设置未被占用的端口，并且需要开放给银企云访问，例如2357

1）配置参数

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

1：服务端口：2357，需保持端口开放，保证端口没有被占用。需要与【查询与支付】-【银企连接通道配置】金蝶代理服务器端口号保持一致；

2：文件上传目录/下载目录：一般是在对应的etmp\direct\temp下，以银行要求为准；

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

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

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

2）启动服务

代理程序参数配置完成后，点击【启动】按钮