> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/zh/guan-li-yuan-zhuan-qu/third-party-integrations/zoom-and-microsoft-integration-and-deployment-field-guide/getting-started-with-microsoft-and-zoom-workplace-deployments.md).

# Microsoft 和 Zoom Workplace 部署入门

从账户、身份验证、权限以及 Zoom 和 Microsoft 集成的部署规划开始。

本节介绍会影响 Zoom Workplace 中每项 Microsoft 集成的决策。在部署日历、Outlook、Teams 或会议室工作流之前，请先阅读本节。

### 前提条件

Zoom 和 Microsoft 集成通常分为两种模式：

1. **Microsoft 产品内的集成**，即在 Teams 或 Outlook 等 Microsoft 产品中提供 Zoom 功能。
2. **Zoom 内的集成**，即将 Microsoft 服务作为数据源、身份提供商或录制系统引入 Zoom。

本指南中的多项集成都有一些共同的前提条件，涉及 Microsoft 365 帐户、Entra ID 权限和 API 配置选项。提前正确完成这些设置，可以避免后续返工。

#### <mark style="color:蓝色;">收集集成所需的帐户和凭据</mark>

要成功完成本指南中概述的步骤，您需要以下账户和凭据：

* 具有 Exchange Online 管理员权限的 Microsoft 365 管理员账户， **以及**:
  * 该账户必须同时具有以下两项的 Exchange Online 管理员权限： **组织管理** 和 **收件人管理**.
  * Microsoft Graph API 应用程序权限需要由 Microsoft 365 全局管理员或具有 Microsoft 365 云应用程序管理员权限的用户，将 Zoom 应用程序添加到 Microsoft Entra ID 企业应用程序中。
  * Microsoft Graph API 应用程序权限要求至少有一个 [关联域](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0066259) 与 Microsoft 365 租户中已验证的自定义域相匹配。
* 具有 Zoom Rooms 访问权限的角色。
* 能够列出、创建和管理会议室的日历资源。
* 在 Windows 10 或更高版本，或 Windows Server 2016 或更高版本上具有 Windows PowerShell 管理员访问权限

**配置 Zoom Workplace 权限，使其与 Microsoft Entra ID 用户同意设置相匹配**

将任何类型的 Microsoft 365 日历与 Zoom 平台集成的第一步，是配置 Zoom 权限，使其与 Microsoft Entra ID（以前称为 Azure Active Directory）的用户同意设置相匹配。

此流程旨在通过匹配操作，帮助您在按照本指南完成其余步骤时，阻止 Zoom 平台与 Entra ID 之间出现权限问题。

**确定当前的 Microsoft Entra ID 用户同意设置**

1. 登录 [Microsoft Azure 管理门户](https://portal.azure.com/) 使用 Microsoft 365 管理员账户。
2. 在 **Azure 服务** 部分中，点击 **Microsoft Entra ID** 图标。
3. 在 **管理** 下拉菜单中，点击 **企业应用程序**.
4. 在“安全性”下拉菜单中，点击 **同意和权限**.
5. 请注意 *“用户同意应用程序”部分*中的值，该值可能是以下选项之一：
   1. 不允许用户同意
   2. 允许用户同意来自已验证发布者的应用，但仅限于选定的权限
   3. 允许用户同意应用

**确认用户同意设置与 Zoom Web门户设置相匹配**

您的组织可以选择限制或允许用户同意设置。Zoom 建议采用简化的权限方法，允许用户自行同意 Entra ID 应用。不过，无论选择哪种方式，组织都必须确保 Entra ID 选项与 Zoom 管理端的配套选项相匹配。

如果你已将 Microsoft Entra ID 的用户同意设置配置为 **不允许用户同意**，或 **允许用户对经过验证的发布者发布的应用同意选定的权限**，则 Zoom 网页端中名为 *代表整个账户同意 Office 365 日历集成权限* 的设置必须设为 **开启**.

![](https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-036bba8d1d57be49d30ddf7ee7c67c2a4844ed89%2F4.png?alt=media)

或者，如果你的用户同意设置配置为 **允许用户同意应用**，则将该设置设为 **关闭**.

![](https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-c8457c73aba19a5b4fafc1393389e5e8f8febf99%2F5.png?alt=media)

**（可选）创建自定义 Microsoft Entra 应用程序，以与 Microsoft Office 365 集成**

有关配置自定义应用程序的完整说明，请参阅 Zoom 支持文章 [使用 Office 365 设置 Zoom Rooms](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063474).

{% hint style="info" %}
必须启用此功能/特性 [由 Zoom 启用](https://support.zoom.com/hc/en/contact?id=contact_us).
{% endhint %}

### 为你的组织选择合适的 API 方法

管理员首先需要决定的一项事项，是 Zoom 如何向 Microsoft 服务进行身份验证。此选择会影响后续的多项集成，因此在开始配置各项功能之前，值得先了解清楚。

{% hint style="info" %}
Zoom 建议 **具有应用程序权限的 Microsoft Graph API** 作为 Zoom Rooms 和个人日历集成的默认选项。对于大多数部署而言，这是更简单、更安全且更具可扩展性的方案。
{% endhint %}

**你们使用哪些 Microsoft 365 API 来处理日历？**

Zoom 日历集成依赖 Microsoft Graph API (MGAPI)。Microsoft 已开始 [逐步淘汰 Exchange Web Services (EWS) 方法](https://techcommunity.microsoft.com/blog/exchange/retirement-of-exchange-web-services-in-exchange-online/3924440) 这些方法此前可用于将 Microsoft 365 数据与 Zoom 服务连接。Zoom 将这些 EWS 方法视为旧版选项。

应用程序权限和委派权限（OAuth）不能互换：具体取舍取决于用户的实际工作方式。正确的选择与其说取决于技术偏好，不如说取决于用户日常工作的主要场景。

**如何识别用于会议室的官方 Zoom 应用程序？**

Zoom 的会议室日历应用程序可在 Entra ID 企业版应用程序目录中找到，并根据 Graph API 配置方法使用以下应用程序 ID 注册：

* `a651cfda-cbdd-4a39-bd03-fa829c3c1b29` （完全委派访问）
* `f56e91e5-5a82-452f-b435-d4d78aeaf064` （应用程序权限）

{% hint style="warning" %}
**Zoom 建议**

无需从 Entra ID 门户手动添加应用程序。通过 Zoom 网页界面请求并批准权限请求，将自动把应用程序添加到你的租户中。
{% endhint %}

**完全委派访问与应用程序权限有何区别？**

通常，Zoom 建议将 Microsoft Graph API 与应用程序权限配合使用，因为这种配置方式由管理员进行设置和维护所需的工作量显著较少，而且不需要专用服务账户。不过，它会在整个账户范围内应用权限。

应用程序权限（也称为仅应用访问）是 Microsoft 为在后台服务中运行、且所需数据无法限定到单个用户的企业版应用程序推荐的方式。

Microsoft Graph API 搭配完全委派访问是另一种选择，但需要专用服务账户，并且初始设置和后续维护的工作量更大。

#### <mark style="color:蓝色;">对于 Zoom Rooms：应用程序权限</mark>

对于 Zoom Rooms 和第三方会议室，Zoom 毫无保留地推荐使用应用程序权限。对于会议室而言，两种方法没有功能/特性差异，而应用程序权限无需使用专用服务账户作为会议室邮箱的委派账户。

这减少了初始设置工作量，并消除了一项持续维护的依赖。

#### <mark style="color:蓝色;">对于用户：先了解他们如何使用 Zoom Workplace</mark>

对于个人日历集成，Zoom 推荐使用应用程序权限，但你的选择取决于组织中的用户每天如何使用 Zoom Workplace。

**大多数组织：应用程序权限（推荐）**

如果您的用户主要通过 Outlook 加载项安排/定时发送和加入会议，并且不经常打开 Zoom Workplace 应用来处理日历、聊天或其他工作流程，那么应用程序权限更适合您。

原因如下：

* **由管理员管理的云到云集成。** 日历集成在账户级别进行管理。各个用户无需自行授权或维护连接。如果集成出现故障，管理员会立即发现，而无需依赖各个用户报告问题。
* **更强的令牌安全性。** 应用程序权限使用短期访问令牌，该令牌通过云到云交换每 60 分钟刷新一次。令牌仅保存在内存中，绝不会持久存储。此方式不使用刷新令牌，也不授予离线访问权限。如果用户的访问权限被撤销，不会有残留令牌可用于访问其日历数据。
* **不依赖用户的登录行为。** 使用委派权限时，集成依赖各个用户登录 Zoom Workplace 应用。如果用户的令牌过期或更改了密码，其日历集成会在没有提示的情况下中断。如果他们主要使用 Outlook，可能数周都不会注意到这一问题。应用程序权限彻底消除了这种故障情况。

**何时委派权限可能是更好的选择**

如果您的用户是 Zoom Workplace 应用的常规用户，委托权限可能更适合：

* **共享日历。** 委派权限允许用户查看 Microsoft 365 中有权访问的同事共享的日历。使用应用程序权限时，用户只能在 Zoom Workplace 应用中查看自己的日历。
* **Zoom Workplace 中的电子邮件。** Workplace 应用中的 Zoom Mail 客户端需要委派权限才能访问用户的 Microsoft 365 邮箱。目前，应用程序权限方法不支持此集成。
* **自助式可见性。** 当用户的委派集成出现问题（例如令牌过期或密码更改）时，他们会直接在 Workplace 应用中看到重新进行身份验证的提示。对于已经在应用中工作的用户，这能让他们更快地自行恢复。

#### <mark style="color:蓝色;">综合运用：部署建议</mark>

对于大多数 Zoom/Microsoft 部署，建议如下：

* **房间：** 应用程序权限。无需取舍，设置更简单，也无需服务账户。
* **用户：** 应用程序权限，除非您的用户经常在 Zoom Workplace 应用中使用共享日历或电子邮件。

此选择并非永久不变。组织可以通过重新授权来更改所用方法。

如果您不确定，可以先使用应用程序权限。它能提供可靠的集成，如果日后出现共享日历或电子邮件需求，您还可以为特定用户组添加委托权限。

以下图示展示了凭据在传输过程中的委派式和基于应用程序的方法。

<div align="left"><figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-12302adcdb9cba6191bdd89be5dadd380d3039d6%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

委派式方法虽然提供了授权，但确实会将凭据发送到 Zoom 应用。

一种更具可扩展性的方法——基于应用程序的授权，可防止用户凭据或令牌直接到达 Zoom 应用程序。

<div align="left"><figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-d147c0cdcfd42094c405fd0ea7960c31b60e07b0%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

### 安全与数据处理

Zoom Web 日历服务存储对每位用户的日历提供商进行身份验证所需的对象。这意味着，当组织使用 OAuth 将 Outlook 或 Google 日历连接到 Zoom 服务时，Zoom 会存储刷新令牌。对于使用基础版身份验证登录本地 Exchange 的组织，Zoom 还会存储账户用户名和密码。

| 已同步的事件 & 活动 &直播          |
| ------------------------ |
| `attendeesOmitted`       |
| `description`            |
| `displayName` （观众）       |
| `电子邮件` （观众）              |
| `fixedWorkingLocation`   |
| `iCalUID`                |
| `位置`                     |
| `displayName` （组织者）      |
| `电子邮件` （组织者）             |
| `summary`                |
| `timeProposal`           |
| `workingLocationEnabled` |

启用双向日历同步后，Zoom 不会在其数据库中保留来自外部日历（Microsoft 365 或 Google 日历）的事件 & 活动 &直播数据。\
\
该服务会监控一个滚动的 18 个月日历活动时间窗口（过去最多 6 个月，未来最多 12 个月）。如果该时间窗口内发生更改，Zoom 会收到日历提供商的更改通知，并按需获取更新后的事件 & 活动 &直播数据，以处理相应的 Zoom 会议更新。随后，系统会通知会议服务应用所需的更改。

管理员可以在账户或用户群组级别配置此功能/特性。有关详细信息，请参阅我们的 [支持文档](https://support.zoom.us/hc/en-us/articles/8522918261645-Enabling-bi-directional-calendar-sync) 。

#### <mark style="color:蓝色;">存储的令牌和凭据如何受到保护？</mark>

存储的令牌和凭据使用 256 位 AES-GCM 加密进行静态加密。这些数据被视为客户内容，受 Zoom 的访问控制政策和标准约束。这些控制措施由独立审计机构评估，具体情况请参阅我们的安全认证和鉴证报告，例如 SOC 2。对基础设施数据和系统的特权访问会被记录和监控，并通过多因素身份验证和最小权限访问控制加以管控。

#### <mark style="color:蓝色;">应用程序与日历服务提供商之间的流量如何受到保护？</mark>

日历服务提供商与任何 Zoom 软件之间的通信，包括 Zoom 桌面和移动应用程序、Zoom Web 日历服务、安排工具和 API 连接器，均使用 TLS 1.2 进行传输加密。

#### <mark style="color:蓝色;">OAuth 令牌的有效期是多久？</mark>

Zoom 会请求有效期为 1 小时的访问令牌和有效期为 90 天的刷新令牌，但日历服务提供商提供的令牌可能有不同的有效期限制。如果需要修改默认值，请遵循服务提供商的说明。

#### <mark style="color:蓝色;">我可以撤销 OAuth 令牌或凭据吗？</mark>

Zoom 管理员可以随时选择从单个 Zoom 账户中移除日历集成，这将阻止该用户使用日历功能。请立即删除该用户存储的所有令牌或凭据。

Microsoft 365 管理员可以通过在 Entra ID 企业版应用程序门户中删除 Zoom 应用程序，移除 Zoom 对所有用户账户日历的访问权限；Google 工作区管理员可以使用 Google 云平台控制台撤销访问权限。

#### <mark style="color:蓝色;">我可以限制 Zoom 向服务提供商写入日历或联系人数据的能力吗？</mark>

初始配置完成后，通过 Microsoft 365 方式正在连接时，Zoom 管理员可以分别为日历和联系人选择“读取”或“读取/写入”权限。管理员还可以限制用户日历的 Google 工作区集成。

### 验证 Entra ID 权限

#### <mark style="color:蓝色;">验证会议室的 MGAPI 应用程序权限方法中的应用程序 ID 和范围</mark> <a href="#yn2twi7v7su4" id="yn2twi7v7su4"></a>

如果您对 Zoom Rooms 或第三方会议室使用应用程序权限方法，请按照以下步骤验证权限：

1. 使用 Microsoft 365 管理员账户登录 Azure 门户。
2. 单击 **Microsoft** **Entra ID** 徽标。
3. 导航到 **企业应用程序**.
4. 默认情况下， **所有应用程序** 会显示在交互式数据表中。
5. 单击 **Zoom** 应用，其应用程序 ID 为 *f56e91e5-5a82-452f-b435-d4d78aeaf064*.
6. 单击 **安全性** 下拉菜单，然后选择 **权限**.
7. 验证 *管理员同意* 选项卡与此处的屏幕相符：

   <div data-with-frame="true"><figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-00b81b86430c45caa06fcde0ca6e020bee7120dc%2F10.png?alt=media" alt=""><figcaption></figcaption></figure></div>

#### <mark style="color:蓝色;">验证会议室或 Zoom Rooms 的 MGAPI 完全委托方法中的应用程序 ID 和范围</mark>

如果您对 Zoom Rooms 或第三方会议室使用完整委派方法，请按照以下步骤验证权限：

1. 使用 Microsoft 365 管理员账户登录 Azure 门户。
2. 单击 **Microsoft** **Entra ID** 徽标。
3. 导航到 **企业应用程序**.
4. 默认情况下， **所有应用程序** 会显示在交互式数据表中。
5. 单击 **Zoom** 应用（应用程序 ID 为 *a651cfda-cbdd-4a39-bd03-fa829c3c1b29*.
6. 单击 **安全性** 下拉菜单，然后选择 **权限**.
7. 验证 *管理员同意* 选项卡是否与此处的屏幕一致：\\

   <div data-with-frame="true"><figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-c913c2fd55f3738a0efb45b5bc7b956eadc41d97%2F11.png?alt=media" alt=""><figcaption></figcaption></figure></div>

#### <mark style="color:蓝色;">验证个人日历应用程序权限 ID 和范围</mark>

如果您将应用程序权限方法用于个人日历，请按照以下步骤验证权限：

1. 使用 Microsoft 365 管理员账户登录 Azure 门户。
2. 单击 **Microsoft Entra ID** 徽标。
3. 导航到 **企业应用程序**.
4. 默认情况下， **所有应用程序** 会显示在交互式数据表中。
5. 点击 **Zoom** 应用，应用程序 ID 为 *f46ceaed-fb2d-4694-803b-6341837f0ed2*.
6. 单击 **安全性** 下拉菜单，然后选择 **权限**.
7. 验证 *管理员同意* 选项卡与此处的屏幕相符：

   <div data-with-frame="true"><figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-95e5221e0a96b32bf033b99f7106395dd5244c77%2F12.png?alt=media" alt=""><figcaption></figcaption></figure></div>

#### <mark style="color:蓝色;">验证个人日历 OAuth 应用程序 ID 和范围</mark> <a href="#s69otfbzjijz" id="s69otfbzjijz"></a>

如果您为用户使用了 OAuth 集成方法（也称为委派权限），请按照以下步骤验证权限：

1. 使用 Microsoft 365 管理员账户登录 Azure 门户。
2. 单击 **Microsoft Entra ID** 徽标。
3. 导航到 **企业应用程序**.
4. 默认情况下， **所有应用程序** 会显示在交互式数据表中。
5. 单击 **Zoom** 应用程序（应用程序 ID 为 *fc108d3f-543d-4374-bbff-c7c51f651fe5*.
6. 单击 **安全性** 下拉菜单，然后选择 **权限**.
7. 验证 *管理员同意* 选项卡与此处的屏幕相符：

   <div data-with-frame="true"><figure><img src="https://2325962437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-9785aac69e02d3f901a54bdc1efbaddb7682db73%2F13.png?alt=media" alt=""><figcaption></figcaption></figure></div>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://library.zoom.com/technical-library/zh/guan-li-yuan-zhuan-qu/third-party-integrations/zoom-and-microsoft-integration-and-deployment-field-guide/getting-started-with-microsoft-and-zoom-workplace-deployments.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
