# 集成登录-阿里企业邮箱套件

来源快照：`result_data_new_260518.json`

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

## 正文

# 一、功能介绍

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

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

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

**注意：****e10****支持三种阿里企业邮箱套件****——****阿里企业邮箱、阿里企业邮箱****V1****和阿里企业邮箱****V2****。请根据客户现有的邮箱版本，选择相应的套件进行配置。**

##  1、阿里企业邮箱操作

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

 

### 1.1、阿里企业邮箱V2

根据阿里企业邮箱的[ _单点登录接口文档_](https://mailhelp.aliyun.com/openapi/index.html#/markdown/authorization.md) ，需要提供**应用的id/secret** 。

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

登录阿里企业邮箱，在“高级应用”-“API开放平台”中添加应用。在添加过程中，请确保勾选了“用户登录权限（User.Login.All）”。保存设置后，点击编辑应用，将能够查看到应用的ID和Secret。

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

需要先在阿里邮箱API开发平台添加应用，再根据**应用****ID****和应用****Secret** 进行配置。

登录阿里企业邮箱，在“高级应用”-“API开放平台”中添加应用，勾选所需要的API权限。保存设置后，点击编辑应用，将能够查看到应用的ID和Secret。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235559755127488519&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=1235559802132643842&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.3、阿里企业邮箱

需要向阿里邮箱方申请获取**appCode****以及****appSecret** 。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235559828031676419&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=1235560145873461252&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=1235560175937404930&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=1235560197491138564&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=1235560218811580427&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、阿里企业邮箱V2套件

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

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

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

**配置项**| **说明**  
---|---  
启用| 默认开启，控制此集成登录是否可用的开关  
名称| 任意  
套件类型| 阿里企业邮箱V2  
所属机构| 开启分权时显示  
应用ID(client_id)| 阿里邮箱方提供的**应用ID**  
应用Secret(client_secret)| 阿里邮箱方提供的**应用Secret**  
  
点击保存并进入详细设置，默认了外网地址以及自定义参数email（邮箱账号）、redirectUrl（重定向地址），其中：

外网地址：默认[https://alimail-cn.aliyuncs.com](https://alimail-cn.aliyuncs.com)

email邮箱账号默认用户参数-邮箱，若每个人都有邮箱是阿里企业邮箱，则无需改动。

redirectUrl为登录成功后的跳转URL域名，默认为阿里邮箱官方域名https://qiye.aliyun.com。如果配置了自定义的企业邮箱域名，可对该参数进行相应的调整。

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

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

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

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

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

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

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

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235560480796196869&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  
所属机构| 开启分权时显示  
应用ID(client_id)| 阿里邮箱方提供的**应用ID**  
应用Secret(client_secret)| 阿里邮箱方提供的**应用Secret**  
  
点击保存并进入详细设置，默认了外网地址以及自定义参数email（邮箱账号）、redirectUrl（重定向地址），其中：

外网地址：默认[https://alimail-cn.aliyuncs.com](https://alimail-cn.aliyuncs.com)

email邮箱账号默认用户参数-邮箱，若每个人都有邮箱是阿里企业邮箱，则无需改动。

redirectUrl为登录成功后的跳转URL域名，默认为阿里邮箱官方域名https://qiye.aliyun.com。如果配置了自定义的企业邮箱域名，可对该参数进行相应的调整。

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

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

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235560596906319874&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”， 会自动带出相关配置， 其中外网地址以及自定义参数跟“ _选择套件快速创建_ ”中参数一致。

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

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

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

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235560669808312349&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://mail.mxhichina.com/alimail（复制即可）  
阿里邮箱单点登录key(key)| 阿里邮箱方提供的**appCode**  
阿里邮箱单点登录secret(secret)| 阿里邮箱方提供的**appSecret**  
  
点击保存并进入详细设置，默认了自定义参数email（邮箱账号）：

email邮箱账号默认用户参数-邮箱，若每个人都有邮箱是阿里企业邮箱，则无需改动。

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

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

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

需要在共享范围内设置，哪些人员能够通过集成登录实现对阿里企业邮箱的单点登录。

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

email若设置用户参数-邮箱，需要到人力卡片邮箱字段维护正确的阿里企业邮箱。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235560798674108426&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=1235560858749534214&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=1235560884635574276&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=1235560901661048839&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.7、构建应用

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

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

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

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235560918810763269&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=1235560940379078659&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=1235561271132299267&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/1126499067782964276_](https://www.e-cology.com.cn/sp/doc/docDetail/1126499067782964276)
