# E10通过e-cology8或e-cology8/9(token认证)套件单点E8系统

来源快照：`result_data_new_260518.json`

- 来源 ID：`1175094711412080667`
- 模块：集成中心
- 目录：集成登录 - 配置示例 - E10集成登录单点E8系统
- space ID：`1158011075224911873`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 一、功能介绍

**注意：需要购买统一认证****-****集成登录功能。**

实现OA系统的单点登录功能，以便无缝接入e-cology8系统。

# 二、功能概述以及使用说明

**注意：****e10****支持两种e-cology8套件****：****e-cology8/9(token认证)和e-cology8。**

**请根据客户现有的e-cology8系统KB版本，选择相应的套件进行配置。**

 

## 1、e-cology8操作

e-cology8系统提供两种单点登录方案，一种是通过/login/VerifyLogin.jsp页面单点； 一种是通过TOKEN认证单点登录。两者单点方式限制以及区别：

 | **/login/VerifyLogin.jsp页面单点**| **TOKEN认证单点**  
---|---|---  
**共同点**|  需要E10系统人员与e-cology8系统存在对应关系  
**E8系统限制**|  e-cology8系统不能启用 验证码，否则无法单点登录| E8系统，需要**KB81001806**以后版本** ，才支持Token认证  
**E10系统限制**|  需要E10系统人员中维护e-cology8系统人员的密码| 需要E10系统在weaver-intlogin所在应用服务器里面可以请求通E8系统的token接口  
  
若考虑通过e-cology8/9(token认证)套件配置，需要部署TOKEN认证。

### 1.1、e-cology8系统部署TOKEN认证

具体可参考文档：[https://www.e-cology.com.cn/sp/doc/docDetail/100500240003046305](https://www.e-cology.com.cn/sp/doc/docDetail/100500240003046305)

 

#### 1.1.1、配置web.xml

E8系统中，ecology\WEB-INF\web.xml中需要配置：（**需要放在安全补丁包的后面** ）

 <filter>  <filter-name>WeaverLoginFilter</filter-name>  <filter-class>weaver.weaversso.WeaverLoginFilter</filter-class> </filter> <filter-mapping>  <filter-name>WeaverLoginFilter</filter-name>  <url-pattern>*.jsp</url-pattern> </filter-mapping>  
---  
  
在ecology\WEB-INF\web.xml最后面配置：(**< /web-app>前面**)

 <servlet>  <servlet-name>getToken</servlet-name>  <servlet-class>weaver.weaversso.GetToken</servlet-class> </servlet> <servlet-mapping>  <servlet-name>getToken</servlet-name>  <url-pattern>/ssologin/getToken</url-pattern> </servlet-mapping>  <servlet>  <servlet-name>CheckToken</servlet-name>  <servlet-class>weaver.weaversso.CheckToken</servlet-class> </servlet> <servlet-mapping>  <servlet-name>CheckToken</servlet-name>  <url-pattern>/ssologin/checkToken</url-pattern> </servlet-mapping>  
---  
  
 

 

#### 1.1.2、配置WeaverLoginClient.properties

E8系统中，配置ecology\WEB-INF\prop\WeaverLoginClient.properties文件，配置E8系统的应用：

E9=10.10.69.37,10.1.1.22  
---  
  
**注：左侧配置单点登录OA标识，右侧配置允许单点登录OA的物理IP地址，多个以逗号分隔，包括代理后的IP地址。**

 

#### 1.1.3、浏览器中验证E8系统的token接口

在浏览器中直接访问：

E8系统地址/ssologin/getToken?appid=WeaverLoginClient.properties文件中注册的标识&loginid=E8系统人员账号

确保能够获取到token值。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871439322128393&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

#### 1.1.4、E10系统应用服务器中验证调用E8系统的token接口

**需要E10系统在weaver-intlogin所在应用服务器里面** ，需要验证是否能够请求E8系统的token接口：

curl 'E8系统地址/ssologin/getToken?appid=WeaverLoginClient.properties文件中注册的标识&loginid=E8系统人员账号'  
---  
  
确保从应用服务器中能够请求通E8的token接口

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871465071755267&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

 

## 2、功能入口

配置新建集成登录e-cology8提供了两个功能相同的入口，推荐使用入口1：

入口1：

【集成登录】-【集成登录设置】-【e-cology8】

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871507980312583&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

需要集成登录权限：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871529331892237&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

 

入口2：

此入口需购买ESB中心非标

【ESB中心】-【连接器】-【协同办公】-【泛微ecology】-【套件】-【集成登录】-【e-cology8】

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871559472160772&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

需要ESB-连接器权限：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871581070254082&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

## 3、配置说明

### 3.1、e-cology8/9(token认证)

#### 3.1.1、选择套件快速创建

通过入口1和入口2，用户可以迅速设置**e-cology8/9(token认证)** 的集成登录功能。除了必须手动配置的参数外，其他设置将默认生成，并且这些默认参数可以在详细设置中进行修改。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871610991591429&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**配置项**| **说明**  
---|---  
启用| 默认开启，控制此集成登录是否可用的开关  
名称| 任意  
套件类型| e-cology8/9(token认证)  
所属机构| 开启分权时显示  
外网地址| E8系统地址/ssologin/getToken  
应用标识(appid)| E8系统WeaverLoginClient.properties文件中注册的标识  
最终单点跳转地址(loginUrl)| 实际需要单点登录打开的E8系统地址  
  
点击保存并进入详细设置，默认了自定义参数loginid（登录名），其中：

loginid登录名默认用户参数-登录名，若E10系统人员的登录名对应e-cology8系统人员的账号，则无需更改。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871688313995266&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

 

#### 3.1.2、从空白创建

通过入口1，可直接从空白创建e-cology8/9(token认证)套件。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871705502253067&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

套件类型选择“e-cology8/9(token认证)”， 会自动带出相关配置， 其中外网地址以及自定义参数跟“ _选择套件快速创建_ ”中参数一致。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871726977089538&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

### 3.2、e-cology8

#### 3.2.1、选择套件快速创建

通过入口1和入口2，用户可以迅速设置**e-cology8** 的集成登录功能。除了必须手动配置的参数外，其他设置将默认生成，并且这些默认参数可以在详细设置中进行修改。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871748611309571&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**配置项**| **说明**  
---|---  
启用| 默认开启，控制此集成登录是否可用的开关  
名称| 任意  
套件类型| e-cology8  
所属机构| 开启分权时显示  
外网地址| E8系统地址/login/VerifyLogin.jsp  
  
点击保存并进入详细设置，默认了自定义参数loginid（登录名）、userpassword（密码）、logintype（登录类型），其中：

loginid登录名默认用户参数-登录名，若E10系统人员的登录名对应e-cology8系统人员的账号，则无需更改；

userpassword密码默认用户参数-登录密码，若E10系统人员的密码对应e-cology8系统人员的密码，且，确保每次E10登录都走账号密码登录，则无需更改；（建议是设置用户录入，在用户录入页面手动维护E8系统的密码）

logintype登录类型默认固定值1，无需改动。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871778523881477&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

 

#### 3.2.2、从空白创建

通过入口1，可直接从空白创建e-cology8套件。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871795629457417&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

套件类型选择“e-cology8”， 会自动带出相关配置， 其中外网地址以及自定义参数跟“ _选择套件快速创建_ ”中参数一致。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871817163014152&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

### 3.3、共享范围

需要在共享范围内设置，哪些人员能够通过此集成登录应用进行单点登录。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871843004538888&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

 

### 3.4、门户集成登录组件

按照实际需要选择是否配置

【后端管理中心】-【门户】-【设计】

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871864448393216&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

模块组件中搜索“集成登录”可添加集成登录组件。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871881709576195&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

设置后，有权限人员在门户中可展示集成登录组件，点击应用可直接单点登录e-cology8系统。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871898774577157&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

### 3.5、构建应用

按照实际需要选择是否配置。

【后端管理中心】-【应用管理】-【构建应用】

可配置菜单，菜单中集成登录可选择已配置的集成登录。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871915988000783&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

可配置单页面内容， URL地址配置集成登录的单点登录地址。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871933060022287&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

集成登录的单点登录地址可通过集成登录里面【更多】-【单点登录地址】进行复制。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234871950374109197&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

最终效果，有权限人员在应用中可点击应用单点登录到e-cology8系统。

# 三、常见问题

## 问题1、集成登录配置后，后台测试预览报错“当前集成登录请求第三方接口异常，请向第三方确认！”

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234872006308143108&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**问题原因：** 根据[ _https://www.e-cology.com.cn/sp/doc/docDetail/8143405731701209430_](https://www.e-cology.com.cn/sp/doc/docDetail/8143405731701209430) 此文档步骤排查日志分析，sys-err.log日志检索关键词“ssologin”输出异常： is not allowed; IP is :XX.XX.XX.XX': Invalid query，表示ip不在设置的token应用白名单范围内。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234872023244742673&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**解决方案：** ecology\WEB-INF\prop\WeaverLoginClient.properties文件，在对应的应用标识等号右侧加上输出的ip地址，保存即可，无需重启服务。
