# 集成登录-上上签套件

来源快照：`result_data_new_260518.json`

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

## 正文

# **一、功能介绍**

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

10.0.2510.01基线版本开始，集成登录支持上上签套件，基于上上签提供的插件方式进行集成，以实现免登录访问上上签系统页面的功能。

**注：本文档仅针对单点登录上上签配置说明，电子签章与上上签集成配置说明请参考：****https://www.e-cology.com.cn/sp/doc/docDetail/1194308956268175390**

# **二、功能权限**

需要集成登录权限：

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

 

配置项| 说明  
---|---  
启用| 默认开启，控制此集成登录是否可用的开关  
名称| 任意  
套件类型| 上上签  
所属机构| 开启分权时显示  
外网地址| 上上签开放平台地址，请联系上上签系统获取  
应用标识(clientId)| 上上签应用标识，需联系上上签系统提供  
应用秘钥(clientSecret)| 上上签应用秘钥，需联系上上签系统提供  
签名私钥(privateKey)| 调用接口签名私钥，需联系上上签系统提供  
跳转页面(targetPage)| 跳转首页可配置home，若是其他页面，需联系上上签系统人员提供targetPage属性值。  
  
 

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

点击保存并进入详细设置：

自定义参数：默认参数account（单点账号）、password（单点密码）

ssqAccount：上上签账号默认为手机号，配置用户参数-手机号；

userType：用户类型默认为2，标识企业类型，若是个人类型账号，配置为1。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235609709866942468&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=1235609735565860867&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、共享范围

需要在共享范围内设置，哪些人员能够通过集成登录实现对上上签的单点登录。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235609752832188431&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、维护每个人的手机号

ssqAccount若设置用户参数-手机号，需要到人力卡片手机字段维护手机号，对应上上签系统人员的手机号。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235609778573426692&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=1235609812886233094&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=1235609838536024070&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=1235609855835906051&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=1235609868784517132&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=1235609885788225539&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=1235609903072157700&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、单点登录上上签首页

当targetPage配置为home时，用户单点登录会跳转到上上签系统首页。

点击集成登录元素或应用菜单地址，进行单点登录跳转。

当E10账号信息未与上上签账号绑定时，会跳转到账号绑定页面：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235609920117809156&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账号信息已与上上签账号绑定成功，单点登录会直接跳转到上上签首页：

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

单点登录成功。
