共用方式為

Confluence 內部部署 Microsoft Graph 連接器

  • 發行項

Confluence 內部部署 Microsoft Graph 連接器可讓您的組織為 Confluence 伺服器或資料中心內容編製索引。 設定連接器並從 Confluence 網站編製數據索引之後，用戶可以在 [搜尋] 和 [Microsoft 365 Copilot] 中搜尋這些內容Microsoft。

本文適用於Microsoft 365 個系統管理員，以及負責設定、執行及監視 Confluence 內部部署 Microsoft Graph 連接器的人員。 它會補充 Microsoft 365 系統管理中心 中 Graph 連接器Microsoft安裝程式中提供的一般指示。

優點

  • 增強的搜尋功能：用戶可以在 Copilot 中詢問有關 Wiki 內容的自然語言問題，例如：
    • 摘要說明架構檔
    • 如何取得入口網站的存取權
  • 語意搜尋支援：用戶可以執行自然語言查詢，以取得精確的回應。
  • 相容性：支援 8.0 以上的 Confluence 版本。

必要條件

  1. 安裝 GCA [Graph 連接器代理程式]：確定 GCA 安裝在與數據源位於相同網路內的 Windows 計算機上，可透過 Confluence URL 存取。 您可以在 Graph 連接器代理程式Microsoft找到詳細資訊
  2. 安裝外掛程式：從 Confluence 安裝程式上的 Atlassian Marketplace 下載並安裝 confluence 內部部署外掛程式。 從 Microsoft Graph 連接器 Confluence 內部部署外掛程式取得外掛程式 |Atlassian Marketplace
  3. 驗證：確定您具有具有正確存取權的驗證認證。

重要事項

建議：Confluence 全域管理員應建立連線

Confluence 全域管理員是誰？ Confluence 系統管理員是具有完整系統管理許可權的使用者。

  • 若要檢查許可權：移至 系統管理>一般設定>全域許可權
  • 尋找已啟用所有許可權 的 Confluence-administrators 群組，包括 - 可使用、個人空間、建立空間、Confluence 系統管理員和系統管理員。
  • 任何建立令牌的用戶都必須是此群組的成員

開始使用

1.顯示名稱

顯示名稱可用來識別 Copilot 中的每個參考，協助使用者輕鬆辨識相關聯的檔案或專案。 顯示名稱也代表受信任的內容。 顯示名稱也會當做 內容來源篩選條件使用。 此欄位有預設值，但您可以將它自定義為組織中用戶可辨識的名稱。

2. Confluence 內部部署URL

若要連線到您的 Confluence 內部部署數據，您需要組織的 Confluence 實例 URL。 您組織的 Confluence 實例 URL 通常看起來像 『https://contoso.atlassian.net』。

3.Graph 連接器代理程式 (GCA)

若要為 Confluence 伺服器或資料中心內容編製索引，您必須安裝並註冊連接器代理程式。 如需詳細資訊，請參閱 安裝 Microsoft Graph 連接器代理 程式。 您必須是組織Microsoft 365 租用戶的系統管理員，以及您組織 Confluence 網站的系統管理員。

注意事項

GCA 可以安裝在不同的 Windows 電腦上，而且不需要與內部部署伺服器位於相同的電腦上。 計算機可協助產生可用於安裝程式的應用程式識別碼和秘密。 您必須確定 GCA 機器在編目期間已開啟。 您可以在常見問題一節中找到常見 GCA 相關問題的解 答 。

4.安裝 Confluence 內部部署外掛程式

確認已安裝 Microsoft Graph 連接器 Confluence 內部部署外掛程式。 您不需要為每個 Confluence 連接器安裝外掛程式;如果已安裝在 Confluence 實例中，您可以針對後續 Confluence 內部部署連線略過此步驟。

注意事項

8.0 以上的 Confluence 版本支援外掛程式。

5.驗證類型

若要從 Confluence 內部部署驗證和同步處理內容，請選擇 三種支援的方法之一 ：

a. 基本驗證
若要向您的實例進行驗證，請輸入 Confluence 帳戶的使用者名稱和密碼。

b. OAuth1.0a
產生公開/私鑰組，並在 Confluence 內部部署網站中建立應用程式連結，讓連接器代理程式可以存取實例。 若要深入瞭解，請參閱 Atlassian 開發人員文件中 有關如何設定 OAuth 1.0a 的步驟 1。

c. OAuth 2.0 (建議)
下列步驟提供如何註冊應用程式設定 連入連結的指引。

  1. 移至 [系統管理 > 一般設定] > [應用程式連結]。
  2. 選取 [建立連結]
  3. 選取 [外部應用程式]，然後選擇 [傳入] 作為方向。
  4. 填入
  • 重新導向 URL： https://gcs.office.com/v1.0/admin/oauth/callback
  • 範圍：
    ) 如果您是 Confluence 全域管理員，則支援下列其中一個範圍：管理員 或讀取。
    b) 如果您是任何其他類型的 Confluence 系統管理員，請提供 管理員 範圍
  1. 使用用戶端識別碼和秘密完成連線設定步驟。

6.向有限的物件推出

如果您想要先在 Copilot 和其他搜尋介面中驗證此連線，再將推出擴充至更廣泛的物件，請將此連線部署至有限的使用者基底。 若要深入瞭解有限的推出，請按兩下 這裡。

此時，您已準備好建立 ServiceNow Knowledge 的連線。 您可以按兩下 [建立] 按鈕，而 Microsoft Graph 連接器會從您的 Confluence 帳戶開始編制索引頁面。

針對其他設定，例如訪問許可權、數據包含規則、架構、編目頻率等，我們會根據最適合 Confluence 資料的設定預設值。 預設值如下：

使用者  
訪問許可權 只有具有數據源中內容存取權的人員。
對應身分識別 使用 Microsoft Entra標識碼對應的數據源身分識別。
內容  
包含/排除空間 全部
管理屬性 若要檢查預設屬性及其架構，請按兩下這裡
同步處理  
累加編目 頻率：每 15 分鐘
完整編目 頻率：每天

如果您想要編輯這些值中的任何一個，您必須選擇 Custom Setup 選項。

自訂安裝程式

自訂設定適用於想要編輯預設數據表中所列設定之預設值的系統管理員。 按兩下 Custom Setup 選項之後，您會看到另外三個索引標籤 ： [使用者]、[內容] 和 [同步]。

使用者

訪問許可權

Confluence 內部部署 Microsoft Graph 連接器支援可讓所有人或只有具有此數據源存取權的人員看見搜尋許可權。 如果您選擇 [所有人]，已編製索引的數據會出現在所有使用者的搜尋結果中。 如果您選擇 [僅限可存取此數據源的人員]，則已編製索引的數據會出現在具有此數據源存取權之使用者的搜尋結果中。 在 Confluence 內部部署中，使用者和群組的安全性許可權是使用空間許可權和頁面限制來定義。 Confluence 內部部署 Microsoft Graph 連接器會套用內容限制 API 所提供的有效許可權

如果您選擇 [僅限可存取此數據源的人員]，則必須進一步選擇 Confluence 網站是否 Microsoft Entra ID 布建的使用者或非 AAD 使用者。

若要識別哪個選項適合您的組織：

  1. 如果 Confluence 使用者的電子郵件識別碼與 Microsoft Entra ID 中使用者的 UPN) UserPrincipalName (相同，請選擇 [Microsoft Entra ID] 選項。
  2. 如果 Confluence 使用者的電子郵件識別碼與 UserPrincipalName 不同，請選擇非 AAD 選項 (Microsoft Entra ID 中使用者的 UPN) 。

重要事項

  • 如果您選擇 Microsoft Entra ID 作為身分識別來源的類型，連接器會將從 Confluence 取得的使用者電子郵件識別碼直接對應至 Microsoft Entra ID 的 UPN 屬性。
  • 如果您針對身分識別類型選擇「非 AAD」，請參閱對應 您的非 Azure AD 身 分識別，以取得對應身分識別的指示。 您可以使用此選項來提供從電子郵件識別碼到 UPN 的正規表示式對應。
  • 對管理訪問許可權的使用者或群組 匯報 只會以完整編目同步處理。 累加編目目前不支援處理許可權的更新。

內容

包含或排除您想要編製索引的數據

在此步驟中，您可以從 Confluence 數據源新增或移除可用的屬性。 Microsoft 365 會選取一些屬性。 根據預設，連接器會為所有空格編製索引。 不過，您可以選擇使用空間篩選選項來包含或排除特定空間。

輸入您想要包含或排除的空間密鑰清單，您會看到結果的預覽。 輸入空格鍵：每個 Confluence 空間都有一個空格鍵，這是一個簡短的唯一標識符，構成該空間 URL 的一部分。 若要取得空間密鑰，請連絡 confluence 系統管理員。如需詳細資訊，請造訪： 空間密鑰

頁面篩選

在此步驟中，您可以指定索引檔的日期範圍。 參數如下所示：

  • 上次建立日期：建立檔的日期。 只有在此日期之後修改的檔才會編製索引。
  • 上次修改日期：修改檔的日期。 只有在此日期之後修改的檔才會編製索引。

重要事項

  • 確定日期依時間順序排列。 「上次建立日期」不應晚於「上次修改日期」。
  • 如果未指定日期，則會考慮所有文件進行索引編製。

管理屬性

在這裡，您可以從 Confluence 內部部署數據源新增或移除可用的屬性。 將架構指派給 屬性 (定義屬性是否可搜尋、可查詢、可擷取或可精簡) 。 此外，您可以變更語意標籤，並將別名新增至 屬性。 預設屬性如下所示：

Source 屬性 標籤 Schema
作者 作者 查詢、擷取
內容 搜尋
CreatedByName 建立者 搜尋、查詢、擷取
CreatedOn 建立日期時間 查詢、擷取
識別碼 查詢、擷取
PageTree 取回
SpaceName 搜尋、查詢、擷取
標題 title 搜尋、擷取
UpdatedByName lastModifiedBy 取回
UpdatedOn lastModifiedDateTime 查詢、擷取、精簡
URL URL 取回

預覽數據

使用 [預覽結果] 按鈕來驗證選取的屬性和篩選條件。

注意事項

預覽僅遵循空間層級篩選。

同步處理

重新整理間隔會決定數據源與 Graph 連接器索引之間同步處理資料的頻率。 重新整理間隔有兩種類型 ： 完整編目和累加編目。 如需詳細資訊，請按兩下 這裡。 您可以視需要從這裏變更重新整理間隔的預設值。

檢閱和測試您的連線

  • 若要進行測試，您可以選擇 發佈至有限的物件。
  • 使用索引瀏覽器搜尋並驗證已編製索引的內容和 許可權。
  • 在我們的常見問題一節中尋找常見問題的解 答。

針對 MS 搜尋，如果您需要自定義搜尋結果頁面。 若要瞭解如何自定義搜尋結果，請參閱 自定義搜尋結果頁面。

限制

  • 不會為部落格、附件檔案或批注編製索引。
  • 僅索引目前的頁面;已封存的頁面會遭到排除。
  • Confluence 內部部署不支援 CQL (Confluence 查詢語言) ，但我們支援空間和頁面層級篩選

疑難排解

發佈連線之後，您可以在系統管理中心的 [數據源] 索引卷標下檢閱狀態。 若要瞭解如何進行更新和刪除，請參閱 管理您的連接器。 您可以 在這裡找到常見問題的疑難解答步驟。

如果您有問題或想要提供意見反應，請 連絡 Microsoft Graph |支援。