具有 Microsoft 365 集成的混合日历服务参考

混合日历优势

目前，该集成提供以下主要功能：

使最终用户能够使用连接到 Microsoft 365 的任何日历客户端安排协作会议，而无需安装插件或扩展程序。在位置字段中输入关键字（例如， @webex 或者 @meet) 或者将视频地址 URI 或会议地址放入会议正文中。
在用户的台式机、移动设备和硬终端的 Webex 应用程序中显示会议列表。
弹出带有“加入”按钮的通知，也称为一键通 (OBTP)。
当用户在 Microsoft 365 中设置自动回复时（有时称为外出状态），更新用户的 Webex App 在线状态。

本文概述了基于云的混合日历服务如何将 Microsoft 365 云与 Webex 云集成，以提供这些功能。

有关其他混合日历服务集成的类似概述，请参阅以下文章：

Cisco Webex 混合日历服务与 Microsoft Exchange 集成参考（适用于基于 Expressway 的日历连接器部署）
Cisco Webex 混合日历服务与 Google Calendar 集成参考

有关最新功能和部署信息，请参阅 https://www.cisco.com/go/hybrid-services-calendar。

数据处理

混合日历从日历系统接收会议详情，并按如下方式使用：

检查会议位置和正文中的 URI 和 URL，以便加入会议。
邀请函标题即为会议标题
在 Webex 应用和某些设备上，会议列表中会显示会议时段的开始和结束时间。
邀请人员将信息添加到会议列表中的参与者列表中
邀请被邀请者在加入时间到时，向他们发送“加入”按钮。
会议邀请函主体将填写 Webex 会议议程。

该服务将加密数据发送到 Webex 云（并以加密形式存储数据），以提供会议列表和“加入”按钮。

该服务不会存储或传输未加密的数据。会议描述、会议主体内容以及受邀者的电子邮件地址等敏感数据在存储和传输时始终进行加密。

混合日历服务会在有限的时间内保留会议数据。存储的数据涵盖了过去 7 天到未来 31 天的会议。

对于数据加密，混合日历使用与 Webex App 相同的 Webex 云加密服务。因此，云密钥管理服务器（KMS）提供密钥管理。如果您选择部署混合数据安全，则您自己的本地 KMS 将提供密钥管理。（更多详情，请参阅 Webex应用程序安全文档。）

Microsoft 365 租户支持

请注意您的 Microsoft 365 租户的以下注意事项：

商业版 Webex 仅支持 Microsoft 365 全球版。（Webex 不支持 USGovDoD、USGovGCCHigh、中国和德国实例。）
Webex for Government 通过 GCC 中的租户和 USGovGCCHigh 实例支持 Microsoft 365 全球实例。（Webex for Government 不支持 USGovDoD、中国和德国的实例。）
Microsoft 365 包含多地理位置功能，使您的租户能够将数据存储在选定的地理位置中。但是，Webex 会根据其自身的数据驻留规范，基于为客户组织指定的国家/地区来存储数据。有关更多信息，请参阅 https://www.cisco.com/go/webex-teams-locality。

部署期间的验证和授权

混合日历使用 Microsoft Graph 授权来访问组织内部用户的日历。

有两种方法可以授权 Hybrid Calendar 访问用户的日历。

在企业环境中，Microsoft 365 租户的全局管理员会向组织中的所有用户授予混合日历的权限。此方法只供企业客户使用。

第二种方法是允许用户使用连接您的 Microsoft 365 日历自行授权混合日历。“连接您的日历”功能需要定期进行用户重新授权。此方法适用于各种类型的用户。

企业应用程序验证过程

设置向混合日历授予以下所需权限：

权限	使用情况
在所有邮箱中读写日历。	使用加入详情更新会议文本。
登录并读取用户档案。	获取所列的其他权限时需要。混合日历并不直接使用它。
读取和写入所有用户邮箱设置。	确定用户语言以进行本地化。阅读“不在办公室”状态。设置外出办公状态（预留以备将来使用）。
读取域。	用于高效地将用户路由到正确的 Microsoft 365 租户
读取目录 RBAC 设置	要确定此用户是否是所请求租户中的全局管理员

在 Control Hub 中，只有具有特许访问权限的管理员可以为客户的组织设置混合日历。配置过程需要管理员进行身份验证，并且需要用户所属的 Microsoft 365 租户的全局管理员同意。

该流程包含以下高级步骤：

组织管理员登录 Control Hub 并启动带有 Microsoft 365 设置的混合日历。

混合日历会将浏览器重定向到 Microsoft 365 云进行身份验证和同意。
Microsoft 365 提示管理员登录 Microsoft 365 租户。管理员使用全局管理员帐户登录。

管理员必须同意 Webex 检查其是否为该租户中的全局管理员。

Webex 会与 Microsoft 365 进行此项检查。如果成功，Webex 会请求日历权限。
Microsoft 365 提示管理员登录 Microsoft 365 租户。管理员使用全局管理员帐户登录。

管理员必须同意 Webex 访问日历数据。日历服务提示输入测试电子邮件帐户。
管理员输入一个测试电子邮件地址，Webex 尝试在测试帐户的日历中创建一个事件。

根据测试结果，管理员会得到有关成功或失败的更新指示。

用户应用程序验证过程

用户设置授予混合日历以下所需权限：

权限	使用情况
读写日历。	使用加入详情更新会议文本。
离线访问。	授予 Webex 刷新令牌，将最终用户的重新授权请求限制为每 30 天一次。
读取和写入所有用户邮箱设置。	确定用户语言以进行本地化。阅读“不在办公室”状态。设置外出办公状态（预留以备将来使用）。
登录并读取用户档案。	获取所列的其他权限时需要。混合日历并不直接使用它。

Microsoft Azure 门户中的混合日历

授权 Webex Calendar 服务访问您的 Microsoft 365 企业租户后，Microsoft Azure Active Directory 管理中心会在企业应用程序列表中显示该服务。

单击服务名称 Cisco Webex Connect Your Calendar ，然后打开权限页面，查看您授予该服务的权限。

将应用程序范围限制为特定邮箱

当您为企业设置混合日历时，我们会请求整个组织的授权。Microsoft Azure 允许在预配置前或预配置后将范围限制为特定邮箱。

要限制范围，请参阅 Microsoft 文档。例如，请参阅 https://learn.microsoft.com/en-us/graph/auth-limit-mailbox-access 了解在设置混合日历之前限制范围的步骤。

通过 API 操作设置混合日历

混合日历使用 Microsoft Graph API 访问 Microsoft 365 日历事件。该 API 支持与 Microsoft 365 进行广泛的操作。但是，混合日历仅使用与日历使用案例相关的命令子集。

表1。当前由混合日历使用的操作
Graph 操作	使用情况
邮政 /users/{id \| userPrincipalName}/calendar/events	将活动或会议添加到用户日历中。
得到 /users/{id \| userPrincipalName}/events/{id}	检索用户日历中单个活动的相关详细信息。
得到 /users/{id \| userPrincipalName}/calendar/events/{id}/instances? startDateTime={start_datetime} & endDateTime={end_datetime}	获取重复会议在指定时间范围内的出现次数。
得到 /users/{id \| userPrincipalName}/calendar/events	检索用户日历文件夹中的活动相关详细信息。
POST /subscriptions	订阅对用户日历更改的相关通知。
得到 /users/{id\|userPrincipalName}/mailboxSettings	获取用户区域设置和不在办公室状态。
DELETE /subscriptions/{id}	取消订阅对用户日历更改的相关通知。
修补 /users/{id \| userPrincipalName}/calendar/events/{id}	除了与会议有关的其他字段外，更新日历活动的属性（包括加入信息和扩展属性）。
邮政 /users/{id\|userPrincipalName}/calendar/getSchedule	显示指定时间范围内用户的可用性和忙/闲状态。
删除 /users/{id \| userPrincipalName}/calendar/events/{id}	从日历中删除活动。
邮政 /users/{id \| userPrincipalName}/calendar/events/{id}/{accept \| 拒绝 \| 暂接受}	允许用户接受/拒绝/暂时接受会议的状态。
得到 /roleManagement/directory/roleAssignments	获取请求同意的用户所分配的角色。

Cisco AI Assistant

感谢您的反馈。