配置日历服务
为了让 VCA 的房间日历能显示会议日程并实现一键入会,系统管理员需要在日历服务系统中进行一些前置配置。
配置 Microsoft 365 日历服务
前提条件
- 您需要拥有 Microsoft 365 全局管理员或 Exchange 管理员权限。
- 确保您的 Microsoft 365 租户已验证并添加了您组织的域名。
- 推荐使用 Microsoft Graph API 进行集成,这是微软推荐的现代身份验证和 API 访问方式,优于传统的 Exchange Web Services (EWS)。
配置步骤
在 Microsoft 365 中创建专用服务账户
我们建议创建一个专用的服务账户,用于 VCA 访问所有会议室日历,而不是使用个人管理员账户。
- 登录 Microsoft 365 管理中心 ()。
- 导航至 用户 > 活跃用户 > 添加用户,创建一个新的专用服务账户(例如
[email protected])。 - 为该账户分配一个有效的 Microsoft 365 许可证,该许可证必须包含 Exchange Online 服务计划(例如 Microsoft 365 商业基础版或更高版本)。
- 记录此账户的用户名和密码。后续 VCA Host 在通过浏览器授权时,将使用此账户登录并授予权限。
创建或关联会议室资源邮箱
为每个需要与 VCA 集成的会议室创建一个专用的资源邮箱。
- 在 Microsoft 365 管理中心,导航至 资源 > 房间和设备。
- 点击 “+ 添加资源”,创建一个新的房间资源邮箱(例如
[email protected])。 - 配置房间的属性,如名称(Boardroom)、容量、位置等。
- 为确保安全,房间资源邮箱通常不需要启用密码登录。
为服务账户授予访问房间日历的权限
为了让专用服务账户 ([email protected]) 能够读取和管理所有会议室的日历,您需要为其授予相应的权限。
通过 PowerShell 批量授予权限 (推荐) 这是最高效的方式,特别是在有多个会议室时。
完成以上步骤后,您就可以在 VCA Host 的“”设置中,使用该服务账户通过浏览器授权,以集成 Microsoft 365 日历了。
配置 Google Workspace 日历服务
前提条件
- 您需要拥有 Google Workspace 超级管理员权限。
- 您的组织已在 Google Workspace 中配置并使用日历服务。
配置步骤
Google Workspace 的集成通常通过创建一个服务账号,并为其授予对域范围内日历资源的访问权限来实现。
创建 Google Cloud 项目和服务账号
- 登录 Google Cloud Console (),并使用您的 Google Workspace 管理员账户。
- 创建一个新的 Google Cloud 项目(例如 “VCA Calendar Integration”),或选择一个现有项目。
- 在该项目中,导航至 IAM 和管理 > 服务账号。
- 点击 “+ 创建服务账号”。
- 为服务账号命名(例如
vca-calendar-service),系统会自动生成一个服务账号 ID。 - 点击 “创建并继续”。在“授予此服务账号对项目的访问权限”步骤中,您可以暂时不授予任何角色。点击 “继续”,然后点击 “完成”。
为服务账号启用域范围委派
- 在服务账号列表中,找到您刚刚创建的服务账号,点击进入其详情页面。
- 切换到 “高级设置” 或 “显示域范围委派”。
- 勾选 “启用 Google Workspace 域范围委派”。
- 系统会显示一个唯一的客户端 ID (Client ID)。请复制并保存此客户端 ID,后续步骤需要用到。
- 点击 “保存”。
在 Google Workspace 管理控制台中授权客户端 ID
- 登录 Google Workspace 管理控制台 ()。
- 导航至 安全性 > 访问权限和数据控件 > API 控件。
- 在“域范围委派”部分,点击 “管理域范围委派”。
- 点击 “新增”。
- 在 “客户端 ID” 字段中,粘贴您在上一步中复制的服务账号的。
完成以上步骤后,VCA 系统就可以利用配置好的服务账号来访问您 Google Workspace 中的会议室日历了。您在 VCA Host 的“”设置中选择“Google Calendar”时,VCA将引导您通过标准 OAuth 流程使用一个有权限的管理员账户进行授权。
配置 Exchange Server (本地部署) 日历服务
前提条件
- 您需要拥有 Exchange Server 的管理员权限。
- 您的 Exchange Server 必须可以通过网络被 VCA Host 主机访问。通常需要 Exchange Web Services (EWS) 的访问端点。
- 您需要了解您的 Exchange Server 的 EWS URL 地址(例如
https://mail.yourcompany.com/EWS/Exchange.asmx)。 - 您需要一个专用的服务账户及其凭据(用户名和密码)。
配置步骤
步骤 1:创建或指定一个专用服务账户
我们强烈建议创建一个专用的 Active Directory 用户账户作为 VCA 的服务账户,而不是使用个人管理员账户。
- 在您的 Active Directory 用户和计算机中,创建一个新的用户账户(例如
vca-service)。 - 为该账户设置一个强密码,并根据您的安全策略配置密码永不过期。
- 确保该账户在 Exchange 中拥有一个已启用的邮箱。
创建或确认会议室资源邮箱
为每个需要与 VCA 集成的会议室,在 Exchange 中创建一个专用的会议室资源邮箱。
- 登录 Exchange 管理中心 (EAC)。
- 导航至 收件人 > 资源。
- 点击 “+” 图标,选择 “会议室邮箱”,创建一个新的会议室资源(例如
boardroom,邮箱地址为[email protected])。 - 配置房间的属性,如名称、别名、容量等。
为服务账户授予访问房间日历的权限
为了让服务账户 (vca-service) 能够读取和管理所有会议室的日历,您需要为其授予必要的权限。最有效的方式是通过 Exchange 命令行管理程序 (Exchange Management Shell)。
-
打开 Exchange 命令行管理程序。
-
授予对日历的编辑权限 (Editor):
- 对每个会议室资源邮箱,运行以下命令。请将
boardroom替换为实际的会议室邮箱标识,vca-service替换为您的服务账户用户名。 - 这个命令授予服务账户对指定会议室“日历”文件夹的“编辑者”权限,这通常是 VCA 所需的最小且足够的权限。
- 对每个会议室资源邮箱,运行以下命令。请将