混合行事歷服務與 Office 365 整合參考

混合行事歷的好處

目前，整合提供下列主要功能：

使最終使用者能夠使用連線至 Office 365 的任何行事歷用戶端排定協作會議，而無需安裝外掛程式或擴充功能。在中鍵入關鍵字位置欄位（例如 @webex 或 @meet），或者將視訊位址URI或會議位址放入會議本文中。
在使用者的 Webex App 應用程式中顯示會議清單 — 桌面、行動裝置與硬體端點。
快顯具有加入按鈕（也稱為「一按開始會議 (OBTP)」）的通知。
當使用者在 Office 365 中設定自動回覆時，更新使用者的 Webex 應用程式線上狀態（有時稱為不在辦公室狀態）。

本文概述基於雲端的混合行事曆服務如何將 Office 365 雲端與 Webex 雲端整合以提供這些功能。

如需其他「混合行事曆服務」整合的類似概觀，請參閱下列文章：

Cisco Webex 混合行事曆服務與 Microsoft Exchange 整合參考（針對基於 Expressway 的 Calendar Connector 部署）
Cisco Webex 混合行事曆服務與 Google 日曆整合參考

如需最新功能與部署資訊，請參閱 https:/ / www.cisco.com/ go/ hybrid-services-calendar。

資料處理

混合行事歷從行事歷系統接收會議詳細資訊，並剖析會議位置和主體，尋找用於加入會議的 URI 和 URL。該服務會使用其他資訊（譬如開始和結束時間及受邀者）來填入Webex應用程式中的會議清單以及在某些裝置上。該服務還提供了加入按鈕 (OBTP)。該服務不會儲存或傳送未加密的敏感資料，例如會議說明、會議本文或受邀者的電子郵件地址。該服務將加密的資料傳送至Webex雲端（並以加密的形式儲存資料）以提供會議清單和加入按鈕。

混合行事歷服務會將會議資料保留一段時間。儲存的資料會涵蓋過去 7 天到未來 31 天的會議。

對於資料加密，混合行事歷使用與Webex應用程式使用的相同Webex雲端加密服務。因此，雲端 Key Management Server (KMS) 提供了金鑰管理。如果您選擇部署混合資料安全性，您自己的內部部署KMS 會提供金鑰管理。（有關更多詳細資訊，請參閱Webex應用程式安全性文件。）

Office 365 租用方支援

請注意 Office 365 租用方的下列考量事項：

商業版Webex僅支援全球 Office 365 實例。（Webex不支援 USGovDoD、USGovGCCHigh、中國和德國實例。）
政府版Webex透過 GCC 中的租用戶和 USGovGCCHigh 實例支援全球 Office 365 實例。（政府版Webex不支援 USGovDoD、中國和德國實例。）
Office 365 包括多地理位置功能，可讓租戶在選擇的地理位置中儲存資料。但是， Webex會根據為客戶組織指定的國家/地區，根據自己的資料駐留規格來儲存資料。有關更多資訊，請參閱 https://www.cisco.com/go/webex-teams-locality。

在部署期間驗證與授權

混合行事歷使用Microsoft Graph 授權來存取組織內使用者的行事歷。

有兩個選項可用來授權「混合行事歷」以存取使用者的行事歷。在企業環境中，Office 365 租戶的全域管理員會向組織中的所有使用者授予對混合行事歷的權限。此方法僅供企業客戶使用。第二個選項是允許使用者使用自行授權混合行事歷連線Microsoft 365 行事歷。「連線您的行事歷」需要定期使用者重新授權。所有類型的使用者都可以使用此方法。

企業應用程式驗證流程

佈建會授予「混合行事歷」以下必要的權限：

權限	使用情況
在所有信箱中讀寫行事曆。	使用加入詳細資料更新會議文字。
登入並閱讀使用者設定檔。	對於其他公開的權限而言為必要。混合行事歷不直接使用它。
讀寫所有使用者信箱設定。	決定使用者的本地化語言。讀取「不在辦公室」狀態。設定不在辦公室狀態（保留以供將來使用）。
讀取網域。	用於有效地將使用者路由到正確的Microsoft 365 租戶

在 Control Hub 中，僅有具有特權存取權的管理員可以為客戶的組織"安裝;設定"混合行事歷。佈建程序需要使用者所隸屬之 Office 365 租用戶的廣域管理員驗證和同意。

流程包括以下高階步驟：

管理員登入 Control Hub，並啟動「混合行事歷」與 Office 365 設定。
混合行事歷將瀏覽器重新導向到 Office 365 雲端進行驗證和同意。
Office 365 租用方登入的廣域管理員。然後，管理員會看到應用程式權限詳細資料（供應商名稱、必要權限等）。
管理員同意針對使用者行事曆提供對 Hybrid Services 應用程式的存取權。
管理員可以輸入測試電子郵件地址，然後確認權限。
根據測試的結果，管理員會收到已更新的成功或失敗指示。

企業佈建過程

使用者應用程式驗證過程

使用者佈建會授予「混合行事歷」以下必要的權限：

權限	使用情況
讀取和寫入行事歷。	使用加入詳細資料更新會議文字。
離線存取。	授予Webex重新整理權杖，將一般使用者的重新授權請求限制為每 30 天一次。
讀寫所有使用者信箱設定。	決定使用者的本地化語言。讀取「不在辦公室」狀態。設定不在辦公室狀態（保留以供將來使用）。
登入並閱讀使用者設定檔。	對於其他公開的權限而言為必要。混合行事歷不直接使用它。

Microsoft Azure 入口網站中的混合行事歷

授權「混合行事歷」存取企業的 Office 365 租用戶後， Microsoft Azure Active Directory管理中心會在企業應用程式清單中顯示服務。

按一下服務名稱， Webex行事歷服務，以查看您授予服務的權限。

將應用程式範圍限制為特定信箱

當您為企業"安裝;設定"混合行事歷時，我們會請求整個組織的授權。 Microsoft Azure 可讓您在佈建前或佈建後將範圍限制為特定郵箱。

使用 Microsoft 文件來限制範圍。例如，請參閱https://docs.microsoft.com/en-us/graph/auth-limit-mailbox-access了解在佈建「混合行事歷」之前限制範圍的步驟。

使用API操作佈建混合行事歷

混合行事歷使用Microsoft Graph API存取 Office 365 行事歷活動。此 API 支援使用 Office 365 執行多種作業。然而，「混合行事歷」僅使用與行事歷用例相關的指令子集。

表 1. 混合行事歷目前使用的操作
圖形作業	使用情況
POST /users/{id \| userPrincipalName}/calendar/events	新增活動或會議至使用者的行事曆。
GET /users/{id \| userPrincipalName}/events/{id}	擷取某個使用者行事曆中單個活動的相關詳細資料。
GET /users/{id \| userPrincipalName}/calendar/events/{id}/instances? startDateTime={start_datetime}&endDateTime={end_datetime}	取得指定時間範圍內重複會議的發生次數。
GET /users/{id \| userPrincipalName}/calendar/events	擷取使用者行事曆資料夾中的活動的相關詳細資料。
POST /subscriptions	訂閱使用者行事曆的變更通知。
GET /users/{id\|userPrincipalName}/mailboxSettings	取得使用者的地區設定和「不在辦公室」狀態。
DELETE /subscriptions/{id}	取消訂閱使用者行事曆的變更通知。
PATCH /users/{id \| userPrincipalName}/calendar/events/{id}	除了與會議相關的其它欄位之外，更新行事曆活動的內容（包括加入資訊及延伸內容）。
POST /users/{id\|userPrincipalName}/calendar/getSchedule	顯示指定時間範圍內的使用者可用性及有空/忙碌狀態。
DELETE /users/{id \| userPrincipalName}/calendar/events/{id}	從行事曆刪除活動。
POST /users/{id \| userPrincipalName}/calendar/events/{id}/{accept \| decline \| tentativelyAccept}	允許使用者接受/拒絕/暫定接受會議的狀態。