Confluence Cloud Microsoft Graph 連接器
Confluence Cloud Microsoft Graph 連接器可讓您的組織為 Confluence 內容編制索引。 設定連接器並從 Confluence 網站編製數據索引之後，用戶可以在 [Microsoft 搜尋] 中搜尋這些內容。
本文適用於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搜尋應用程式可以存取實例。 若要深入瞭解，請參閱 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 預設已選取一些屬性。
您在此處選取的屬性清單，可能會影響您在 Copilot 中篩選、搜尋及檢視結果的方式，Microsoft 365。
| Source 屬性 | Label | 描述 |
|---|---|---|
| Authors | authors |
參與/共同作業數據源中項目的人員名稱。 |
| CreatedByName | createdBy |
最近編輯數據源中專案之人員的名稱。 |
| CreatedOn | createdDateTime |
在數據源中建立專案的日期和時間。 |
| IconUrl | iconUrl |
項目的相關聯圖示 URL。 |
| 標題 | title |
您想要在搜尋和其他體驗中顯示的項目標題。 |
| UpdatedByName | lastModifiedBy |
最近編輯數據源中專案之人員的名稱。 |
| UpdatedOn | lastModifiedDateTime |
上次在數據源中修改專案的日期和時間。 |
| URL | url |
數據源中項目的目標 URL。 |
使用 Confluence 查詢語言 (CQL) 字串，您可以指定同步頁面的條件。 它就像 SQL Select 語句中的 Where 子句。 例如，您可以選擇只為過去兩年中修改的頁面編製索引。 若要瞭解如何建立您自己的查詢字串，請參閱 使用 CQL 進行進階搜尋。 根據預設，連接器會編製所有部落格和頁面的索引。
提示
您可以使用 CQL 篩選條件，使用 lastModified >= “2018/12/31” 來編制在特定時間之後修改內容的索引
使用 [預覽結果] 按鈕來驗證所選屬性和 CQL 字串的範例值。
步驟 5：管理搜尋許可權
Confluence Cloud Microsoft Graph 連接器支援 所有人 或 只有具有此數據源存取權的人員可以看見的搜尋許可權。 如果您選擇 [ 所有人]，已編製索引的數據會出現在所有使用者的搜尋結果中。 如果您選擇 [僅限可存取此數據源的人員]，則已編製索引的數據會出現在可存取此數據源之使用者的搜尋結果中。
在 Confluence Cloud 中，使用者和群組的安全性許可權是使用空間許可權和頁面限制來定義。 如果存在頁面層級限制，則優先於空間許可權。
如果沒有頁面限制，連接器會檢查空間層級權限 -
- 如果空間已啟用「匿名使用者」存取權，您的租用戶內的所有用戶都會看到內容。
- 如果未啟用「匿名存取」，則會接受空間層級許可權。
- 如果未定義空間層級許可權，您的租使用者中的任何使用者都不會看到內容。
重要事項
許可權只會在空間和頁面層級進行管理，而且不會將父頁面許可權納入考慮。
如果您選擇 [僅限可存取此數據源的人員]，您必須進一步選擇 Confluence 網站是否 Microsoft Entra ID 布建的使用者或非 AAD 使用者。
若要識別哪個選項適合您的組織：
- 如果 Confluence 使用者的電子郵件識別碼與 Microsoft Entra ID 中使用者的 UPN) (UserPrincipalName 相同，請選擇 [Microsoft Entra ID] 選項。
- 如果 Confluence 使用者的電子郵件識別碼與 userPrincipalName 不同，請選擇 [非 AAD] 選項 (Microsoft Entra ID 中使用者的 UPN) 。
注意事項
- 如果您選擇 Microsoft Entra ID 作為身分識別來源的類型，連接器會將從 Confluence 取得的使用者 Email 標識元直接對應至從 Microsoft Entra ID 取得的 UPN 屬性。
- 如果您針對身分識別類型選擇 [非 AAD]，請參閱對應 您的非 Azure AD 身 分識別以取得對應身分識別的指示。 您可以使用此選項來提供從 Email 識別碼到 UPN 的對應正規表示式。
- 對管理訪問許可權的使用者或群組 匯報 只會以完整編目同步處理。 累加編目目前不支援處理許可權的更新。
步驟 6：指派屬性標籤
請遵循一般 設定指示。
步驟 7：管理架構
請遵循一般 設定指示。
步驟 8：選擇重新整理設定
請遵循一般 設定指示。
注意事項
針對訪問許可權更新，只會套用完整編目排程。
步驟 9：檢閱連線
請遵循一般 設定指示。
發佈連線之後，您必須自定義搜尋結果頁面。 若要瞭解如何自定義搜尋結果，請參閱 自定義搜尋結果頁面。
步驟 10：設定搜尋結果頁面
發佈連線之後，您必須使用垂直和結果類型來自定義搜尋結果頁面。 若要瞭解如何自定義搜尋結果，請檢閱如何 管理垂直 和 結果類型。 您也可以使用 Confluence 雲端連接器的 範例結果配置 。 複製並貼上結果配置 JSON 以開始使用。
限制
Confluence Cloud 連接器在其最新版本中有下列已知限制：
- Confluence Cloud 連接器不會為附件檔案和批注編製索引。
- 索引伺服器和數據中心部署將會以個別連接器的形式發行。
疑難排解
發佈連線之後，您可以在系統管理中心的 [數據源] 索引卷標下檢閱狀態。 若要瞭解如何進行更新和刪除，請參閱 管理您的連接器。 您可以 在這裡找到常見問題的疑難解答步驟。
如果您有任何其他問題或想要提供意見反應，請在 Microsoft Graph 與我們連絡 |支援