# 集成登录支持{?routeAddress}路由参数配置说明

来源快照：`result_data_new_260518.json`

- 来源 ID：`1175848259243769862`
- 模块：集成中心
- 目录：集成登录 - 后台维护 - 功能点说明
- space ID：`1158011075224911873`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 一、功能介绍

由于部分第三方客户的系统地址中是包含路由地址的，当进行单点登录（如token认证）时，需要将token参数拼接在路由参数前面，原来集成登录功能无法支持该配置，故优化提供路由参数{?routeAddress}，可将路由作为一个参数进行配置，以实现参数的拼接。

 

**注意：**

**1****、需要购买统一认证****-****集成登录功能。**

**2、【10.0.2311.02基线版本】开始支持路由参数{?routeAddress}，仅通用套件、ecology8/9(token认证)套件、帆软V11套件可支持路由参数。**

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

## 1、功能权限

需要有集成登录权限

路径：【后台管理中心】-【权限管理中心】-【角色设置】-【角色列表】-【功能权限】-【集成登录】

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234840992187342862&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、配置前提

第三方系统提供单点登录接口说明文档，最终单点登录页面需要使用路由参数进行拼接。

## 3、配置示例

### 3.1、场景描述

本示例以**ecology8/9(token****认证****)** 套件为例。

需要实现的场景：

E10调用E9获取token接口（http://xxx/ssologin/getToken?appid=xxxx&loginid=xxxx）获取到token值后，需将token值作为ssoToken参数拼接到含路由参数的最终单点登录地址（如：http://xxxx/wui/engine.html#/hrmengine/index?menuPathIds=10000&_key=l0fe2t）中，ssoToken=xxx参数需拼接在路由参数之前，路由参数之后需拼接菜单地址参数menuPathIds。

最终需要拼接的单点登录地址格式如下：

http://xxxx/wui/engine.html?ssoToken=xxxxxxxxxxx#/hrmengine/index?menuPathIds=10000&_key=l0fe2t

### 3.2、配置说明

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

在【后台管理中心】-【集成中心】-【集成登录】-【集成登录设置】，点击新建，选择e-cology8/9(token认证)套件快速创建，配置相关参数后进入集成登录设置/应用设置页面，可对最终单点登录地址进行相关设置。

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

**说明：路由参数{?routeAddress}与其他参数的位置可通过调整自定义参数的顺序进行调整。请根据实际需要进行配置即可。**

#### **3.2.2、从空白创建**

在【后台管理中心】-【集成中心】-【集成登录】-【集成登录设置】，点击新建，选择 从空白创建，套件类型选择 “e-cology8/9(token认证)”，会自动带出相关配置，其中外网地址以及自定义参数跟 “选择套件快速创建” 中参数一致，其他需要定义的参数可自行添加。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234841120952475654&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=1234841138152898573&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=1234841181097967617&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、单点登录效果

（1）若参数配置在路由参数{?routeAddress}上方，则最终单点登录地址中，参数会拼在路由参数之前，如下图：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234841198344945679&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=1234841219757277195&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）若参数配置在路由参数{?routeAddress}下方，则最终单点登录地址中，参数拼在路由参数之后，如下图：

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