Confluence Cloud Microsoft Graph 連接器
Confluence Cloud Microsoft Graph 連接器可讓您的組織為 Confluence 內容編制索引。 設定連接器並從 Confluence 網站編製數據索引之後，使用者就可以在 Microsoft Search 中搜尋這些內容。
本文適用於 Microsoft 365 系統管理員或設定、執行及監視 Confluence Cloud 連接器的任何人。 它補充 Microsoft 365 系統管理中心 文章中設定 Microsoft Graph 連接器中提供的一般指示。 如果您尚未這麼做，請閱讀整篇文章以瞭解一般設定程式。
安裝程式中的每個步驟如下所列，並附上一個附注，指出您應該遵循一般設定指示或僅適用於 Confluence Cloud 連接器的其他指示，包括 疑難解答 和 限制的相關信息。
開始之前
您必須是組織的 Microsoft 365 租用戶系統管理員，以及您組織 Confluence 網站的系統管理員。
重要事項
- 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：在 Microsoft 365 系統管理中心 中新增連接器
請遵循一般 設定指示。
步驟 2：命名連線
請遵循一般 設定指示。
步驟 3：設定連線設定
若要連線到您的 Confluence 網站，請使用您的網站 URL。 Confluence 雲端網站 URL 通常看起來像是 https://< organization_name.atlassian.net/>。 您可以選擇 [基本身份驗證] 或 [OAuth 2.0]， (建議) 向您的 Confluence 網站進行驗證。
提示
請確定服務帳戶具有您想要編製索引之 Confluence 內容的 檢視存取權 。
基本身份驗證
輸入您帳戶的使用者名稱 (通常是電子郵件識別碼) 和 API 令牌，以使用基本身份驗證進行驗證。若要深入瞭解如何產生 API 令牌，請參閱 Atlassian 的檔，以瞭解如何 管理 Atlassian 帳戶的 API 令牌。
OAuth 2.0 (建議)
在 Confluence Cloud 中註冊應用程式，讓 Microsoft Search 應用程式可以存取實例。 若要深入瞭解，請參閱 Atlassian 支援檔，以瞭解如何 啟用 OAuth 2.0。
下列步驟提供如何註冊應用程式的指引：
- 使用您的 Atlassian Confluence 系統管理員帳戶登入 Atlassian Developer 控制台 。
- 按兩下 [ 建立 ]，然後選取
OAuth 2.0 integration。 - 為應用程式提供適當的名稱，並建立新的應用程式。
- 從左方的瀏覽窗格巡覽至
Permissions。 針對 按兩下 [新增 ]Confluence API。 新增之後，按兩下列範圍[編輯範圍]，然後選取下列範圍。
| 範圍名稱 | 代碼 | 描述 |
|---|---|---|
| 檢視內容詳細數據 | read:content-details:confluence |
符合準則的編目內容 |
| 檢視群組 | read:group:confluence |
若要存取內容的群組許可權 |
| 檢視使用者詳細數據 | read:user:confluence |
存取個別使用者詳細數據以支持許可權 |
- 按一下儲存。
- 從左方的瀏覽窗格巡覽至
Authorization。 針對 M365 Enterprise：https://gcs.office.com/v1.0/admin/oauth/callback新增 M365 Government 的回呼 URL：https://gcsgcc.office.com/v1.0/admin/oauth/callback，並儲存變更。 - 從左方的瀏覽窗格巡覽至
Settings。 您會從此頁面取得Client ID與Secret。
使用 用戶端識別 碼和 秘密完成連線設定步驟。
步驟 4：選取屬性並篩選數據
在此步驟中，您可以從 Confluence 數據源新增或移除可用的屬性。 Microsoft 365 預設會選取幾個屬性。
使用 Confluence 查詢語言 (CQL) 字串，您可以指定同步頁面的條件。 它就像 SQL Select 語句中的 Where 子句。 例如，您可以選擇只為過去兩年中修改的頁面編製索引。 若要瞭解如何建立您自己的查詢字串，請參閱 使用 CQL 進行進階搜尋。 根據預設，連接器會編製所有部落格和頁面的索引。
提示
您可以使用 CQL 篩選條件，使用 lastModified >= “2018/12/31” 來編制在特定時間之後修改內容的索引
使用 [預覽結果] 按鈕來驗證所選屬性和 CQL 字串的範例值。
步驟 5：管理搜尋許可權
Confluence Cloud Microsoft Graph 連接器支援 所有人 或 只有具有此數據源存取權的人員可以看見的搜尋許可權。 如果您選擇 [ 所有人]，已編製索引的數據會出現在所有使用者的搜尋結果中。 如果您選擇 [僅限可存取此數據源的人員]，則已編製索引的數據會出現在可存取此數據源之使用者的搜尋結果中。
在 Confluence Cloud 中，使用者和群組的安全性許可權是使用空間許可權和頁面限制來定義。 如果存在頁面層級限制，則優先於空間許可權。
如果沒有頁面限制，連接器會檢查空間層級權限 -
- 如果空間已啟用「匿名使用者」存取權，您的租用戶內的所有用戶都會看到內容。
- 如果未啟用「匿名存取」，則會接受空間層級許可權。
- 如果未定義空間層級許可權，您的租使用者中的任何使用者都不會看到內容。
重要事項
許可權只會在空間和頁面層級進行管理，而且不會將父頁面許可權納入考慮。
如果您選擇 [僅限可存取此數據源的人員]，則必須進一步選擇 Confluence 網站是否已布建 Microsoft Entra 標識符的使用者或非 AAD 使用者。
若要識別哪個選項適合您的組織：
- 如果 Confluence 使用者的電子郵件識別碼與 userPrincipalName (UPN) Microsoft Entra 識別碼中的使用者相同，請選擇 [Microsoft Entra 識別符] 選項。
- 如果 Confluence 使用者的電子郵件識別碼與 UserPrincipalName 不同，請選擇 [非 AAD] 選項 (#DC8D24A8E7E6041998BA327968DCB1BF4 標識碼中使用者的 UPN) 。
注意事項
- 如果您選擇 Microsoft Entra 識別碼作為身分識別來源的類型，連接器會將從 Confluence 取得的使用者 Email 識別碼直接對應至從 Microsoft Entra 識別碼取得的 UPN 屬性。
- 如果您針對身分識別類型選擇 [非 AAD]，請參閱對應 您的非 Azure AD 身 分識別以取得對應身分識別的指示。 您可以使用此選項來提供從 Email 識別碼到 UPN 的對應正規表示式。
- 對管理訪問許可權的使用者或群組 匯報 只會以完整編目進行同步處理。 累加編目目前不支援處理許可權的更新。
步驟 6：指派屬性標籤
請遵循一般 設定指示。
步驟 7：管理架構
請遵循一般 設定指示。
步驟 8：選擇重新整理設定
請遵循一般 設定指示。
注意事項
針對訪問許可權更新，只會套用完整編目排程。
步驟 9：檢閱連線
請遵循一般 設定指示。
發佈連線之後，您必須自定義搜尋結果頁面。 若要瞭解如何自定義搜尋結果，請參閱 自定義搜尋結果頁面。
步驟 10：設定搜尋結果頁面
發佈連線之後，您必須使用垂直和結果類型來自定義搜尋結果頁面。 若要瞭解如何自定義搜尋結果，請檢閱如何 管理垂直 和 結果類型。 您也可以使用 Confluence 雲端連接器的 範例結果配置 。 複製並貼上結果配置 JSON 以開始使用。
疑難排解
設定連接器時觀察到的常見錯誤及其可能的原因如下所示。
| 設定步驟 | 錯誤訊息 | 可能的原因 () |
|---|---|---|
| 線上設定 | 要求格式不正確或不正確。 | 不正確的 Confluence 網站 URL |
| 線上設定 | 無法連線到 Confluence 網站的 Confluence 雲端服務。 | 不正確的 Confluence 網站 URL |
| 線上設定 | 用戶端沒有執行動作的許可權。 | 為基本身份驗證提供的 API 令牌無效 |
| 選取屬性 | 沒有錯誤訊息，也沒有預覽結果 | 檢查您的 CQL 查詢是否有效 |
限制
Confluence Cloud 連接器在其最新版本中有下列已知限制：
- Confluence Cloud 連接器不會為附件檔案和批注編製索引。
- 索引伺服器和數據中心部署將會以個別連接器的形式發行。