共用方式為

Confluence Cloud Microsoft Graph 連接器

  • 發行項

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

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

優點

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

必要條件

  1. 您必須是組織Microsoft 365 租用戶的系統管理員，以及您組織 Confluence 網站的系統管理員。
  2. 驗證：確定您具有具有正確存取權的驗證認證。

限制

  • 不會為附件檔案或批注編製索引。

重要事項

  • Atlassian 即將淘汰一組 Confluence 雲端 API (V1 版本) ，並在 V2 版本) (發行新的 API。 您可以在 這裏 或 這裡閱讀其公告。 其中一些即將淘汰的 v1 API 僅供連接器用於 OAuth 連線 。 因此，在此變更之後，您現有的 Confluence 連線 () 可能會停止運作。 這項變更排定在 1 月 24 日。
  • 移轉至新 v2 API 的變更已於 2023 年 12 月發行給所有客戶。 在此版本之後，您現有的連線必須重新驗證。 相較於先前需要在重新驗證期間提供的 v1 API) ，新的 v2 API 也需要更多範圍 (。 完整清單 (需要一組新的範圍) – read:group:confluence、read:user:confluence、read:content-details:confluence、Read:space:confluence、Read:permission:confluence、 read:audit-log:confluenceread:content.metadata:confluence 和 read:page:confluence。

開始使用

1.顯示名稱

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

2.Confluence 雲端 URL

若要連線到您的 Confluence 網站，請使用您的網站 URL。 Confluence 雲端網站 URL 通常看起來像是 https://< organization_name.atlassian.net/>。

3.驗證類型

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

提示

請確定服務帳戶具有您想要編製索引之 Confluence 內容的 檢視存取權 。

a. 基本驗證
輸入您帳戶的使用者名稱 (通常是電子郵件識別碼) 和 API 令牌，以使用基本身份驗證進行驗證。若要深入瞭解如何產生 API 令牌，請參閱 Atlassian 的檔，以瞭解如何 管理 Atlassian 帳戶的 API 令牌。

b. OAuth 2.0 (建議)
在 Confluence Cloud 中註冊應用程式，讓Microsoft搜尋應用程式和 Microsoft 365 Copilot 可以存取實例。 若要深入瞭解，請參閱 Atlassian 支援檔，以瞭解如何 啟用 OAuth 2.0。

下列步驟提供如何註冊應用程式的指引：

  1. 使用您的 Atlassian Confluence 系統管理員帳戶登入 Atlassian Developer 控制台 。
  2. 按兩下 [ 建立 ]，然後選取 OAuth 2.0 integration。
  3. 為應用程式提供適當的名稱，並建立新的應用程式。
  4. 從左方的瀏覽窗格巡覽至 Permissions 。 針對 按兩下 [新增 ] Confluence API。 新增之後，按兩下列範圍[編輯範圍]，然後選取下列範圍。
範圍名稱 代碼 描述
檢視內容詳細數據 read:content-details:confluence 符合準則的編目內容。
檢視群組 read:group:confluence 若要存取內容的群組許可權。
檢視使用者詳細數據 read:user:confluence 存取個別使用者詳細數據以支持許可權。
  1. 按一下儲存。
  2. 從左方的瀏覽窗格巡覽至 Authorization 。 針對 Microsoft 365 Government 新增 Microsoft 365 企業版： https://gcs.office.com/v1.0/admin/oauth/callback的回呼 URL：https://gcsgcc.office.com/v1.0/admin/oauth/callback，並儲存變更。
  3. 從左側的瀏覽窗格流覽至 [ 設定 ]。 您會從此頁面取得 [用戶端識別 符] 和 [ 秘密 ]。

使用 用戶端識別 碼和 秘密完成連線設定步驟。

6.向有限的物件推出

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

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

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

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

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

自訂安裝程式

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

使用者

訪問許可權

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

如果沒有頁面限制，連接器會檢查空間層級權限 -

  • 如果空間已啟用「匿名使用者」存取，則租使用者內的所有用戶都會看到該內容。
  • 如果未啟用「匿名存取」，則不會接受空間層級許可權。
  • 如果未定義空間層級許可權，您的租使用者中的任何使用者都看不到內容。

重要事項

許可權只會在空間和頁面層級進行管理，而且不會將父頁面許可權納入考慮。

如果您選擇 [僅限可存取此數據源的人員]，則必須進一步選擇 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 查詢語言 (CQL) 字串，您可以指定同步頁面的條件。 它就像 SQL Select 語句中的 Where 子句。 例如，您可以選擇只為過去兩年中已修改的頁面編製索引。 若要瞭解如何建立您自己的查詢字串，請參閱 使用 CQL 進行進階搜尋。 根據預設，連接器會編製所有部落格和頁面的索引。

提示

您可以使用 CQL 篩選條件，使用 lastModified >= “2018/12/31” 來編制在特定時間之後修改內容的索引

使用 [預覽結果] 按鈕來驗證所選屬性和 CQL 字串的範例值。

管理屬性

在此步驟中，您可以從 Confluence 數據源新增或移除可用的屬性。 Microsoft 365 預設已選取一些屬性。 您在這裡選取的屬性清單可能會影響您在 Microsoft 365 Copilot 中篩選、搜尋及檢視結果的方式。

Source 屬性 標籤 描述
Authors authors 參與/共同作業數據源中項目的人員名稱。
CreatedByName createdBy 最近編輯數據源中專案之人員的名稱。
CreatedOn createdDateTime 在數據源中建立專案的日期和時間。
IconUrl iconUrl 項目的相關聯圖示 URL。
標題 title 您想要在搜尋和其他體驗中顯示的項目標題。
UpdatedByName lastModifiedBy 最近編輯數據源中專案之人員的名稱。
UpdatedOn lastModifiedDateTime 上次在數據源中修改專案的日期和時間。
URL url 數據源中項目的目標 URL。

預覽數據

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

同步處理

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

檢閱和測試您的連線

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

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

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