Jira 雲端整合 - Amazon Quick
您可以做什麼開始之前建立 Jira API 字符設定 Jira 整合設定身分驗證可用動作共用整合管理 Jira 整合

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Jira 雲端整合

將 Amazon Quick 連接至您的 Jira Cloud 執行個體，以管理問題、專案和其他 Jira 物件。您可以建立、更新和查詢 Jira 內容，而無需離開 Amazon Quick 環境。此整合需要 Amazon Quick Pro 層或更高版本。

您可以做什麼

透過 Jira Cloud 整合，您可以透過 Jira REST API 在 Jira 執行個體內執行動作。

動作連接器

透過 Jira REST API 建立、更新和查詢 Jira 問題、專案和其他物件。

注意

此整合僅支援動作執行。您無法使用它來建立知識庫或存取 Jira 資料以進行搜尋。

開始之前

您需要下列項目才能設定 Jira 整合：

  • 具有適當許可的 Jira Cloud 執行個體。

  • Jira 使用者帳戶或 API 字符登入資料。

  • Amazon Quick Author 或更新版本。

  • 設定 OAuth 應用程式 （用於使用者身分驗證） 的管理存取權。

建立 Jira API 字符

若要使用 API 金鑰身分驗證，請在 Atlassian 帳戶中建立 API 權杖。

  1. 前往您的 Atlassian 帳戶設定，然後選擇安全性。

  2. 為 Amazon Quick 整合建立新的 API 字符。

  3. 複製產生的字符以用於 Amazon Quick 整合設定。

  4. 請記下您的 Jira Cloud 執行個體 URL 和使用者電子郵件地址。您的 Jira Cloud 執行個體 URL 是 API 呼叫的特殊值，可透過導覽至 找到https://your-domain.atlassian.net/_edge/tenant_info。

重要

即使 API 權杖遭到撤銷或設定不當，Jira Cloud 仍可能會傳回 HTTP 200 成功回應。如需詳細資訊，請參閱 JRACLOUD-82932。如果您的整合顯示連線成功，但動作意外失敗，請確認您的 API 權杖有效且尚未撤銷。

設定 Jira 整合

請依照下列步驟，將 Amazon Quick 連線至 Jira Cloud 執行個體。

  1. 在 Amazon Quick 主控台中，選擇整合。

  2. 按一下新增 （加 "+" 按鈕）。

  3. 完成整合詳細資訊：

    • 名稱 - 輸入 Jira 整合的描述性名稱。

    • 描述 （選用） - 描述此整合的目的。

  4. 選擇連線類型 （使用者或服務身分驗證）。

  5. 根據身分驗證方法完成連線設定：

    • 對於使用者身分驗證 (OAuth)：

      • 基本 URL - 您的 Jira Cloud 執行個體 URL。這必須以下列格式提供：https://api.atlassian.com/ex/jira/instanceid。您可以透過導覽至 來找到您的執行個體 IDhttps://your-domain.atlassian.net/_edge/tenant_info。

      • 用戶端 ID - 您的 Atlassian OAuth 應用程式用戶端 ID。

      • 用戶端秘密 - 您的 Atlassian OAuth 應用程式用戶端秘密。

      • 權杖 URL - Atlassian OAuth 權杖端點。

      • 驗證 URL - Atlassian OAuth 授權端點。

      • 重新導向 URL - OAuth 重新導向 URI。

    • 對於服務身分驗證 (API 金鑰）：

      • 基本 URL - 您的 Jira Cloud 執行個體 URL。

      • API 金鑰 - 您的 Jira API 字符。

      • 電子郵件 - 與您的 Jira 使用者帳戶相關聯的電子郵件地址。

  6. 選取建立並繼續。

  7. 選取要與之共用整合的使用者。

  8. 按一下 Next (下一步)。

設定身分驗證

Jira Cloud 整合支援兩種身分驗證方法。選擇最適合您組織的方法。

使用者身分驗證 (OAuth)

當您想要在個別使用者身分下執行動作時，請使用 OAuth。設定這些欄位：

  • 基本 URL - 您的 Jira Cloud 執行個體 URL。

  • 用戶端 ID - 您的 Atlassian OAuth 應用程式用戶端 ID。

  • 用戶端秘密 - 您的 Atlassian OAuth 應用程式用戶端秘密。

  • 權杖 URL - Atlassian OAuth 權杖端點。

  • 驗證 URL - Atlassian OAuth 授權端點。

  • 重新導向 URL - OAuth 重新導向 URI。

必要的 OAuth 範圍：

  • read:jira-user - 讀取使用者資訊。

  • read:jira-work - 讀取問題、專案和工作項目。

  • write:jira-work - 建立和修改問題和工作項目。

  • manage:jira-project - 管理專案設定。

  • manage:jira-configuration - 管理 Jira 組態。

  • manage:jira-webhook - 管理 Webhook。

  • read:sprint:jira-software - 讀取衝刺資訊。

  • write:sprint:jira-software - 建立和修改衝刺。

  • delete:sprint:jira-software - 刪除衝刺。

  • write:board-scope:jira-software - 管理主機板組態。

服務身分驗證 (API 金鑰）

針對service-to-service連線使用 API 金鑰身分驗證。設定這些欄位：

  • 基本 URL - 您的 Jira Cloud 執行個體 URL。

  • API 金鑰 - 您的 Jira API 字符。

  • 電子郵件 - 與您的 Jira 使用者帳戶相關聯的電子郵件地址。

注意

由於已知的 Jira Cloud 行為，即使使用撤銷或無效的 API 字符，整合仍可能顯示成功連線。如果動作在設定後意外失敗，請確認您的 API 字符在 Atlassian 帳戶設定中仍然有效。

可用動作

建立 Jira 整合之後，您可以使用這些動作來與 Jira Cloud 互動：

  • 建立、讀取、更新和刪除 Jira 問題。

  • 管理問題轉換和工作流程。

  • 使用 JQL (Jira 查詢語言） 查詢問題。

  • 管理專案、元件和版本。

  • 將註解和附件新增至問題。

  • 管理使用者指派和監看器。

  • 存取專案並發行中繼資料。

注意

您可以使用的動作取決於 Jira Cloud 執行個體中設定的許可和身分驗證方法。

共用整合

您可以與組織中的其他使用者共用 Jira 動作連接器。

  1. 建立整合之後，請選擇共用整合。

  2. 選取您要與之共用整合的使用者或群組。

  3. 設定共用存取的適當許可。

  4. 確認您的共用設定。

管理 Jira 整合

您可以為 Jira 整合執行這些管理任務：

  • 編輯整合設定 - 更新身分驗證設定或 Jira 執行個體組態。

  • 共用整合存取 - 將整合提供給組織中的其他使用者。

  • 監控用量指標 - 檢視整合活動和 API 用量指標。

  • 檢閱可用動作 - 查看可用 Jira 動作的完整清單。

  • 刪除整合 - 移除整合並撤銷相關聯的身分驗證。