# 集成登录-CoreMail邮箱套件

来源快照：`result_data_new_260518.json`

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

## 正文

# 一、功能介绍

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

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

 

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

**注意：****e10****支持两种CoreMail邮箱套件****——****CoreMail邮箱和CoreMail邮箱****V2****，其中，****10.0.2511.01****基线开始支持CoreMail邮箱****V2****。请根据客户现有的邮箱版本，选择相应的套件进行配置。**

** **

##  1、CoreMail邮箱操作

### 1.1、CoreMail邮箱V2

根据CoreMail邮箱提供的restful接口进行对接，需要提供**应用标识、凭证密钥、单点登录地址** 。

 

下面是CoreMail邮箱提供的接口文档，可作为参考：

[ _https://www.e-cology.com.cn/sp/file/filePreview/1195776434997207078?pauuid=a8384e55df5f481193ffadd7b9cb395f_](https://www.e-cology.com.cn/sp/file/filePreview/1195776434997207078?pauuid=a8384e55df5f481193ffadd7b9cb395f)

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

 

为了配置CoreMail邮箱套件，需要预先在CoreMail邮箱系统中配置OA集成登录服务器的IP白名单。

 

#### 1.2.1、OA集成登录服务器IP

访问OA的运维平台，在升级中心——升级助手的服务版本中

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

 

搜索weaver-intlogin,

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

 

然后在系统维护中，搜索该合体服务所在的服务器ip

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235519738762420228&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.2、CoreMail邮箱添加IP白名单

在coremail邮箱系统的系统设置中，进入常用设置下的API设置，然后将从OA系统中查询到的所有集成登录服务的IP地址添加到IP设置。

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

配置新建集成登录CoreMail邮箱提供了两个功能相同的入口，推荐使用入口1：

入口1：

【集成登录】-【集成登录设置】-【CoreMail邮箱】

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

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235519833250873357&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=1235519859117555718&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、CoreMail邮箱V2

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

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

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

**配置项**| **说明**  
---|---  
启用| 默认开启，控制此集成登录是否可用的开关  
名称| 任意  
套件类型| CoreMail邮箱V2  
所属机构| 开启分权时显示  
外网地址| coremail邮箱服务地址**/apiws/v3/requestToken**  
应用标识(app_id)| 联系CoreMail邮箱提供  
凭证密钥(secret)| 联系CoreMail邮箱提供  
单点登录地址(redirect_url)| 联系CoreMail邮箱提供  
  
 

点击保存并进入详细设置，默认了自定义参数user_at_domain（用户邮箱账号）以及password（用户邮箱密码），其中：

user_at_domain默认用户参数-邮箱，若每个人都有邮箱是CoreMail邮箱，则无需改动。

password默认用户录入，需在用户录入设置页面设置人员的CoreMail邮箱密码。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1248510253953196034&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，可直接从空白创建CoreMail邮箱V2套件。

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

套件类型选择“CoreMail邮箱V2”， 会自动带出CoreMail邮箱相关配置， 其中自定义参数跟“ _选择套件快速创建_ ”中参数一致。

 

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

 

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

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

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

**配置项**| **说明**  
---|---  
启用| 默认开启，控制此集成登录是否可用的开关  
名称| 任意  
套件类型| CoreMail邮箱  
所属机构| 开启分权时显示  
外网地址| coremail邮箱服务地址/coremail/main.jsp  
邮件系统地址(address)| coremail邮箱服务器地址  
端口号(port)| coremail邮箱的socked端口(一般默认为6195，如有变更，请联系coremail邮箱获取)  
  
点击保存并进入详细设置，默认了自定义参数email（邮箱账号）以及password(密码)，其中：

email默认用户参数-邮箱，若每个人都有邮箱是CoreMail邮箱，则无需改动。

password默认用户录入，需在用户录入设置页面设置人员的CoreMail邮箱密码。

若设置固定值-为空则表示适用无密码方式单点。

 

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235520095155003403&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****系统****weaver-intlogin****服务所在应用服务器里面，能够****telnet****通邮件系统地址的端口号。** 比如，邮件系统地址配置 10.12.105.170 ，端口号配置6195， 则在OA应用服务器里面请求： telnet 10.12.105.170 6195  需要能够请求通。

 

**注：若****CoreMail****邮箱开启了二次验证，单点****CoreMail****邮箱时需要使用专用密码** ，直接使用普通密码会单点失败，提示单点失败，若未开启二次验证则直接使用普通密码。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235520121067413509&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，可直接从空白创建CoreMail邮箱套件。

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

套件类型选择“CoreMail邮箱”， 会自动带出CoreMail邮箱相关配置， 其中自定义参数跟“ _选择套件快速创建_ ”中参数一致。

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

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

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

email和user_at_domain若设置用户参数-邮箱，需要到人力卡片邮箱字段维护正确的CoreMail邮箱。

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

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

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

完成维护后，未来的单点登录将不再跳转至该配置页面。

 

如果在使用过程中CoreMail邮箱系统的密码发生更改，用户可以在OA系统里面【个人设置】-【集成设置】-【集成登录参数设置】进行密码的更新维护。

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

设置后，有权限人员在门户中可展示集成登录元素，点击应用可直接单点登录CoreMail邮箱。

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

 

最终效果，有权限人员在应用中可点击应用单点登录到CoreMail邮箱。

 

# 三、上下游关联功能点

邮箱服务中CoreMail邮箱套件可实现OA组织架构及人员同步至CoreMail邮箱系统，EB邮箱集成组件可展示CoreMail邮箱的未读邮件列表与未读邮件数量，关联集成登录单点登录标识之后，点击未读邮件以及门户导航栏图标可单点登录CoreMail邮箱系统。

邮箱服务-CoreMail邮箱套件帮助文档：

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