Confluence 本地端連接器使 Microsoft 365 能夠索引並檢索自自架 Confluence 資料中心或伺服器實例的內容。 它將企業維基內容引入 Microsoft Search 與 Copilot，提升 Microsoft 365 生態系統內的能見度與可用性。
本文說明部署、客製化及排除 Confluence 本地端連接器的步驟。 關於 Copilot 連接器部署的一般資訊，請參閱 Microsoft 365 系統管理中心的「設定 Copilot 連接器」。
欲了解進階的 Confluence 本地配置資訊，請參閱 「設定 Confluence 本地服務以擷取連接器」。
必要條件
在部署 Confluence 本地端連接器之前，請確保 Confluence 環境已在你的組織中配置好。 下表總結了配置 Confluence 環境及部署連接器的步驟。
| 角色 | 工作 |
|---|---|
| Confluence 管理員 | 設定環境 |
| Confluence 管理員/網路管理員 | 設置先決條件 |
| Microsoft 365 系統管理員 | 在 Microsoft 365 系統管理中心部署連接器 |
| Microsoft 365 系統管理員 | 自訂連接器設定 (可選) |
在部署連接器前，請確保以下先決條件已達成：
- 你必須是 Microsoft 365 管理員。
- 在與 Confluence 伺服器同一個網路的 Windows 電腦上安裝 GCA) (Graph Connector Agent 。
- 安裝 Atlassian 市集的 Confluence 本地外掛。
- 確認 Confluence 行動網路外掛 已安裝並啟用。
- 確保認證憑證具備 Confluence 管理員權限。
- 請確認你的 Confluence 版本是 8.0 或以上。
展開連接器
要為您的組織新增 Confluence 本地端連接器：
- 在 Microsoft 365 系統管理中心左側窗格，選擇 Copilot>連接器。
- 到「 連接器 」分頁，在左側窗格選擇 「圖庫」。
- 從可用連接器列表中，選擇 Confluence On-premises。
集合顯示名稱
顯示名稱用於識別 Copilot 回應中的參考，幫助使用者辨識相關檔案或項目。 顯示名稱同時代表受信任的內容，並用作內容來源過濾器。
你可以接受 Confluence 本地端 預設的顯示名稱，或自訂該值，使用組織中使用者熟悉的名稱。
欲了解更多資訊，請參閱「以 Microsoft 365 Copilot 連接器強化 Copilot 發現」內容
設定實例網址
要連接你的 Confluence 網站，請使用你組織的網站實例網址。 典型格式如下：
https://<your-company-domain>/confluence
要找到你的實例網址：
- 在 Confluence 管理員主控台，點選 General Configuration>Server Base URL。
選擇認證類型
連接器支援以下認證方法：
- 基本認證：使用 Confluence 的使用者名稱和密碼。
- OAuth 1.0a：產生公私密金鑰對並建立應用程式連結。 欲了解更多資訊，請參閱 OAuth。
- OAuth 2.0 (推薦) ：註冊一個帶有管理員範圍的應用程式連結。
針對 OAuth 2.0 設定：
- 請前往 管理>一般配置>應用程式連結。
- 選擇 建立連結>外部應用程式>即將來臨。
- 將範圍設為管理員。
- 請使用以下重定向網址：
https://gcs.office.com/v1.0/admin/oauth/callback。
推出
若要推送至有限受眾，請選擇「 推展」 旁的「有限受眾」切換，並指定要推送連接器的使用者與群組。 欲了解更多資訊，請參閱 Copilot 連接器的分階段部署。
選擇 建立 來部署連線。 Confluence 本地 Copilot 連接器會立即開始索引內容。
下表列出預設值。
| 類別 | 設定 | 預設值 |
|---|---|---|
| 使用者 | 存取權限 | 只有有權限存取資料來源內容的人。 |
| 使用者 | 對應身分識別 | 資料來源身份是透過 Microsoft Entra ID 來映射的。 |
| 內容 | 包含/排除空間 | 所有空間都包含在內。 |
| 內容 | 管理物業 | 關於預設屬性與結構，請參見 管理屬性。 |
| 同步處理 | 增量爬行 | 每15分鐘一次。 |
| 同步處理 | 全程爬行 | 每日。 |
要自訂這些數值，請參閱 「自訂設定」。
建立連線後，您可以在 Microsoft 365 系統管理中心的連接器區查看狀態。
自訂設定
你可以自訂 Confluence 本地接頭設定的預設值。 要自訂設定，在管理中心的連接器頁面選擇 自訂設定。
自訂使用者設定
Confluence Cloud 連接器支援以下使用者搜尋權限：
- 所有人：索引資料對所有使用者皆可見。
- 僅限有權限者：索引資料僅對 Confluence 有權限的使用者可見。
在 Confluence On-local 中，使用者與群組的安全權限透過空間權限與頁面限制來定義。 許可評估過程如下：
- 從頁面層級的限制中取得權限設定。
- 從父頁面限制中取得權限設定。
- 從空間權限中取得權限設定。
- 計算前三種配置的交集，以確定該頁面的有效權限。 這組最終權限集會同步到 Microsoft 365 Copilot。
重要事項
- 對於 3.1.14 之前的 Microsoft Graph Connector Agent 版本，空間層級定義的匿名存取設定不會被考慮。
- 從 3.1.14 版本起的 Microsoft Graph Connector Agent 版本，會考慮在空間層級定義的匿名存取設定。
如果你選擇「僅限有權限存取此資料來源的人」，請選擇你的 Confluence 網站是否有 Microsoft Entra ID 設定的使用者，或是非 Microsoft Entra ID 使用者：
- Microsoft Entra ID：如果 Confluence 的電子郵件 ID 與 Microsoft Entra ID) UPN 的使用者主體名稱 (相符，請選擇此選項。
- 非 Microsoft Entra ID：如果 Confluence 的電子郵件 ID 與 UPN 不符，請選擇此選項。 使用正則表達式將電子郵件 ID 對應到 UPN。
權限的匯報只會在完整爬取期間同步。
自訂內容設定
你可以以下方式自訂內容設定：
- 透過空格篩選選項，包含或排除特定空間。 每個空格都有一個空格鍵識別碼，該識別碼是該空格網址的一部分。 欲了解更多資訊，請參閱空白鍵。
- 指定文件索引的日期範圍。 你可以依 照最後建立日期 或 最後修改日期來篩選頁面。
- 從資料來源新增或移除屬性，為可搜尋、可查詢、可檢索、可精煉 () 的屬性指派結構，並更改與屬性相關的語意標籤。 下表列出預設屬性。
| 源頭性質 | 標籤 | Schema |
|---|---|---|
| 作者 | 作者 | 查詢，取回 |
| 內容 | 搜尋 | |
| CreatedByName | 建立者 | 搜尋、查詢、檢索 |
| CreatedOn | 建立約會時間 | 查詢，取回 |
| 識別碼 | 查詢，取回 | |
| 頁面樹 | 取回 | |
| 太空名稱 | 搜尋、查詢、檢索 | |
| 標題 | title | 搜尋，取回 |
| 更新dByName | 最後修改者 | 取回 |
| 更新日期 | 最後修改日期時間 | 查詢、檢索、精煉 |
| URL | URL | 取回 |
自訂同步間隔
你可以調整同步頻率：
- 增量爬取：同步新內容與修改內容。 增量爬行不會偵測 ACL 變更或刪除項目。 預設是每 15 分鐘一次。
- 完整爬行：對所有內容進行完全同步。 完整爬取偵測已刪除項目，並同步存取控制清單 (ACL) 變更。 預設是每日。
欲了解更多資訊，請參閱 同步設定指引。