# 整体介绍

来源快照：`result_data_new_260518.json`

- 来源 ID：`1167675593557524492`
- 模块：集成中心
- 目录：统一认证接入管理
- space ID：`1158011075224911873`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 一、功能背景及价值用途

统一认证接入管理支持E10接入第三方统一认证平台，实现多平台互相免登录效果。需根据第三方提供的服务方式选择对应的认证方式进行适配。

# 二、功能概述

目前统一认证接入管理功能，可支持多种认证协议（CAS2.0、OAuth2.0、SAML、WebSEAL、网关、自定义），可适配市面大多数认证服务厂商。

同时也适配了多种配置场景，如PC、APP分离、多地址认证接入、双认证体系等。请根据需要进行配置：

**认证接入管理** 说明：若OA不需要支持内外网地址均可进行认证登录 或 没有需要根据访问的指定域名走指定认证协议的需求，请配置认证接入管理功能；

**多地址认证接入** 说明：若OA需要支持内外网地址均可进行认证登录 或 需要根据访问的指定域名走指定认证协议，请前往多地址认证接入处进行配置。

确认使用的功能后，进入对应功能页面，根据需要的协议类型进行相关配置即可。

# 三、功能详细说明

## 1、界面布局

统一认证接入管理支持“认证接入管理”、“多地址认证接入”、“接入日志管理”菜单项。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959314830901313&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、认证接入管理

入口：后台管理中心-集成中心-统一认证接入管理-认证接入管理

权限：

权限项| 控制内容  
---|---  
查看| 开启查看权限，认证接入管理页面才可查看，否则提示“对不起，您暂时没有权限！”  
保存| 开启保存权限，认证接入管理页面显示保存按钮，否则无法保存。  
  
 

未开启时，显示协议面板页面：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959310628208760&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）认证类型

认证接入功能开启时，会弹出认证类型选择框，可支持选择PC端认证、移动端认证、PC&移动端认证三种模式：

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

注：PC端认证可支持所有协议，但移动端认证仅支持CAS认证、OAuth2.0、SAML认证、自定义。故根据不同协议，该类型按钮会有所不同。

说明：

CAS认证：PC端认证、移动端认证、PC&移动端认证；

OAuth2认证：PC端认证、移动端认证、PC&移动端认证；

SAML认证：PC端认证、移动端认证、PC&移动端认证；

Webseal认证：PC端认证；

网关认证：PC端认证；

其他认证方式（域单点）：PC端认证；

其他认证方式（自定义）：PC端认证、移动端认证、PC&移动端认证。

**a. PC端认证**

点击PC端认证后，新建页面仅显示PC端配置，配置完成点击保存后，PC端认证开启，移动端认证为关闭状态。

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

说明：

使用PC端认证方式：点击后，移动端认证则为关联PC端认证方式，配置只读，同PC端认证配置同步修改。

使用其他认证方式：点击进入 切换认证方式 弹窗，可选择其他协议进行配置。

**b. 移动端认证**

点击移动端认证后，新建页面仅显示移动端认证配置，配置完成点击保存后，移动端认证开启，PC端认证为关闭状态。

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

配置完成后，PC端认证显示关闭状态：

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

说明：

使用移动端认证方式：点击后，PC端认证则为关联移动端认证方式，以PC端的配置为主，移动端配置只读，同PC端认证配置同步修改。

使用其他认证方式：点击进入 切换认证方式 弹窗，可选择其他协议进行配置。

 

3.

PC&移动端认证

点击PC&移动端认证后，新建页面显示PC&移动端认证配置，配置完成点击保存后，PC端认证、移动端认证均开启，且移动端认证配置为只读状态，修改PC端认证相关配置时，移动端认证配置同步修改

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959336253759516&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=1167959310628208707&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=1167959284722540637&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）启用按钮说明

启用按钮默认开启，开启后，需绑定自定义登录地址，才可进行认证登录。

PC端认证：需要在【界面配置中心】-【登录页设置】-【PC端登录页】中配置并启用一个已绑定域名的登录页。

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

将启用按钮关闭点击保存后，进入PC/移动认证关闭的页面；若PC端认证、移动端认证均关闭，则回到协议面板页面（仅认证接入支持，多地址的PC、移动均显示关闭状态）。

 

### （3）登录语言（10.0.2503.01基线开始支持）

认证接入管理、多地址认证接入页面增加配置项：“登录语言”，默认是关闭的。

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

登录语言按钮关闭时，认证登录系统时，根据用户的默认语言登录系统，用户若需要更改语言，可自行在语言设置中切换语言。

登录语言按钮开启时，认证登录系统时，认证接入则获取当前浏览器的多语言请求头（accept-language属性），传递给多语言模块提供的方法，转换成OA的多语言类型，调用passport登录时设置对应的多语言类型，用户登录完成后，系统将切换与浏览器语言一致的语言。

#### a. 认证登录成功系统语言跟随浏览器语言

认证登录成功时，最终构造会话时会将获取到的浏览器语言参数值传递给passport接口，实现用户是以浏览器语言登录系统效果。

配置示例如下：

开启登录语言按钮，配置CAS集成接入第三方认证服务。

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

保存成功后，前往浏览器访问回调地址进行认证登录。

当前浏览器语言设置的首选语言是“英语（美国）”，认证登录时，请求头中的语言参数accept-language:en-GB，跳转认证登录页面。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959331918495855&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系统是以“英语”登录成功。

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

此时，查看认证接入日志，可查看到调用passport接口时，传递了"langtype":"en_US"语言参数。

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

 

#### b. 认证登录登录前提示页面跟随浏览器语言

因登录前无用户信息，无法获取用户的语言，故本次需求优化支持了登录前跟随浏览器语言功能，此功能不受页面配置的“登录按钮”影响。

浏览器设置首选语言为“英语（英国）”时，认证登录跳转提示页面时，提示信息及按钮均显示为英文：

 ![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959267450396733&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=1167959340659425473&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、E10系统可支持的语言类型是比较有限的，没有浏览器语言丰富，当浏览器的首选语言设置的比较小众时，会出现匹配不上的情况，则认证登录和提示页面仍会以默认语言(即语言管理中排序最前面的已开启的语言）登录或提示；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959344845340775&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、当浏览器语言与E10系统语言匹配成功，但E10系统语言是禁用状态时，认证登录和提示页面仍会以默认语言登录或提示。如：浏览器语言设置的是“英语”，但是E10系统的English（英语）是禁用状态，那么认证登录成功会按照默认语言 简体中文 登录，登录后页面仍为简体中文。

### （4）回调地址

#### a. 后端回调地址

10.0.2407.01之前版本，均使用的是后端回调地址。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959263400345660&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地址/papi/iaauthclient/bs/协议类型/login?tk=租户key加密值。协议类型说明：

cas：CAS集成

oauth：OAuth2集成通用及所有套件

saml：SMAL集成

webseal：WebSEAL集成

custom：网关集成、自定义

ldap：域单点

 

#### b. 前端回调地址

10.0.2407.01及之后版本支持。

由于后端回调地址无法识别OA是否已登录，故每次访问都会进行一次认证登录，会影响一定的性能。故除SAML协议外，其他认证协议均增加了前端回调地址方式，可支持在OA已登录的情况下，直接重定向到OA登录后页面，避免重复进行认证登录影响性能。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959319040335973&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地址/build/intauthclient/verify/index.html?tk=租户key加密值&authurl=协议类型

authurl值说明：

cas：CAS集成

oauth2：OAuth2集成通用及所有套件

saml：SMAL集成

webseal：WebSEAL集成

custom：网关集成、自定义

ldap：域单点

reauth参数说明

**10.0.2503.01** 基线开始，前端回调地址增加了 reauth=1 参数，将该参数拼接在回调地址之后，前端地址也可支持每次都进行授权登录。

配置示例：

https://weapp.mulinquan.cn/build/intauthclient/verify/index.html?tk=6e061bbb052f039e82544935c687fe93&authurl=oauth2&**reauth=1**

 注：

SAML集成业务逻辑暂时无法适配前端回调地址，但是如果要实现判断E10会话效果，可在第三方系统跳转E10的入口处，配置前端回调地址（OA地址/build/intauthclient/verify/index.html?tk=租户key加密值&authurl=saml），可实现判断会话效果，但实际登录校验的还是后端回调地址；

若传了其他值均为非法值，若拼接了会提示“当前传递的认证协议类型路由参数(authurl)非法!请确保传递正确的认证协议类型路由参数后重试”；

若历史保存过认证接入配置，那么回调地址继续保留的是后端回调地址，如果需要切换成前端回调地址，可通过保存下SAML集成配置，再切换回需要的认证方式，即可实现切换。切换后，需要提供新的回调地址给第三方认证服务，修改应用里注册的回调地址，重新保存相关认证接入配置生效；

因后端回调地址后期将不再维护，若客户基线版本已经支持前端回调地址，建议所有回调地址均切换到前端回调地址方式，请知悉~

 

### （5）账号规则

账号规则需根据第三方CAS服务认证返回的默认人员信息与对应E10人员哪个字段值能够匹配成功，则配置哪个规则。

目前统一认证接入的账号规则可支持手机号码、电子邮箱、登录名、工号。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959327798042667&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=1167959340523446281&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=1167959310628208688&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=1167959314711388277&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=1167959267695312918&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.

账号规则为登录名/工号时，需确认账号安全-安全设置-基础设置-登录设置-账号支持方式是否 开启了登录名/工号 ，若未开启则不生效。

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

若是开启了全资源拦截，账号规则需要使用登录名或工号时，需先在主团队【基础设置】-【系统级设置】-【登录类】-【集成登录设置】处，开启 **获取租户列表权限** 项。

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

E10账号规则暂不支持自定义SQL，如需要获取其他属性，请提交需求评估流程定制支持 或 自行开发自定义认证方式支持，自定义认证请参考：《E10统一认证接入-自定义接口开发案例》：

[https://www.e-cology.com.cn/sp/doc/docDetail/1042252635838701662](https://www.e-cology.com.cn/sp/doc/docDetail/1042252635838701662)

 

## 3、CAS认证方式

CAS认证方式目前仅支持接入CAS2.0协议认证服务，基于**cas-client-core-3.2.1.jar**** ** 集成，配置前，需要与第三方CAS服务确认下，对方认证服务需支持该版本jar再进行配置即可。

选择CAS集成类型、认证类型后，进入CAS集成配置页面，根据第三方认证服务提供的相关接口进行配置。

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

**配置说明：**

**协议基本信息** ：只读显示回调地址，若第三方CAS服务需要注册E10地址，则点击右侧的复制按钮即可复制当前回调地址，回调地址配置说明可参考 _回调地址_ ；

**切换按钮** ：若需切换协议类型，可点击切换按钮进入切换认证方式页面，选择其他协议类型即可；

**认证服务参数** ：配置第三方CAS服务提供的服务地址、登录地址、退出地址；

**其它参数** ：账号规则默认是手机号码，详细配置说明参考 _账号规则_ ；

**认证排除策略** ：判断浏览器User Agent是否包含设置的认证排除特征类型，若包含，则不走认证。

例如：功能开启时，设置认证排除特征类型为Chrome， 则在Chrome浏览器中访问E10时，是不会走认证的，而此时在IE浏览器中访问则是需要走认证的。

 

## 4、OAuth2认证方式

OAuth2认证方式可支持通用方式，以及微软AAD集成、微软AAD_JWT集成、竹云认证集成、派拉集成、蓝信集成、吉大正元集成、keycloak集成等套件。

通用方式中所有配置均为空，均可支持自定义配置。其他套件方式中均已根据对应第三方认证服务接口内置了相关参数，如需调整亦可手动调整相关配置。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959319159423032&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） OAuth2.0集成通用方式

选择协议类型为OAuth2.0集成通用方式、认证类型后，进入详细配置页面。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959263298035753&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）基本信息：

应用标识、应用密钥：统一认证平台提供。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959340573892702&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）请求用户授权接口：根据统一认证平台提供的接口进行配置接口地址、请求方式、取值字段、接口所需参数。

其中，取值字段是设置授权接口返回的授权码参数名称。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959327671787573&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）获取授权Token接口：根据统一认证平台提供的接口进行配置接口地址、请求方式、解析格式、获取令牌字段、刷新令牌字段、接口所需参数。

其中，

解析格式可支持返回数据为JSON、文本、XML格式的数据；

获取令牌字段是设置token接口中返回授权token令牌的参数名称；

刷新令牌字段是设置token接口中返回的刷新token令牌的参数名称，不使用刷新token接口时，无需配置。

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

 

4）刷新Token接口：默认关闭。根据统一认证平台提供的接口进行配置接口地址、请求方式、解析格式、获取令牌字段、刷新令牌字段、刷新时间及接口所需参数。

其中，

获取令牌字段配置刷新token接口返回数据中新获取的授权token令牌的参数名称；

刷新令牌字段配置刷新token接口返回数据中新获取的刷新token令牌的参数名称；

刷新时间可根据实际需求进行配置，但需注意，可输入的范围值是900s~86400s，即15分钟~1天。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959271971741750&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接口，其中，需注意：

务必确保【后台管理中心】-【全局基础】-【插件管理】插件列表中存在“OAuth2集成支持刷新token”插件，且为启用状态。

若没有，可新建一下插件配置：

模块：intunifyauthclient

描述：OAuth2集成支持刷新token

仓库名：@weapp/integration

组件名：RefreshTokenPlugin

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

 

5）校验Token接口：默认关闭。根据统一认证平台提供的接口进行配置接口地址、请求方式、解析格式、取值字段、校验值及接口所需参数。

其中，取值字段是获取校验Token接口返回的进行校验的字段名称；校验值是需要进行校验的取值，可自定义输入，也支持选择系统默认的参数属性。

校验逻辑：

在调用统一退出接口时，获取取值字段的值，与校验值进行对比，匹配成功则说明token有效，匹配失败则说明token无效。

注：目前校验Token接口仅在调用统一退出前进行校验，其他场景暂不支持。

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

 

6）获取用户信息接口：根据统一认证平台提供的接口进行配置接口地址、请求方式、账号规则、取值字段、接口所需参数。

其中，取值字段是设置用户信息接口返回的人员参数字段，与账号规则选择的字段对应。

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

 

7）统一退出接口：根据统一认证平台提供的接口进行配置接口地址、请求方式、接口所需参数。

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

8）检测心跳接口：根据统一认证平台提供的接口进行配置接口地址、请求方式、心跳正常标记、接口所需参数。其中，心跳正常标记：配置心跳接口正常返回的结果。开启后，会先调用心跳接口，将在接口返回值中检索，若包含心跳正常标记内容，则进行认证登录，匹配不上则跳转OA自己的登录页面。

心跳失败跳转地址：用于检测心跳接口异常时，支持自定义异常跳转的页面地址。非必填，不配置时，默认会跳转到OA自己的登录页面，若配置了，则跳转配置的页面。（10.0.2501.01基线开始支持）

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

 

9)参数设置：请问用户授权接口、获取授权Token接口、刷新Token接口、校验Token接口、获取用户信息接口、统一退出接口、检测心跳接口，这些接口都可以配置参数设置，根据提供的实际接口所需参数进行配置。

其中，请求头参数支持Base64编码。

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

请求头-内容，请求参数-参数值支持选择浏览框数据以及手动输入。

浏览框支持选择：

${client_id}：获取基本信息中配置的应用标识

${client_secret}：获取基本信息中配置的应用密钥

${redirect_uri}：获取E10回调地址

${code}：获取授权接口返回的授权码

${access_token}：获取Token接口返回的token

${timestamp}：获取当前系统时间，精确到毫秒

${short_timestamp}：获取当前系统时间，精确到秒

${date}：获取当前日期，格式yyyy-MM-dd

${time}：获取当前时间，格式HH:mm:ss

${dateandtime}：获取当前日期时间，格式yyyy-MM-dd HH:mm:ss

${state}：获取8位随机字符串

${state_security}：获取8位随机字符串，并对认证客户端IP做授权回调安全校验

${refresh_token}：获取token接口返回的刷新令牌

${app_token}：获取蓝信应用Token接口返回的token（仅蓝信集成套件可使用）

${user_token}：获取蓝信用户Token接口返回的token（仅蓝信集成套件可使用）

${paasId}：获取基本信息中竹云网关集成应用标识（仅竹云认证集成套件可使用）

${paasToken}：获取基本信息中竹云网关集成应用密钥（仅竹云认证集成套件可使用）

${x_tif_signature}：获取竹云网关计算签名时间戳，精确到毫秒（仅竹云网关认证套件可使用）

${x_tif_nonce}：获取竹云网关计算签名随机字符串（仅竹云网关认证套件可使用）

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959280368427091&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） 微软AAD集成

选择协议类型为微软AAD集成方式、认证类型后，进入详细配置页面。

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

微软AAD集成是OAuth2集成认证方式的一种，是依据[ _《微软统一身份认证对接接口文档》_](https://eteams.cn/help/1964722186459079107) 进行对接，已经提供默认的接口以及参数设置配置。

实际接入的时候，需要调整：

①基本信息：AAD上面注册E10回调地址，提供应用标识以及应用密钥

②请求用户授权接口：只需调整接口地址

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959276115402799&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接口：只需调整接口地址

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

④请求用户信息接口：需要调整接口地址，AAD上面的人员接口是需要开放权限的，需要咨询下微软。

人员接口中默认是AAD返回人员属性的mail属性 对应E10中人员的电子邮箱。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959267668385893&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=1167959297699602566&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）微软AAD_JWT集成

选择协议类型为微软AAD_JWT集成方式、认证类型后，进入详细配置页:

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

微软AAD_JWT集成是OAuth2集成认证方式的一种，是依据[ _《微软ADD_JWT统一身份认证对接接口文档》_](https://eteams.cn/help/1966959911073734494) 进行对接，已经提供默认的接口以及参数设置配置，微软AAD的租户id、应用id、应用密钥，需在微软AAD后台注册。

微软AAD_JWT集成是对微软AAD集成的一个扩展，微软AAD集成要求必须在微软AAD后台开放租户的User或User.ALL权限，否则当前租户无调用用户信息接口，而JWT方式不需要开放上述权限权限，仅需勾选openID的email权限即可根据JWT令牌解析得到用户信息，从而实现认证登录。

实际接入的时候，需要调整：

①基本信息：AAD上面注册E10回调地址，提供应用标识以及应用密钥

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

③获取JWT令牌接口：只需调整接口地址

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

④JWT令牌解析设置：无需调整配置。

解析JWT令牌可不配置人员权限，开放OpenID的email权限即可。若想了解更多AAD的权限如何使用，需要咨询下微软。

默认是JWT解析返回结果中的email属性 对应E10中人员的电子邮箱。

E10可支持手机号码、工号、电子邮箱与第三方匹配，可根据实际需求配置。

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

 

### （4）竹云认证集成

选择协议类型为竹云认证集成方式、认证类型后，进入详细配置页:

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

竹云认证集成是OAuth2集成认证方式的一种，是依据[ _《竹云统一身份认证对接接口文档》_](https://eteams.cn/help/1964722188793979108) 进行对接，已经提供默认的接口以及参数设置配置。

实际接入的时候，需要调整：

①基本信息：竹云上面注册E10回调地址，提供应用标识以及应用密钥

②请求用户授权接口：只需调整接口地址

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959276115828836&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接口：只需要跳转接口地址

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

④请求用户信息接口：需要调整人员接口地址

人员接口中默认是返回人员属性的mobile属性 对应E10中人员的手机号码，可根据实际需要进行调整。

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

 

### （5）派拉集成

选择协议类型为派拉集成方式、认证类型后，进入详细配置页:

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

派拉集成是OAuth2集成认证方式的一种，是依据[ _《派拉统一身份认证对接接口文档》_](https://eteams.cn/help/1964722191208279109) 进行对接，已经提供默认的接口以及参数设置配置。

实际接入的时候，需要调整：

①基本信息：派拉上面注册E10回调地址，提供应用标识以及应用密钥。 appkey也是派拉提供。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959314711388173&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=1167959323485872135&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接口：只需要调整token接口地址

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

④请求用户信息接口：需要调整人员接口地址

人员接口中默认是返回人员属性的mobile属性 对应E10中人员的手机号码，可根据实际需要进行调整。

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

 

### （6）蓝信集成

选择协议类型为蓝信集成方式、认证类型后，进入详细配置页:

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

蓝信集成是OAuth2集成认证方式的一种，是依据[ _《蓝信统一身份认证对接接口文档》_](https://eteams.cn/help/1966959895519234493) 进行对接，已经提供默认的接口以及参数设置配置。

实际接入的时候，需要调整：

①基本信息：蓝信上面注册E10回调地址，提供应用标识以及应用密钥。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959289017507956&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=1167959280461127723&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接口：只需要调整接口地址

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959267517079610&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接口：只需要调整接口地址

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

⑤获取用户信息接口：需要调整接口地址

人员接口中默认是返回人员属性的data.loginName属性 对应E10中人员的手机号码，可根据实际需要进行调整。

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

 

### （7）吉大正元集成（10.0.2310.02基线版本开始支持）

选择协议类型为吉大正元集成方式、认证类型后，进入详细配置页:

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

吉大正元集成是OAuth2集成认证方式的一种，是依据[ _《吉大正元统一身份认证对接接口文档》_](https://eteams.cn/help/1969508637082343864) 进行对接，已经提供默认的接口以及参数设置配置。

实际接入的时候，需要调整：

①基本信息：吉大正元上面注册E10回调地址，提供应用标识以及应用密钥

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959258962772043&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=1167959302003073109&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接口：只需要跳转接口地址

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

④请求用户信息接口：需要调整人员接口地址

人员接口中默认是返回人员属性的usercode属性 对应E10中人员的手机号码，可根据实际需要进行调整。

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

 

### （8） keycloak集成（10.0.2310.02基线版本开始支持）

选择协议类型为keycloak集成方式、认证类型后，进入详细配置页:

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

keycloak集成是OAuth2集成认证方式的一种，是依据[ _《keycloak集成统一身份认证对接接口文档》_](https://eteams.cn/help/1969508639391143866) 进行对接，已经提供默认的接口以及参数设置配置。

实际接入的时候，需要调整：

①基本信息：keycloak上面注册E10回调地址，提供应用标识以及应用密钥

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959340659425486&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=1167959276115828890&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接口：只需要跳转接口地址

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959284722540620&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接口：需要调整刷新Token接口地址

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

⑤请求用户信息接口：需要调整人员接口地址

人员接口中默认是返回人员属性的email属性 对应E10中人员的电子邮箱，可根据实际需要进行调整。

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

### （9） 深信服集成（10.0.2412.01基线版本开始支持）

选择协议类型为深信服集成、认证类型后，进入详细配置页面：

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

详细功能说明请参考《【25766】统一认证接入管理：支持深信服零信任集成套件》：

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

 

## 5、SAML认证方式

选择协议类型为SAML集成方式、认证类型后，进入详细配置页:

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

①SAML集成配置前提

adfs服务需要提供IDP元数据文件，若有证书可提供证书文件以及证书文件所需密码

看adfs服务要求，是否需要SP（E10系统）必须https，若有要求，则E10系统需部署https

需维护adfs服务中的人员与E10系统中人员的对应关系

 

②SAML集成页面配置说明

**配置项**| **配置说明**  
---|---  
**Entity ID**|  默认带出。若没有特殊要求，无需做修改。  
**IDP元数据文件**|  上传adfs服务提供的IDP元数据文件  
**自动生成自签名证书**|  若adfs服务提供了证书文件，则关闭，上传签名证书；若adfs服务未提供证书文件，则可开启，使用自签证书  
**签名证书**|  上传adfs服务提供的证书文件  
**证书密码**|  若上传签名证书，则为签名证书对应的密码；若使用自签证书，则自行设置自签证书的密码  
**签名算法**|  默认SHA-1；可选SHA-1、SHA-256；签名算法需要告知adfs服务  
**组织名称、组织网址、联系邮箱地址**|  必填；生成SP元数据文件时需要；自行设置，主要是告知adfs服务这边交互的SP（E10系统）的组织信息  
**账号规则**|  设置从adfs服务获取的用户信息与E10系统人员的对应关系；可选手机号码、工号、电子邮箱；若选择“电子邮箱”，则将获取的用户信息直接与E10的人员邮箱进行匹配；若选择“手机号码”，则将获取的用户信息，截取@符号前面的内容 与E10的人员手机号码进行匹配；若选择“工号”，则将获取的用户信息，截取@符号前面的内容 与E10的人员工号进行匹配。  
  
SAML集成页面按钮说明：

**按钮名称**| **说明**  
---|---  
**保存**|  保存SAML集成页面信息，并生成SP元数据文件；点击【保存】会校验配置项必填项，会提示“此项必填”；点击【保存】会校验配置项（Entity ID、IDP元数据文件、自动生成自签名证书、签名证书、证书密码、签名算法、组织名称、组织网址、联系邮箱地址）因调整数据需重新生成SP元数据文件，会有确认提示“是否需要更新SP元数据文件，若进行更新，需重新下载SP元数据文件给到IDP进行导入”；点击【保存】会校验证书文件是否能够解析，会提示“证书识别不出”，需检查adfs提供的证书文件以及证书密码是否正确  
**下载SP元数据文件**|  保存SAML集成信息生成SP元数据文件之后显示；点击【下载SP元数据文件】可下载SP元数据文件，将此文件以及设置的签名算法提供给adfs服务进行导入;点击【下载SP元数据文件】若页面信息有调整但未保存，会提示“列表数据修改，请重新保存后再下载”。  
  
 

③adfs服务导入SP元数据文件

SAML集成配置保存后，会生成SP元数据文件，可通过【下载SP元数据文件】下载此文件，将文件以及设置的签名算法提供给adfs服务，adfs服务方需要进行配置。

## 6、WebSEAL认证方式（只支持私有）

选择协议类型为WebSEAL集成方式、认证类型后，进入详细配置页:

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959306188562482&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）WebSEAL参数

①获取参数方法

可支持请求头、请求参数两种方式。

**说明：**

获取参数方法为**请求头** 时，请求头中包含参数名称属性，可直接访问个性化地址或直接访问回调地址进行单点登录；

获取参数方法为**请求参数** 时，将参数名称拼接到回调地址后进行单点登录。

注：请求头/请求参数的参数值为中文需要进行encode编码。

 

②参数名称

根据WebSEAL服务提供的参数进行配置。

**说明：**

参数名称默认值为：iv-user。

注：参数名称不能为中文或特殊字符（ - 除外）。

 

2）其他参数

账号规则：可支持手机号码、工号、电子邮箱三种转换规则。

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

使用说明：

根据参数名称获取到的信息与系统中人员进行对应。例如：通过参数名称获取到的值对应人员的工号，则账号规则就选择工号。

 

 

## 7、网关认证集成认证方式（只支持私有）

### （1） 格尔网关集成

选择协议类型为格尔网关集成方式、认证类型后，进入详细配置页:

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959332067729421&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）集成参数

①获取参数方法

可支持请求头、请求参数、Cookie三种方式。

**说明：**

获取参数方法为**请求头** 时，请求头中包含参数名称属性，可直接访问个性化地址或直接访问回调地址进行单点登录；

获取参数方法为**请求参数** 时，将参数名称拼接到回调地址后进行单点登录；

获取参数方法为**Cookie** 时，将参数名称及参数值注入到Cookie中，可直接访问个性化地址或回调地址进行单点登录。

注：参数值为中文需要进行encode编码，且需要勾选 需要URL解码。

 

②参数名称

根据网关服务提供的参数进行配置。

需要URL解码：勾选后，获取参数值后会对其进行url解码处理，不勾选，则不处理。

**说明：**

参数名称默认值为：KOAL-CERT-E。

注：参数名称不能为中文或特殊字符（ - 、_除外）,当请求方式为请求头时，只能使用中划线-。

 

③编码格式

主要是针对中文的编码格式，默认UTF-8，也可支持选择GBK格式。

 

2）其他参数

账号规则：可支持手机号码、工号、电子邮箱三种转换规则。

使用说明：

根据参数名称获取到的信息与系统中人员进行对应。例如：通过参数名称获取到的值对应人员的工号，则账号规则就选择工号。

### （2）竹云网关集成

 

选择协议类型为竹云网关集成方式、认证类型后，进入详细配置页:

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959271971856433&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）基本信息

应用标识：竹云网关服务上注册E10应用分配的应用标识；

应用密钥：竹云网关服务上注册E10应用分配的应用密钥。

 

2）集成参数

①获取参数方法

可支持请求头、请求参数、Cookie三种方式。

**说明：**

获取参数方法为**请求头** 时，请求头中包含参数名称属性，可直接访问个性化地址或直接访问回调地址进行单点登录；

获取参数方法为**请求参数** 时，将参数名称拼接到回调地址后进行单点登录；

获取参数方法为**Cookie** 时，将参数名称及参数值注入到Cookie中，可直接访问个性化地址或回调地址进行单点登录。

注：参数值为中文需要进行encode编码，且需要勾选 需要URL解码。

 

②参数名称

根据网关服务提供的参数进行配置。

需要URL解码：勾选后，获取参数值后会对其进行url解码处理，不勾选，则不处理。

**说明：**

参数名称默认值为：x-tif-uid。

注：参数名称不能为中文或特殊字符（ - 、_除外）,当请求方式为请求头时，只能使用中划线-。

 

③启用鉴权

若开启鉴权，则会对鉴权参数：随机数（x-tif-nonce）、时间戳（x-tif-timestamp）、签名（x-tif-signature）的有效性进行校验，时间戳不可超过当前时间180s，超时即鉴权失败，阻止认证。

若未开启鉴权，则不会校验鉴权参数，仅校验参数名称信息即可。、

 

3）其他参数

账号规则：可支持手机号码、工号、电子邮箱三种转换规则。

使用说明：

根据参数名称获取到的信息与系统中人员进行对应。例如：通过参数名称获取到的值对应人员的工号，则账号规则就选择工号。

 

4）统一退出接口

竹云网关服务可支持统一退出接口，套件初始化参数可根据实际进行配置。

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

 

 

## 8、其他认证方式（只支持私有）

### （1）自定义（只支持私有化）

功能描述：

统一认证接入管理-自定义认证新增PC端认证、移动端认证启用开关，当启用自定义认证时，PC端认证和移动端认证需确保至少有一个是启用状态才能保存；

     **PC端认证** ：启用后web浏览器访问回调地址或PC端个性化地址时走自定义实现类内部逻辑，跳转至对应认证登录页进行认证登录，PC客户端服务器地址需配置PC端个性化地址；（需要在【界面配置中心】-【登录页设置】-【PC端登录页】中配置并启用一个已绑定域名的登录页才能正常认证登录，若未配置，认证登录后会拦截到提示页。）

     **移动端认证** ：启用后移动端服务器地址配置移动端个性化地址，登录时会走自定义实现类内部逻辑，跳转至对应认证登录页进行认证登录；（需要在【界面配置中心】-【登录页设置】-【移动端设计】中配置并启用一个已绑定域名的登录页才能正常认证登录，若未配置，认证登录后会拦截到提示页。）

 

启用开启后，选择自定义集成方式，显示自定义配置项：

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

**启用**|  启用自定义认证时需确保PC端认证或移动端认证至少有一种是开启状态才可以保存。  
---|---  
**PC端认证**|  启用自定义认证时默认开启，可根据需求自行选择启用或关闭  
**移动端认证**|  启用自定义认证时默认关闭，可根据需求自行选择启用或关闭  
**自定义实现类**|  实现类是自定义接口实现的类路径，比如：com.weaver.intunifyauth.client.custom.service.impl.xxxxxxxx，且需要保证该类已存在；实现类需要根据小提示里面的《接口自定义开发文档》进行开发。  
  
** **

接口自定义开发手册：

统 一 认 证 接 入 - 接 口 自 定 义 开 发 手 册 . p d f

 

## 9、多地址认证接入（10.0.2408.01基线版本开始支持，只支持私有）

**10.0.2408.01及之后版本支持。且仅支持私有化部署，云端环境无多地址。**

###  （1）权限说明

权限入口：后端管理中心->权限管理中心->角色设置->功能权限

权限项：集成中心->统一认证接入管理->认证接入多地址管理->查看、删除、保存

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959276176195751&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）多地址列表页面

列表无数据时，显示暂无数据：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959263364718628&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地址值、PC端认证是否开启、移动端认证是否开启显示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959301952315465&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、点击oa地址可进入编辑多认证地址配置页面

2、若PC端认证/移动端认证未开启时，则显示禁用。

### （3）新建多地址配置

点击新建按钮，进入协议面板页面，可选择认证方式进行配置。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959332067729478&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地址】配置项，可根据实际业务需求配置需要的oa地址。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959297667809299&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地址后，会动态联动将域名拼接在对应的回调地址上，此时即可复制当前回调地址提供到第三方配置。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959344845340676&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地址** ：需要以http/https协议开头，且必须是有效的OA系统地址，可以访问到OA系统任意咨询才可实现业务效果。

 

### （4）编辑多地址配置

入口：点击多地址列表的oa地址，或点击行菜单的编辑按钮可进入编辑多地址配置页面

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167959332051066961&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、点击页面左上角的返回按钮可回到多地址列表页面；

2、修改oa地址时，无论PC端、移动端是否关联，均是同步修改，请谨慎修改。

如果PC、APP需要使用不同的OA地址，请配置两条多地址配置，PC的OA访问地址仅启用PC端认证、移动端的OA访问地址仅启用移动端认证即可。

 

 

 

 

## 10、全资源拦截以及个性化地址拦截

### （1）全资源拦截以及个性化地址拦截说明

**全资源拦截：** 开启认证集成后，访问系统任一资源都将会被拦截到认证系统进行认证登陆。**（仅支持主团队配置，其他团队无该配置项）**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167963820325445685&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=1167963884592218119&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）若全资源拦截后，OA这边若需要单独登录，可在地址后面增加intunifyauth_client=freepass参数，比如：**

[** _http://10.12.106.131/login?intunifyauth_client=freepass_**](http://10.12.106.131/login?intunifyauth_client=freepass)

主管理团队中统一认证接入管理配置显示“全资源拦截”配置项，其他团队不显示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167964296974540850&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）若账号规则是登录名/工号，开启全资源拦截时，需先在主团队后台管理中心【基本设置】-【系统级设置】-【登录类】-【集成登录设置】处，开启获取租户列表权限，否则无法保存。**

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

**个性化地址拦截：** 不开启全资源拦截情况下，开启认证集成后，只有访问系统的个性化地址才会被拦截到认证系统进行认证登陆。

个性化地址配置入口：

界面配置中心-登录页设置，绑定访问域名-自定义登陆地址

需设置自定义登陆地址， 访问自定义登陆地址才可以被拦截跳转到认证服务。

开启PC端认证时，需要在【界面配置中心】-【登录页设置】-【PC端登录页】中配置并启用一个已绑定域名的登录页：

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

 

**独立域名拦截：****若配置独立域名，仅访问该域名地址方式时会走认证登录逻辑。**

**需要配置独立域名支持跳转认证：（独立域名配置，不需要加协议，配置后需要l联系销售审核通过才可使用）**

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

**注：前提需要在****10.0.2310.01****基线版本后，主团队中，基本设置-系统级设置-登录类-集成登录设置处，启用“集成登录支持自定义域名”按钮才可生效。**

**（若还没有这个开关项，可咨询下李孟川）**

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

认证接入管理、多地址认证接入请不要同时配置，若要使用多地址请将认证接入管理配置关闭；若是仅使用认证接入管理，请将多地址列表配置清空。

2.

通过统一认证接入认证登录之后，人员是不可切换团队以及新建团队的。

**注：10.0.2310.01基线版本后，通过统一认证接入认证登录后，允许切换团队以及新建团队。**
