# 内外网地址支持传递动态参数配置说明

来源快照：`result_data_new_260518.json`

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

## 正文

# 一、功能介绍

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

**【10.0.2408.01基线版本】开始** ，集成登录内外网地址支持动态参数传递，若第三方系统要求传递某个动态的内外网地址，则可通过单点登录地址拼接对应的参数实现动态传参效果。

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

## 1、功能权限

需要有集成登录权限

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

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234841524905066501&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、功能入口

入口：【后台管理中心】-【集成中心】-【集成登录】-【集成登录设置】

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

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234841550675697669&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.2、从空白创建**

点击新建，选择从空白创建

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

已根据第三方提供的接口说明文档完成集成登录配置。

### 3.2、配置示例

若需传递内外网地址动态参数int_loginUrl，则登录人员访问地址应该为：E10系统地址/集成登录单点登录地址&int_loginUrl=对应的参数值。

格式如下：

[ _http://xxx/sp/integration/loginSingle/freepass?appId=集成登录标识_** _& int_loginUrl=对应的内外网地址参数值_**](http://xxx/sp/integration/loginSingle?appId=集成登录标识&int_loginUrl=对应的参数值。)

#### 3.2.1、未启用内外网自动登录

未启用内外网自动登录， 此时只需配置外网地址：

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

当访问集成登录单点登录地址：

E10/sp/integration/loginSingle/freepass?appId=d1163727fb574cd29c1a412a14fa40bf

最终会跳到配置的外网地址：

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

当访问集成登录单点登录地址后面增加自定义的int_loginUrl参数，如：

E10/sp/integration/loginSingle/freepass?appId=d1163727fb574cd29c1a412a14fa40bf**& int_loginUrl=https%3A%2F%2Fwww.sina.com.cn**

则，最终会跳转到这个自定义的int_loginUrl参数地址：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234841649392009218&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、启用内外网自动登录

启用内外网自动登录，此时需要配置网段策略，以及内网地址、外网地址：

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

最终能够实现：

若终端在网络策略范围之内，则访问单点登录地址 最终跳转 内网地址； 

若终端在网络策略范围之外，则访问单点登录地址 最终跳转 外网地址。

**注意：若未设置网段策略，默认走外网地址。**

 

但若是在单点登录地址后面增加自定义的int_loginUrl参数，则可实现最终跳转到int_loginUrl参数地址。

# 三、更多信息

## 1、int_loginUrl参数地址如何进行url编码？

可使用在线url编码工具：[ _https://www.bejson.com/enc/urlencode/_](https://www.bejson.com/enc/urlencode/)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234842229153873935&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=1234841705189244933&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、单点登录地址拼接int_loginUrl参数地址单点失败，提示“请联系管理员，在【后台管理中心】->【系统管理】->【系统安全】->【安全防护设置】->【第三方系统地址】中将域名添加到白名单中。”

需要根据提示路径进去添加下第三方系统地址，添加后，刷新下页面，等待1~2分钟生效。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1234841726642700300&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地址进行添加。若需手动输入，请确保包含域名和端口，例如，对于地址  **[**_http://10.99.6.224:8899/index，必须添加设置_**](http://10.99.6.224:8899/index%EF%BC%8C%E5%BF%85%E9%A1%BB%E6%B7%BB%E5%8A%A0%E8%AE%BE%E7%BD%AE)**  10.99.6.224:8899**

若添加后，还是有提示， 可到【后台管理中心】->【系统管理】->【系统安全】->【安全审计日志】 中可查看实际拦截的domain ，将此地址加到 第三方系统地址中。 

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

另外可检查：nacos 文件：weaver-intexchange-web-service.properties  
1，如是组合、微服务，登录nacos管理平台，找到weaver-intexchange-web配置文件，在配置文件里搜索ssecurity_mq_topic，把配置中的ssecurity_mq_topic 删除掉。  
2，单体在服务器上E10安装目录  
/e10-server0/E10/webapps/ROOT/WEB-INF/classes/weaver/config/config-center/  
下找到 weaver-intexchange-web-service.properties文件，在配置文件里搜索ssecurity_mq_topic，把配置中的ssecurity_mq_topic 删除掉。  
3，修改配置后，重启服务生效。
