建行CCIP版本银企实施指南

项目实施流程：

1、 背景

中国建设银行现金管理直联CCIP版本，该版本由于不存在银行前置机的安装，需要银行拉专线处理。因此前置机软件安装部署这一个环节不存在，需要通过金蝶提供的前置机代理程序安装部署，取代银行前置机软件的作用，通过代理程序完成查询余额、下载交易明细、下载电子回单、付款等全部交易，同时，由于该银行电子回单为PDF文件格式，还可以通过该前置机代理程序的电子回单服务获取。

1.1 下载途径

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

2、 安装前置机代理程序

2.1 启动代理程序

下载前置机代理程序压缩包，解压后启动代理程序服务，目录结构参考如下：

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

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

系统默认使用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 配置代理程序参数

1) 登录金蝶前置机代理程序服务

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

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

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

需要先修改初始密码，并记得保存后登录密码。登录后找到对应的银行版本“中国建设银行现金管理版本CCB_CCIP”

2）配置参数

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

序号1：服务端口：全部业务的使用端口，需保持端口开放，如无特殊需求，使用默认的2333即可，该配置的端口号需要与【查询与支付】-【银企连接通道配置】上服务端口号保持一致；

序号2：文件业务服务端口：指定文件的业务端口，默认7777，该配置的端口号需要与【查询与支付】-【银企连接通道配置】上文件业务服务端口号保持一致，需保持端口开放；

序号3：银行服务地址：访问银行服务的地址，申请开通环境后由银行提供；

序号4：金蝶公钥更新程序开放端口：提供给银行下载公钥的端口，服务器IP+本端口组合成提供给银行下载公钥URL地址，例如本机服务器IP地址是192.168.1.1，端口配置为8813，那么提供给银行的客户公钥下载URL为http:// 192.168.1.1 :8813 ，如果银行要求提供后缀，则可提供银行公钥交换url

序号5：电子银行合约编号：客户与银行签订的合约编号（渠道号），由银行提供；

序号6：前置机公钥白名单：获取前置机公钥的IP名单，一般是配置银行IP，银行需要下载公钥，多个IP用英文逗号,分隔开，除了银行IP以外，还需要把本机IP配上。

序号7：访问IP地址白名单：除了本机IP以外，任何需要访问代理程序的服务IP都需要配置，包含银企云服务器IP、银行服务器IP

1、 注意：如果服务上有杀毒软件，请务必保证杀毒软件已经设置了访问IP的白名单。确保金蝶代理程序和银行的网络通畅，自行检测方式为：代理程序服务器开启cmd,通过telnet命令测试银行服务端口，比如银行服务端口提供的是http:172.20.10.10:8812 ,那么我们需要确保我们服务器能正常访问，

telnet 172.20.10.10 8812 正常联通，并且需要保证银行能正常访问我们的代理程序端口（白名单+防火墙开放端口）

3）启动中国建设银行现金管理直联的代理程序服务，如果出现以下提示，则需要等银行获取公钥后（间隔半个小时以上），退出代理程序，重新通过脚本启动代理程序，中国建设银行现金管理直联的代理程序服务，然后再次启动即可。

2、 安装部署银企云

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

4.1 安装银企云环境

1） 下载银企云的补丁包

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

4.2 配置【查询与支付】参数

3.1.2.1 配置银企连接通道配置

1） 登录进入银企云的应用【查询与支付】

2） 进入【银行启用管理】，启用对应银行

3） 进行【银企连接通道配置】，新增或修改“中国建设银行企业现金管理直联版”，参数配置说明如下：

金蝶前置代理配置：

1） 代理服务器IP地址：一般是安装金蝶前置代理程序的服务器IP，如果是做了映射跳转，则录入映射后的IP。

2） 服务端口号：代理程序上的服务端口

3） 文件业务服务端口号：代理程序上的文件业务服务端口

网银登录配置（银行提供的配置）

按需录入，参数均为银行提供，如不提供可以不用配置，电子银行合约号为以下提供的渠道号。

3.1.2.2 配置银企账户

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

1） 进入【银企账户】，新增或者修改银企账户

2） 账户参数说明如下：

账户类别：一般都是普通类，这个取决于维护的银行账户所属类别，比如如果是虚拟现金池账户就维护成虚拟现金池。

电子回单账号：该银行账号