# E10通过SAML集成接入微软AzureAD

来源快照：`result_data_new_260518.json`

- 来源 ID：`1174742511410233426`
- 模块：集成中心
- 目录：统一认证接入管理 - 配置示例 - 认证集成 微软
- space ID：`1158011075224911873`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 一、概述

本文档介绍E10系统通过SAML集成方式接入微软AzureAD。

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

②维护OA系统与微软中人员的对应关系。（可看“六、维护微软AzureAD以及OA系统人员”）

  

# 三、微软AzureAD提供IDP元数据文件

①企业应用程序中创建你自己的应用程序

默认勾选“集成未在库中找到的任何其他应用程序(非库)”

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

②单一登录-设置SAML单一登录中，在SAML证书中通过应用联合元数据URL保存IDP元数据文件或直接点击“下载”联合元数据XML。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1174742588722864136&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”，将内容复制出来，存为一个.xml文档）

 

# 四、E10系统配置SAML集成获取SP元数据文件

后台管理中心-集成中心-统一认证接入管理，选择SAML集成进行配置：

**回调地址**|  只读，不用管  
---|---  
**Entity ID**|  默认值，无特殊要求不需要调整  
**IDP元数据文件**|  上传微软的联合元数据XML  
**自动生成自签名证书**|  开启，使用自签证书  
**证书密码**|  根据实际自行设置证书密码  
**签名算法**|  选择SHA-1  
**组织名称、组织网址、联系邮箱地址**|  根据实际自行设置，生成SP元数据文件需要  
**账号规则**|  电子邮箱（可看“ _六、维护微软AzureAD以及OA系统人员_ ”）  
**【保存】**|  保存配置  
**【下载SP元数据文件】**|  点击【保存】后显示，点击下载SP元数据文件，文件给到微软  
  
 

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

 

# 五、微软AzureAD中导入SP元数据文件

单一登录-设置SAML单一登录中，点击“上载元数据文件”，上传E10提供的SP元数据文件：

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

 

 

# 六、维护微软AzureAD以及OA系统人员

①进入创建的应用，“用户和组”中添加用户/组

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

 

②单一登陆，属性和索赔里面唯一用户标识符默认是“user.userprincipalname”，即对应人员的“用户主体名称”

默认“user.userprincipalname”：

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

 

唯一用户标识符保持默认“user.userprincipalname”，需要维护用户主体名称，即E10系统这边获取到的信息是用户主体名称信息，将与SAML集成中设置的账号规则进行匹配：

若账号规则选择“电子邮箱”，则将获取的用户主体名称直接与E10的人员邮箱进行匹配；

若账号规则选择“手机号码”，则将获取的用户主体名称，截取@符号前面的内容 与E10的人员手机号码进行匹配；

若账号规则选择“工号”，则将获取的用户主体名称，截取@符号前面的内容 与E10的人员工号进行匹配。

**注意：若唯一用户标识符被修改成其它属性，E10系统获取的人员信息将是其它属性的值的，匹配规则还是保持不变，即账号规则选择“电子邮箱”直接匹配；选择“手机号码”或“工号”还是会截取@符号前面的内容（若有@符号）。**

# 七、集成效果

## 7.1 PC端

### 7.1.1 前提条件

**1、开启PC端认证按钮**

**2、全局基础-界面配置中心-登录页设置-****PC端登录页****中维护PC端自定义登陆地址：**

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

### 7.1.2 认证登录效果

访问自定义登陆地址可跳转到微软登陆页面进行认证登陆：

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

 

## 7.2 移动端

### 7.2.1 前提条件

1、

**开启移动端认证按钮**

** **

1、

**全局基础-界面配置中心-登录页设置-****移动端设计****中维护自定义登陆地址：**

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

未开启全资源拦截

移动端服务器地址需配置移动端个性化地址：

https://passport.yunteams.cn/customlogin/mobilezzz

（界面配置中心-登录页设置-移动端登录页中设置的自定义登录地址）；

 

开启全资源拦截（仅私有化主团队支持）

直接配置域名即可；

 

若开启了**二级域名** ，则访问域名或个性化地址时，二级域名需使用后端接口域名：

示例：

若当前环境已开启二级域名，前端静态资源、sp接口域名为/release/second，后端api、papi等接口域名为/releaseWeaver。

此时，界面配置中心-登录页设置-移动端登录页中设置自定义登录地址显示为：

https://passport.yunteams.cn/release/second/customlogin/mobilezzz

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

由于移动端APP本身无法识别，移动端服务器地址需讲移动端个性化地址的二级域名修改成后端接口的二级域名releaseWeaver，即：

https://passport.yunteams.cn/releaseWeaver/customlogin/mobilezzz

 

### 7.2.2 认证登录效果

进入手机移动端APP登录页，**双指双击** 进入切换服务器地址页面，移动端服务器地址需配置移动端个性化地址：

https://passport.yunteams.cn/customlogin/mobilezzz

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

进入认证登录页（适配H5页面）：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1174742592842170376&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，进入E10移动端登录后页面：

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