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

来源快照：`result_data_new_260518.json`

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

## 正文

# 一、概述

本文档介绍E10通过微软AAD集成接入微软AzureAD。

# 二、配置前提

①E10系统需要有“统一认证接入管理”。

②E10系统需要部署https协议。

③维护E10系统与微软中人员的对应关系。

 

# 三、微软AzureAD中配置

## 3.1、注册E10应用，提供应用ID以及租户ID

Azure Active Directory管理中心-应用注册，注册E10应用：

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

其中，注册的Web地址为E10系统统一认证接入管理中微软AAD集成的回调地址：

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

 

注册之后，需要获取：

**应用程序(客户端)ID、目录(租户)ID**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1174741441723826176&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、添加客户端密码

Azure Active Directory管理中心-注册的E10应用-证书和密码，添加新客户端密码。

**注意，创建的时候就要复制这个“值”** ，不然后面就无法查看客户端密码了。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1174741441804386305&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、设置API权限

Azure Active Directory管理中心-注册的E10应用-API权限，默认是有“User.Read”的权限，需要点击“Microsoft Graph”，再勾选上“User.Read.All”权限，更新权限。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1174741437495468037&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=1174741446250348554&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=1174741441804386311&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权限里面显示这两个权限状态是“已为 默认目录授予”。

 

# 四、E10中微软AAD集成配置

统一认证接入管理中选择微软AAD集成进行设置。

调整应用标识 以及 应用密钥，其中：

应用标识 为 _3.1_ _、注册_ _E10_ _应用，提供应用_ _ID_ _以及租户_ _ID_ 中的“**应用程序(客户端)ID** ”；

应用密钥 为 _3.2_ _、添加客户端密码_ 中的客户端密码。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1174741446018793475&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接口、统一退出接口 的接口地址，将 _3.1_ _、注册_ _ecology_ _应用，提供应用_ _ID_ _以及租户_ _ID_ 中的“**目录(租户)ID** ”复制替换接口地址中的***。

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

其它配置都已经默认配置好，调整基本信息以及接口地址配置后，保存即可。

另外，获取用户信息接口中，默认是将从微软获取到的人员邮箱mail对应E10系统人员的电子邮箱的， 若实际需求不是这个对应关系，则需要进行调整。

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

 

## 接口说明（Azure全球以及Azure中国）

以上默认配置的授权接口、token接口、退出接口：https://login.microsoftonline.com，和人员接口：https://graph.microsoft.com，都是针对**Azure****全球** 的接口。

若**Azure****是中国区** 的，需要手动调整成对应中国区的接口地址，即：

[ _https://login.microsoftonline.com_](https://login.microsoftonline.com) 需调整成： _https://login.partner.microsoftonline.cn_

[ _https://graph.microsoft.com_](https://graph.microsoft.com) 需调整成： _https://microsoftgraph.chinacloudapi.cn_

 

参考文档：

[ _https://docs.azure.cn/zh-cn/articles/guidance/developerdifferences?toc=%2Fguides%2Fdeveloper%2Ftoc.json#check-endpoints-in-azure_](https://docs.azure.cn/zh-cn/articles/guidance/developerdifferences?toc=/guides/developer/toc.json#check-endpoints-in-azure)

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

界面配置中心-登录页设置-PC端登录页，维护自定义登录地址：

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