【点聚CA配置指南】YonBIPV3.0（R5_2312_1）高级版配置指南用友网络科技股份有限公司1配置指南用友商业创新平台版权未经用友集团的书面许可，本产品说明任何整体或部分的内容不得被复制、复印、翻译或缩减以用于任何目的。本产品说明的内容在未经通知的情形下可能会发生改变，敬请留意。请注意：本产品说明的内容并不代表用友所做的承诺。用友网络科技股份有限公司2配置指南用友商业创新平台文档修订记录版本号时间作者描述1.02022.4.27史笑艳初始化版本1.12022.6.14史笑艳签名密文长度缩短调整1.22022.6.25许华超功能优化1.32022.6.27许华超CA和签章相关资料整合1.42022.7.18许华超优化文档说明1.52022.9.1许华超初始化配置文件优化1.62023.4.22许华超CA服务调用NC数据源用友网络科技股份有限公司3配置指南用友商业创新平台一、前言1.1目的本部署文档的主要目的是，帮助对接方技术开发人员了解YonBIP高级版集成南京CA文件部署位置，快速集成。1.2适用对象本规范的适用对象为对接方系统开发人员、维护人员。二、CA部署2.1运维部署服务所有替换动作都请提前备份。新部署CA补丁需要备份的文件有\ierp\sf\caRegisterCenter.xml，\ierp\bin\signature.xml，\hotwebs\nccloud\resources\platform\resource\ca目录下ca0.js、ca1.js、ca2.js、nccsign.js。2.1.1部署补丁包将《点聚CA.zip》中的补丁包《CA部署补丁包》里replacement目录下的文件拷贝至YonBIP高级版的Home根目录中。\hotwebs\nccloud\resources\platform\resource\ca目录下是前端CA安全密码模块相关的js(替换ca0.js、ca1.js、ca2.js、nccsign.js)；\ierp\sf\caRegisterCenter.xml文件是NC开启CA登录、支付的配置文件（替换）；\ierp\bin\signature.xml文件是NC开启CA签章的配置文件（替换）；\resources\njca目录下是CA的配置文件及证书、签章文件（新增）。以下是详细说明：文件目录JSca0.jsca1.jsca2.jsnccsign.js\hotwebs\nccloud\resources\platform\resource\ca用友网络科技股份有限公司4配置指南用友商业创新平台文件目录CA证书管理服务njca\..\hotwebs\njcaXMLcaRegisterCenter.xml\ierp\sfsignature.xml\ierp\bin配置文件raconfig.properties\resources\njcaraSealconfig.properties2.1.2配置数据源、初始化数据2.1.2.1配置CA证书管理服务数据源修改$HOME/resources/njca/raconfig.properties配置文件并修改数据源名称dsname，该值要与环境的账套数据源名称保持一致。注：dbType（数据库类型）默认为auto，会自动识别数据库类型，出现未能正确识别数据库类型的需要手动更改。数据库类型参考NJCA_SQL目录下的SQL脚本对应的数据库类型名称。用友网络科技股份有限公司5配置指南用友商业创新平台2.1.2.2执行数据库脚本数据源对应数据库中，需执行CA的SQL脚本：打开NJCA_SQL，根据数据库的类型执行脚本即可。注：如果当前数据源配置有数据库的数据表创建权限，可以访问http://服务器IP地址:端口/njca/web/init.html（账号：yonyou002密码：yonyou_2023!），进行初始化CA数据表、管理员等操作。完成上述所有配置后，需要重启YonBIP高级版生效。2.2实施安装配置2.2.1客户端PC控件1.http://服务器IP地址:端口/njca/static/showDownPTA.html（改成实际部署的服务IP进行访问）或从用友云盘（链接：https://pan.yonyou.com/s/7dUpKI9RYk密码：ygef）下载《用友商创UKey管理工具.exe》，用户电脑使用U盾需要安装用友商创Ukey管理工具。2.安装成功后，在桌面右键以管理员身份启动证书助手，进入证书助手后，若能正确显示Ukey内容即为安装成功。用友网络科技股份有限公司6配置指南用友商业创新平台2.2.2访问CA证书管理服务1、http://服务器IP地址:端口/njca（改成实际部署的服务IP进行访问）进入登录页面。（1）未导入证书的用户使用用友管理员账户登录账号：yonyou001密码：yonyou_2022!用友网络科技股份有限公司7配置指南用友商业创新平台（2）导入证书的用户可以使用U盾登录2、用户登录成功后，进入导入证书页面。用友网络科技股份有限公司8配置指南用友商业创新平台先点击读取证书，读取证书成功后，点击导入，提供添加成功即导入成功。2.2.3CA用户激活与配置YonBIP高级版激活使用CA模块功能，请联系分公司商务增加licenseCA用户数授权。报价的时候要把CA这个模块选上就行。如果后来发现漏了，就走产品赠送流程，这个流程销管会告诉销售的。用友网络科技股份有限公司9配置指南用友商业创新平台2.3测试部署成功说明2.3.1登录、支付测试，在根文件夹下启动stop.bat、startup.bat1、启动成功后，进入YonBIP高级版登录页，使用CA用户进行登录。3、CA用户认证成功后，进入结算页支付单据并完成签字。3、签字成功后，进行网上转账，此时会弹出窗口二次校验当前USBKEY密钥是否正确，输入密钥后提示‘网上支付操作成功’即视为操作完成。用友网络科技股份有限公司10配置指南用友商业创新平台4、若技术人员需查看调用接口日志，可进入\nclogs\server\nccforca-log.log查询相关日志信息。2.3.2签章测试，在根文件夹下启动stop.bat、startup.bat1、启动成功后，进入YonBIP高级版登录页，进行登录。用户登录成功后，进入票据签发并完成签字。用友网络科技股份有限公司11配置指南用友商业创新平台2、签字成功后，进入票据签发回单，打印选择补充打印，正常显示签章图片表示签章成功。用友网络科技股份有限公司12配置指南用友商业创新平台3、若技术人员需查看调用接口日志，可进入\nclogs\server\nccforca-log.log查询相关日志信息。2.3.3开启日志调试1、修改resources\njca\raconfig.properties配置文件，将logbug改成logbug=true、去掉loglevel=zdy前的注释#符号。2、修改resources\njca\raSealconfig.properties配置文件，将logbug改成logbug=true、去掉loglevel=zdy前的注释#符号。注：修改配置文件需要重启BIP服务生效。日志文件路径：ncchome/nclogs/nccalog.log、ncchome/nclogs/ncseallog.log。用友网络科技股份有限公司13配置指南用友商业创新平台三、注意事项3.1运维注意事项（1）YonBIP高级版集成《CA部署补丁包》注意备份，全部拷贝到YonBIP高级版根目录，注意旧版本jar包删除。（2）配置CA证书管理服务数据源、执行数据库脚本之后需要重启YonBIP高级版服务。3.2实施注意事项（1）YonBIP高级版下单时需要激活使用CA模块功能，license包含CA用户数授权。（2）《用友商创UKey管理工具》是安装在使用YonBIP高级版、登录CA证书管理服务的客户电脑上使用。（3）YonBIP高级版登录的用户证书需要导入CA证书管理服务。（4）YonBIP高级版正式服务器证书联系南京CA公司签发部署，服务器证书过期后需要联系南京CA公司延期部署。3.3测试注意事项（1）发证时证书的O项（即用户编码）与YonBIP高级版用户编码保持一致。（2）YonBIP高级版设置为CA用户，进入系统中搜索用户管理模块，进入用户页将登录认证方式改为CA验证并勾选是CA用户。用友网络科技股份有限公司14配置指南用友商业创新平台用友网络科技股份有限公司YonyouNetworkTechCo.Ltd.
