01_平安银行B2BiC客户端配置FAQ合编.docxVIP

平安银行外联客户接入FAQ平安银行信息科技部2015年10月20日文档修改记录序号日期说明编写者审核者0.12015-10-20初始化编写郭立涛目 录第一章 概述41.1 名称定义41.2 直连系统对接干系人和职责51.3 银企直连系列文档61.4 干系文档下载地址61.5 银企直连系统通讯结构图71.6 通讯客户端（签名软件）介绍71.7 客户端日志的目录8第二章 联测问题配合的流程92.1 联测配合范围92.2 了解客户是谁92.3 问题初步受理102.4 问题详细收集11第三章 问题案例123.1 客户端配置123.2 对接流程123.3 YQ9986:企业没有开通银企直联123.4 YQ9990:企业本账户没有开通此交易133.5 YQ9977:XML报文体解析编码或格式异常143.6 客户连接不上银行143.7 查询状态类接口提示：没有满足条件纪录153.8 接口疑问15概述此规范便于干系人了解直连业务的接入流程，直连系统干系人有：总行业务负责人、总行技术人员、总行网络人员、分行客户经理、分行技术和网络人员、企业业务和技术负责人、企业ERP方。名称定义名称描述通讯规范企业系统与银行的系统进行通讯的协议、报文的定义的统称专线接入企业为了安全或其他考虑，与银行使用专线连接，可以从本地分行，或者银行总部（深圳观澜）接入。互联网接入企业访问银行在互联网提供的统一接入地址B2BiC平安银行SCFP-B2Bi外联通讯前置客户端，用作签名和通讯代理，FTP传输。报文规范外联平台的A001、A002报文规范，即由222位定长报文头组成，详细定义参考接口文档 或 b2bic客户端手册数字证书数字证书就是互联网通讯中标志通讯各方身份信息的一串数字，提供了一种在Internet上验证通信实体身份的方式，数字证书不是数字身份证，而是身份认证机构盖在数字身份证上的一个章或印（或者说加在数字身份证上的一个签名）。它是由权威机构——CA机构，又称为证书授权（Certificate Authority）中心发行的，人们可以在网上用它来识别对方的身份文件证书以pfx文件形式存放的数字证书，安全性差，易复制USBKEY证书存放在usbkey设备中的数字证书，安全性高，无法复制通讯代理Baidu词条SSLBaidu词条HTTPSBaidu词条HTTPBaidu词条同步短连接Baidu词条上行通讯银行做服务端，企业做客户端的场景。企业发送请求，银行实时返回通讯结果，同步短连接。下行通讯银行做客户端，企业做服务端的场景。银行请求客户，客户的系统实时返回通讯结果，同步短连接。USBKEY类型目前签发有两种，飞天诚信、捷德无驱签名方式USB_COM-普通USBKEY：支持飞天诚信、浏览器容器证书；JD_NoDrv-捷德无驱USBEKY:支持捷德无驱干系文档下载地址参考附件“00_FTP获取安装包.txt”。外联平台通讯结构图机器1为ERP服务器，即企业搭建的和银行进行通讯的系统。银行提供“机器2”为一通讯加密软件，负责SSL通讯加密和报文RSA数字签名，使用SSL 安全地发送到银行前置系统，再接受银行的实时返回给客户的ERP服务器（同步短连接）。通讯前置机软件安装后默认开启7072端口(可配置更改)进行SSL通讯代理，客户端ERP直接读写7072端口，即可实现和银行银企直连系统通讯。银行提供通讯前置机软件，安装在普通PC机器上，PC机器系统建议为winodws XP, 2003, 2008ServerR2。机器要求能够访问互联网，为如下图的“机器2”（机器1和机器2物理上可以合并）。签名软件目前有“格尔国信银企直连安全客户端v1.5 平安银行版(SCP)”和“b2bic”两版，推荐使用“b2bic”。通讯客户端（签名软件）介绍B2BiC：全名“平安银行SCFP-B2Bi外联通讯前置客户端”，运行依赖JDK1.6(32位)，可以实现HTTPS通讯代理和pkcs7签名服务，可用支持上行、下行双向监听，支持FTP文件传输，能够和银行银企直连、供应链、P2P交易资金等其他目标系统对接，是目前最新版的直连和外联系统前置机。 客户端日志的目录B2bi前置机的日志目录：b2bic\log\trade.log 表示当天最新日志，trade.log.yyyy-MM-dd是对应日期的日志。常见问题B2BiC客户端关键配置演示B2BiC客户端的配置，解释关键配置项的意义。关键配置路径如上图1、2、3、4、5、6 标示的地方分别代表的意思：上行通讯，B2BiC客户端配置监听客户请求的协议、端口，在“面向企业端配置---前置接入服务配置”。上行通讯，B2BiC客户端配置访问银行服务端的地址、端口，在“面向银行端配置---接出服务配置”：如上两处是上行通讯场景需要配置的地方，如果企业和银