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

混合日历优势

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

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

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

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

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

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

数据处理

混合日历从日历系统中接收会议详细信息，并按以下方式使用这些详细信息：

检查URI和URL的会议位置和正文，以加入会议
邀请的标题作为会议标题
开始和结束时间，以在Webex应用程序和某些设备上显示会议列表中的会议插槽
受邀者填入会议列表中的与会者列表
当需要加入时，受邀者向其发送“加入”按钮
会议邀请机构填写Webex会议议程

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

该服务不会存储或传输未加密的数据。在存储和传输时，敏感数据（如会议说明、会议正文和受邀者的电子邮件地址）始终加密。

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

对于数据加密，混合日历使用与Webex应用程序使用相同的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 授权来访问组织内部用户的日历。

有两种选项为混合日历提供访问用户日历的授权。

在企业环境中，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日历服务访问企业的Microsoft 365租户后，Microsoft Azure Active Directory管理中心将在企业应用程序列表中显示该服务。

单击服务名称，Cisco Webex连接您的日历，然后打开权限页面，以查看您授予该服务的权限。

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

当您为企业设置混合日历时，我们会请求整个组织的授权。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 操作	使用情况
POST /users/{id\| userPrincipalName}/calendar/events	将活动或会议添加到用户日历中。
GET /users/{id\| userPrincipalName}/events/{id}	检索用户日历中单个活动的相关详细信息。
获取/users/{id\| userPrincipalName}/calendar/events/{id}/instances？ startDateTime={start_datetime}&endDateTime={end_datetime}	获取重复会议在指定时间范围内的出现次数。
GET /users/{id\| userPrincipalName}/calendar/events	检索用户日历文件夹中的活动相关详细信息。
POST /subscriptions	订阅对用户日历更改的相关通知。
获取/users/{id\|userPrincipalName}/mailboxSettings	获取用户区域设置和不在办公室状态。
DELETE /subscriptions/{id}	取消订阅对用户日历更改的相关通知。
补丁/users/{id\| userPrincipalName}/calendar/events/{id}	除了与会议有关的其他字段外，更新日历活动的属性（包括加入信息和扩展属性）。
POST /users/{id\|userPrincipalName}/calendar/getSchedule	显示指定时间范围内用户的可用性和忙/闲状态。
删除/users/{id\| userPrincipalName}/calendar/events/{id}	从日历中删除活动。
POST /users/{id\| userPrincipalName}/calendar/events/{id}/{accept\| decline\| 尝试接受}	允许用户接受/拒绝/暂时接受会议的状态。
GET /roleManagement/目录/roleAssignments	检索分配给请求同意的用户角色。

感谢您的反馈。