# 集成登录-网易企业邮箱套件

来源快照：`result_data_new_260518.json`

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

## 正文

# 一、功能介绍

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

实现OA系统的单点登录功能，以便无缝接入网易企业邮箱。

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

**注意：****e10****支持两种网易企业邮箱套件****——****网易企业邮箱和网易企业邮箱****V1.9****。请根据客户现有的邮箱版本，选择相应的套件进行配置。**

##  1、网易企业邮箱操作

为了配置网易企业邮箱套件，需要网易企业邮箱提供相应的单点登录参数值。请注意，根据邮箱版本的不同，所需的参数值也会有所差异。

 

### 1.1、网易企业邮箱V1.9

根据网易企业邮箱的单点登录接口文档，需要提供**单点登录接口、单点登录辅助****token****接口、 企业邮箱域名、应用****ID****、应用授权码、企业****OpenId** 。

 

其中，**应用****ID****、应用授权码以及企业****OpenId** 的获取，需依照接口文档中关于开通集成接口的说明进行操作。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235495966213283856&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://api.qiye.163.com/**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235496004775714829&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://api.qiye.163.com/api/sso/ssoSign**

 

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235496039090110468&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://api.qiye.163.com/api/pub/token/ssoAuthToken**

 

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235496073492619268&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、网易企业邮箱

根据网易企业邮箱的单点登录接口文档，需要提供**企业邮箱域名和****RSA****私钥** 。

 

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

入口1：

【集成登录】-【集成登录设置】-【网易企业邮箱】

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235496125148839980&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=1235496150854934541&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中心】-【连接器】-【邮件服务】-【网易企业邮箱】-【套件】-【集成登录】-【网易企业邮箱】

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235496176516890627&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=1235496198189277188&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、网易企业邮箱V1.9套件

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

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

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235496215297425413&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接口**  
应用标识(appId)| 网易方提供的**应用ID**  
应用授权码(authCode)| 网易方提供的**应用授权码**  
企业开放标识(orgOpenId)| 网易方提供的**企业OpenId**  
邮箱域名(domain)| 网易方提供的**企业邮箱域名**  
获取单点链接地址(ssoUrl) | 网易方提供的获取**单点登录接口**  
  
点击保存并进入详细设置，默认了自定义参数accountName（邮箱账号名）：

accountName默认用户录入，需在用户录入设置页面设置网易企业邮箱的邮箱账号。

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

**注意：****accountName****参数的值应为邮箱格式的前缀。**

当配置用户参数为邮箱时，程序将自动解析并获取当前用户的邮箱前缀（即@符号之前的部分）。

若选择其他参数，例如用户参数-登录名，用户录入等，必须设置邮箱格式的前缀内容。

例如，若某人的网易邮箱账号为test1@cobiz.cn，则实际传递给accountName的值应为test1。因此，若在用户录入页面维护accountName，应确保其值为test1。 

#### 3.1.2、从空白创建

通过入口1，可直接从空白创建网易企业邮箱V1.9套件。

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

套件类型选择“网易企业邮箱V1.9”， 会自动带出腾讯相关配置， 其中外网地址以及自定义参数跟“ _选择套件快速创建_ ”中参数一致。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235496318358659077&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、网易企业邮箱套件

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

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

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235496348428419078&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://entryhz.qiye.163.com/domain/oa/Entry_](https://entryhz.qiye.163.com/domain/oa/Entry) （复制即可无需修改）  
邮箱域名(yxym)| 网易方提供的**企业邮箱域名**  
单点登录接口密钥(secret)| 网易方提供的**RSA私钥**  
  
点击保存并进入详细设置，默认了自定义参数account（单点登录接口账号）：

account默认用户录入，需在用户录入设置页面设置网易企业邮箱的邮箱账号。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235496391394869250&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**参数的值应为邮箱格式的前缀。**

当配置用户参数为邮箱时，程序将自动解析并获取当前用户的邮箱前缀（即@符号之前的部分）。

若选择其他参数，例如用户参数-登录名，用户录入等，必须设置邮箱格式的前缀内容。

例如，若某人的网易邮箱账号为test1@cobiz.cn，则实际传递给account的值应为test1。因此，若在用户录入页面维护account，应确保其值为test1。

#### 3.2.2、从空白创建

通过入口1，可直接从空白创建网易企业邮箱套件。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235496412940214273&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=1235496429935534081&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=1235496447103614985&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、用户录入

当自定义参数accountName或account被设置为用户录入时，首次进行单点登录操作将会进入参数页面进行密码维护：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235496468604444679&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=1235496490087669762&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=1235496507217207303&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=1235496528711393282&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=1235496563113074690&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.6、构建应用

按照实际需要选择是否配置。

【后端管理中心】-【应用管理】-【构建应用】

可配置菜单，菜单中集成登录可选择已配置的集成登录。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235496576079290372&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=1235496593149280272&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=1235496614804881415&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组织架构及人员同步至网易企业邮箱系统，EB邮箱集成组件可展示网易企业邮箱的未读邮件列表与未读邮件数量，关联集成登录单点登录标识之后，点击未读邮件以及门户导航栏图标可单点登录网易企业邮箱系统。

邮箱服务-网易企业邮箱套件帮助文档：

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