Microsoft 365 Copilot 與 Microsoft Search 的 Jira Cloud 連接器,讓您的組織能直接在 Microsoft 365 體驗中索引並搜尋 Jira Cloud 內容。 透過將 Jira Cloud 與 Microsoft 365 整合,使用者可以透過 Copilot 與 Microsoft Search 發現問題、專案及其他 Jira 資料,提升生產力與協作效率。
本文提供 Jira Cloud 管理員需要完成的設定步驟,以便您的組織能部署 Jira Cloud Copilot 連接器。
關於如何部署連接器的資訊,請參見 Jira Cloud Copilot 連接器。
必要條件
在開始之前,請確保你符合以下先決條件:
- 你必須是 Jira Cloud 網站管理員 ,並且是 Microsoft 365 全域管理員。
- 確認 Jira REST API 是否已啟用且可存取。
- 如果有網路限制,請確保你的組織允許對 Microsoft Graph 連接器 IP 進行外發連線。
- 務必確保你能使用 Atlassian 開發者控制台。
設定檢查清單
| 工作 | 角色 |
|---|---|
| 識別 Jira Cloud 實例的網址 | Jira 管理員 |
| 啟用 API 存取 | Jira 管理員 |
| 建立 OAuth 2.0 應用程式 | Jira 管理員 |
| 定義屬性映射 | Jira 管理員 |
| 建立一個服務帳號 | Jira 管理員 |
| 估算內容範圍 | Jira 管理員 |
識別 Jira Cloud 實例的網址
在 Microsoft 365 系統管理中心部署連接器時,必須提供 Jira Cloud 實例網址。 要辨識 Jira Cloud 實例的網址:
- 請登入您的 Jira Cloud 帳號。
https://<yourcompany>.atlassian.net - 在儀表板上,注意瀏覽器網址列的 基礎網址 。 例如:
https://<yourcompany>.atlassian.net。
注意事項
- 不要使用專案專屬的網址,例如
/browse/PROJ-123) (。 - 在瀏覽器中測試該網址,確認它是否會解析到你的 Jira 儀表板。
啟用 API 存取
確認 Jira Cloud REST API 是否預設啟用,且沒有 API 限制或應用程式允許清單阻止存取。
如果您的組織使用網路層級的限制,請將 Microsoft Graph 連接器的 IP 加入允許清單。
建立 OAuth 2.0 應用程式
部署連接器時,你需要客戶 端 ID 和 客戶端秘密 來進行 OAuth 2.0 認證。 要建立 OAuth 2.0 應用程式:
- 請使用 https://developer.atlassian.com/console/myapps/ 您的 Jira 管理員帳號登入。
- 選擇 建立 並選擇 OAuth 2.0 整合。
- 輸入應用程式名稱並建立它。
- 在 授權中,新增回調網址:
https://gcs.office.com/v1.0/admin/oauth/callback - 從設定複製客戶端 ID 和客戶端秘密。
定義屬性映射
在 Microsoft 365 Copilot 連接器中設定屬性映射,以判斷 Jira 資料在 Microsoft 365 Copilot 與 Microsoft Search 體驗中的呈現方式。
建立一個服務帳號
要建立服務帳號:
- 以組織或網站管理員身份登入 Atlassian 管理員主台。
- 前往 目錄 > 使用者。
- 選擇邀請使用者並輸入專用電子郵件地址,例如:
jira-connector@yourdomain.com不要使用個人帳號。 - 在 產品中,選擇 Jira Software。
- 除非必要,不要指派管理員或專案管理員角色。
- 請確保帳號有「 瀏覽專案 」和 「檢視議題 」的權限。
估算內容範圍
決定要索引的專案和議題數量。 例如,超過一萬期的例子:
- 啟用增量同步。
- 要規劃降頻。
- 完整索引可能需要數小時。 安排在非營業時間進行初步同步。