# E10通过e-cology9或e-cology8/9(token认证)套件单点E9

来源快照：`result_data_new_260518.json`

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

## 正文

# 一、功能介绍

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

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

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

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

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

 

## 1、e-cology9操作

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

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

### 1.1、E9系统部署TOKEN认证

#### 1.1.1、E9系统部署TOKEN认证

E9系统需依据当前的KB版本，参考TOKEN认证功能介绍，进行TOKEN认证的部署。

E9(KB9002212到最新版本):

https://www.e-cology.com.cn/sp/doc/docDetail/100500240009902329

E9(KB9002008到 KB9002209版本)：

https://www.e-cology.com.cn/sp/doc/docDetail/100500240014459325

E9(KB9002003到KB9002008版本)：

https://www.e-cology.com.cn/sp/doc/docDetail/100500240014459327

E9(KB9001910到KB9002002版本)：

https://www.e-cology.com.cn/sp/doc/docDetail/100500240014459328

E9(KB9001909之前版本)：

https://www.e-cology.com.cn/sp/doc/docDetail/100500240014459330

 

依据最新E9系统KB版本部署TOKEN认证：

1，启用TOKEN认证

E9系统中，集成中心-统一认证中心-认证服务管理-Token认证，启用Token认证，点击保存。

保存后，需要手动重启下中间件服务。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235201288529698829&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)

（注意：若OA集群环境，需每个节点登录，保存下Token认证，并重启下中间件服务）

 

2，注册E10系统的TOKEN应用

E9系统中，集成中心-统一认证中心-认证服务管理-认证应用管理，注册E10系统的Token认证应用。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235201309894656009&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)

其中：

认证方式，选择TOKEN；

应用标识，点击“生成”按钮自动生成；

IP白名单，配置E10系统应用服务的所有IP地址，包括代理的IP地址；

账号映射规则，配置E10系统传的值对应E9系统人员哪个属性。（需要先确定两套系统中的人员对应关系，比如说，若两套系统人员账号一致，则这里选择用户名即可； 若两套系统人员编号一致，则这里选择工号即可。）

 

#### 1.1.2、浏览器中验证E9系统的token接口

在浏览器中直接访问：

E9系统地址/ssologin/getToken?appid=认证应用管理注册E10系统的应用标识&loginid=认证应用管理注册E10系统账号映射规则对应的人员属性

确保能够获取到token值。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235201339968643084&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.3、E10系统应用服务器中验证调用E9系统的token接口

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

curl 'E9系统地址/ssologin/getToken?appid=认证应用管理注册E10系统的应用标识&loginid=认证应用管理注册E10系统账号映射规则对应的人员属性'  
---  
  
确保从应用服务器中能够请求通E9的token接口

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235201370044375043&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-cology9提供了两个功能相同的入口，推荐使用入口1：

入口1：

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

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235201399983316996&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=1235201421551632390&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-cology9】

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235201451725455365&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=1235201473123590161&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=1235201498890821640&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-cology9/9(token认证)  
所属机构| 开启分权时显示  
外网地址| E9系统地址/ssologin/getToken  
应用标识(appid)| E9系统中注册E10系统的token应用标识  
最终单点跳转地址(loginUrl)| 实际需要单点登录打开的E9系统地址（不能只配置域名或者ip），比如首页：http://10.10.10.42/wui/index.html  
  
点击保存并进入详细设置，默认了自定义参数loginid（登录名），其中：

loginid登录名默认用户参数-登录名。需与E9Token认证应用设置的账号映射规则匹配，**注意：****E9****和****E10****系统中，这个映射规则匹配的字段值要保证唯一性。**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235201541894602756&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=1235201571837329416&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=1235201597686030346&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-cology9

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

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

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235201623427268610&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-cology9  
所属机构| 开启分权时显示  
外网地址| E9系统地址/login/VerifyLoginE9.jsp  
  
点击保存并进入详细设置，默认了自定义参数loginid（登录名）、userpassword（密码），其中：

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

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

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235201653391376390&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-cology9套件。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235201679328952323&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-cology9”， 会自动带出相关配置， 其中外网地址以及自定义参数跟“ _选择套件快速创建_ ”中参数一致。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235201700661182468&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=1235201722363338756&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=1235201739379212296&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=1235201760765558790&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=1235201786620076034&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=1235201803875442697&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=1235201829699354626&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=1235201855439388681&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-cology9系统。

# 三、常见问题

## 问题1、E10-token认证套件配置单点E9的应用模块页面，最终单点跳转地址挂E9的模块地址。在前端加应用，菜单链接选择菜单，怎么才能实现直接从 E10跳转到E9模块呢？

** **

**问题原因：** 自定义参数设置的认证应用标识appid在E9-OA中未注册，前台设置的菜单地址直接配置了最终单点跳转地址。

**解决方案：** token套件单点E9应用页面，根据上面的** _（_**** _1.1_**** _、_**** _E9_**** _系统部署_**** _TOKEN_**** _认证）_** 步骤先确保E9自身的token认证部署单点都正常后，E10前台设置菜单，url地址可复制集成登录应用编辑页面，右上角更多-单点登录地址 进行粘贴配置。

注意：自定义参数配置的时候，前后不要有空格。

 

## 问题2、e-cology8/9(token认证)套件配置单点E9，单点登录失败，提示“当前集成登录请求第三方接口异常，请向第三方确认!”

 

**问题原因****1****：** E9中对应匹配的人员工号有重复数据，导致获取不到token。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235201898272448525&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****：** E9中token认证应用设置的账号映射规则的值需要保证唯一性，并确保E9本身的获取token接口能正常获取到token后，再验证E10单点。

 

 

**问题原因****2****：**

1.  E9是集群，其中一个节点的ecology/WEB-INF/web.xml文件内没有单点过滤器和token认证的配置；

2.

  E10配置外网地址和最终单点跳转地址不对。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235201923970531334&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****：**

1.

 手动向ecology\WEB-INF\web.xml文件中添加单点过滤器和Token的配置（确保集群每个节点都有下面的配置），调整后，重启OA服务生效：

 

    <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>     <filter-mapping>        <filter-name>WeaverLoginFilter</filter-name>         <url-pattern>*.html</url-pattern>    </filter-mapping>     <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>  
---  
  
 

2.

外网地址需配置E9系统的获取token接口地址，最终单点跳转地址需配置E9系统要打的具体页面地址。

 

**问题原因****3****：** 配置的外网地址前面 或 自定义参数的参数值前后有空格。

**解决方案****3****：** 去掉前后空格，获取token单点正常。

 

## 问题3、token认证套件配置单点到E9，E9显示的是别人的账号。

**问题原因：** E9系统的ecology/WEB-INF/web.xml文件中，增加了防超时过滤器，导致Token切换用户失败；

防超时过滤器配置如下：

 

<filter>

   <filter-name>LoginExtensionFilter</filter-name>

   <filter-class>weaver.filter.login.LoginExtensionFilter</filter-class>

</filter>

<filter-mapping>

   <filter-name>LoginExtensionFilter</filter-name>

   <url-pattern>/*</url-pattern>

</filter-mapping>

**解决方案：** E9系统的ecology/WEB-INF/web.xml文件中，将防超时过滤器配置注释后，重启OA服务生效，单点正常。

 

## 问题4、E10通过e-cology8/9(token认证)套件配置单点E9，单点登录失败，提示“当前集成登录请求第三方接口不通，请检查网络!”

 

**问题原因：** E10系统应用服务器，无法访问到E9获取token接口；

**解决方案：** 需要确保E10系统weaver-intlogin所在应用服务器里面，能够请求通E9的获取token接口，根据上面的**（**** _1.1.3_**** _、_**** _E10_**** _系统应用服务器中验证调用_**** _E9_**** _系统的_**** _token_**** _接口_ ）**步骤进行验证。

 

## 问题5、配置token单点E9，已经获取到token了，但是单点报错404。

** **

**问题原因：** 404是安全拦截导致。

**解决方案：** 需根据安全组提供的方案：[ _泛微在线文档_](https://e-cloudstore.com/doc.html?appId=d11510a96afc4492a30d3339dbe7a7b7#4.%E7%AC%AC%E4%B8%89%E6%96%B9%E7%B3%BB%E7%BB%9F%E8%AE%BF%E9%97%AEoa%E6%8A%A5404\(referer%E9%98%B2%E6%8A%A4%E6%8B%A6%E6%88%AA\)) 添加下地址白名单，再测试单点是否正常。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235201962707918851&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)
