集成服务云EAS连接器部署手册(升级版)

项目组必须有集成开发经验的开发和懂技术的实施顾问，不然不做项目支持。

数据脱敏：如因未脱敏导致正式环境的数据问题，请自行负责！！！

将苍穹或者EAS的正式库备份到测试环境用于测试时，需要对数据库进行数据脱敏，防止测试过程中将测试数据同步到正式环境。具体脱敏步骤，请下载附件。

应用场景：

金蝶云苍穹与EAS存在集成需求，需要跟EAS集成。

与之前的的文章《集成服务云EAS连接器部署手册》对比部署方式做了升级，简化EAS端的配置，并将文件配置界面化。

部署要求：

EAS服务端必须部署JDK1.6及以上版本且是EAS8.0及以上版本。
注意：EAS使用的部分JDK版本会出现调用苍穹https时报传输加密层的握手错误“Caused by: javax.net.ssl.SSLHandshakeException: Received fatal alert: handshake_failure”导致EAS连接配置部署失败，所以当苍穹从http协议切换到https协议时，需要特别慎重并在测试环境验证没有问题后再切换。此问题可以通过切换EAS的JDK版本解决。
EAS如果是多机群集，则每个机器上都需要部署，内容和配置文件完全一致。
EAS部署的服务器和苍穹部署的服务器网络需要互通。如何检查网络互通情况请看帖子https://club.kdcloud.com/article/14039
如果EAS端有url访问控制，需要联系运维确保http://eas服务器ip:网络代理端口/isc 下的url都允许被苍穹访问

部署步骤：

一、EAS连接器部署：

1. 获取部署文件isc.war.zip和sp.zip。

按照苍穹的版本号，下载对应的连接器部署包

https://club.kdcloud.com/article/146134

2. 将 isc.war 目录拷贝到EAS的 \eas\server\deploy\easweb.ear 目录下。

注意：拷贝时不要丢字节，有的客户通过向日葵等拷贝后，会出现字节数变为0字节。

isc.war添加后正确的目录结构

修改 \eas\server\deploy\easweb.ear\META-INF\application.xml, 将下面这段代码添加到application.xml 。

<web>

<web-uri>isc.war</web-uri>

<context-root>/isc</context-root>

</web>

</module>

建议在原文件中直接拷贝上面的一段，把值修改为isc.war和/isc，避免出错。该文件多一个空格启动都会有问题，修改一定要谨慎。

假如eas是部署在linux环境下的，修改apllication.xml后请记得在linux服务器里用vim工具直接打开确认下里面是否有乱码，或者用IE将文件apllication.xml打开看看是否能打开。

3 请将sp.zip里面的isc-iscb-connector-eas.jar 、 isc-iscb-util.jar移到eas\server\lib\sp

注意：拷贝时不要丢字节，有的客户通过向日葵等拷贝后，会出现字节数变为0字节。

4. 重启EAS。

5.能够正常访问：http://eas服务器ip:网络代理端口/isc/proxy 。页面出现OK，说明部署成功。

注意：如果浏览器出现NOP，只是说明访问上面地址太频繁，过几分钟后再访问就会再次出现OK。

EAS连接器部署视频：https://vip.kingdee.com/school/287510170652378368

二、苍穹远程部署

1. 配置EAS连接配置信息，也可以参考https://club.kdcloud.com/article/13674 。

进入【集成服务云】-【集成管理】-【连接管理】-【连接配置】页面，点击“新增”按钮，连接类型选择"EAS系统"，文本框"EAS账套"的内容请查看EAS管理控制台“数据中心”页签的字段“代码”值，输入相关信息后点击保存按钮。

注意：

A : 连接配置每次修改保存后会重新生成访问键信息，所以访问键信息变化后需要重新部署（包括重新选择苍穹代理用户），否则将会导致苍穹连接EAS异常。

B : 登陆用户：EAS客户端登陆的用户密码，用于苍穹配置EAS连接信息，该EAS用户需要有业务权限且不能用于登陆EAS系统进行业务操作（需要哪些业务权限需要看集成哪些单据，把需要集成的单据权限分配给该用户即可）。

C:苍穹代理用户：苍穹用户用于苍穹配置EAS连接信息的代理用户，并且这个代理用户的用户名不为空，该苍穹用户需要有业务权限，需要哪些业务权限需要看集成哪些单据，把需要集成的单据权限分配给改用户即可。

D : 服务器端口：填写非EAS实例1的HTTP端口（一个实例的情况可以用EAS实例1的HTTP端口）或者网络代理页面的HTTP端口（多实例的情况）。特别说明：多实例情况下千万不要使用server1主实例的HTTP端口，初始化数据量大的情况下有可能导致server1压力过大（EAS主实例server1承载了license和工作流服务，如果EAS的主实例server1不可用会导致EAS其他实例都无法使用）。

2、远程部署访问键：进入【集成服务云】-【集成管理】-【连接管理】-【连接配置】页面，选择EAS的连接点击“部署”按钮，弹出部署弹出框。

本系统 :“本系统”就是指你当前使用的苍穹系统，连接器需要使用该URL与集成云交互，请确保在连接器部署的服务器上可以访问当前苍穹系统。

密码提示 : 这里的密码是指部署连接器的系统(EAS客户端登陆)的管理员的密码，切记不是苍穹系统的管理员密码。此密码仅用于部署验证是否具有“管理员”身份，在苍穹数据库中不会保存，也不会在网络上传输。

业务授权模式：

全部授权：全部集成对象都授权使用（默认值，测试环境建议使用这个模式）

白名单：根据管理授权清单里面的集成对象内容来实际授权（UAT和正式环境建议使用这个模式，但是需要管在管理授权页面新增需要授权的集成对象），关于授权的内容会有专门的文章要说明。

禁止访问：禁止任何访问，无法进行数据集成

注意：连接配置每次修改保存后会重新生成访问键信息，所以访问键信息变化后需要重新进行部署操作，否则将会导致苍穹连接EAS异常。

3. 测试连接，部署后点击“测试”按钮，如果出现测试成功，说明连接配置已经配置正常。

4.网络检查

苍穹所在服务器可以成功访问http://eas服务器ip:网络代理端口/isc/proxy。

windows系统 :在苍穹所在服务器浏览器输入 http://eas服务器ip:网络代理端口/isc/proxy 出现OK说明成功。

如果是公有云可以使用网络检查功能测试网络情况。https://club.kdcloud.com/article/171596

172.12.5.68是研发内部测试服务器，不能直接拿来测试，请根据实际情况修改。如果映射了域名，直接telnet域名，例如苍穹网站为https://www.baidu.com/，则telnet www.baidu.com 443。

linux 系统: 在苍穹所在服务器终端输入命令 curl http://eas服务器ip:网络代理端口/isc/proxy 出现OK说明成功。

多苍穹环境连接1套EAS部署方式：

集成服务云EAS连接器部署手册(升级版)

集成服务云EAS连接器部署手册(升级版)

恭喜您！