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

# Atlassian Jira suite 為 AppFabric 設定
<a name="jira"></a>

Atlassian 釋放每個團隊的潛力。他們的敏捷性和 DevOps、IT 服務管理和工作管理軟體可協助團隊組織、討論和完成共享工作。大多數 Fortune 500 和全球超過 240，000 家大小的公司，包括 NASA、Deutsche Bank、 Kiva和 Salesforce ，都依賴Atlassian解決方案來協助其團隊更好地合作，並及時交付高品質的結果。進一步了解 Atlassian產品，包括 Jira Software、Confluence、Bitbucket、、 Jira Service Management Trello和 Jira Align [https://www.atlassian.com/](https://www.atlassian.com/)。

為了安全起見，您可以使用 AWS AppFabric 從 Jira suite( 除外Jira Align) 稽核日誌和使用者資料、將資料標準化為開放網路安全結構描述架構 (OCSF) 格式，並將資料輸出至 Amazon Simple Storage Service (Amazon S3) 儲存貯體或 Amazon Data Firehose 串流。

**Topics**
+ [的 AppFabric 支援 Jira suite](#jira-appfabric-support)
+ [將 AppFabric 連接到Jira您的帳戶](#jira-appfabric-connecting)

## 的 AppFabric 支援 Jira suite
<a name="jira-appfabric-support"></a>

AppFabric 支援從 接收使用者資訊和稽核日誌Jira suite，但 除外Jira Align。

### 先決條件
<a name="jira-prerequisites"></a>

若要使用 AppFabric 將稽核日誌從 傳輸Jira suite到支援的目的地，您必須符合下列要求：
+ 您必須擁有 Jira Standard Plan 或更高版本。如需Jira計劃功能的詳細資訊，請參閱[Jira軟體](https://www.atlassian.com/software/jira/pricing)、[Jira服務管理](https://www.atlassian.com/software/jira/service-management/pricing)、[Jira工作管理和](https://www.atlassian.com/software/jira/work-management/pricing)[Jira產品探索](https://www.atlassian.com/software/jira/product-discovery/pricing)定價頁面。
+ Jira 您的帳戶中必須有具有 **Organization 管理員**角色的使用者。如需角色的詳細資訊，請參閱Atlassian支援網站上的[授予使用者管理員許可](https://support.atlassian.com/user-management/docs/give-users-admin-permissions/)。

### 速率限制考量
<a name="jira-rate-limits"></a>

Jira 套件會對 Jira API 施加速率限制。如需 Jira suite API 速率限制的詳細資訊，請參閱《 *Atlassian 開發人員指南*》網站上的[速率限制](https://developer.atlassian.com/cloud/jira/platform/rate-limiting/)。如果 AppFabric 和現有 Jira API 應用程式的組合超過限制，AppFabric 中出現的稽核日誌可能會延遲。

### 資料延遲考量
<a name="jira-data-delay"></a>

您可能會看到稽核事件延遲最多 30 分鐘交付至目的地。這是因為應用程式提供的稽核事件延遲，以及為了減少資料遺失而採取的預防措施。不過，這可以在帳戶層級自訂。如需協助，請聯絡 [支援](https://aws.amazon.com/contact-us/)。

## 將 AppFabric 連接到Jira您的帳戶
<a name="jira-appfabric-connecting"></a>

在 AppFabric 服務中建立應用程式套件後，您必須使用 授權 AppFabricJira。若要尋找Jira使用 AppFabric 授權所需的資訊，請使用下列步驟。

### 建立 OAuth 應用程式
<a name="jira-create-oauth-application"></a>

AppFabric Jira suite使用 OAuth 與 整合。若要在 中建立 OAuth 應用程式Jira，請使用下列步驟：

1. 導覽至 [Atlassian 開發人員主控台](https://developer.atlassian.com/console/)。

1. 在**我的應用程式**旁，選擇**建立**、**OAuth 2.0 整合。**

1. 為您的應用程式命名，然後選擇**建立**。

1. 導覽至**授權**區段，然後選擇 OAuth 2.0 旁的**新增**。

1. 在**回呼 URL 欄位中，使用具有下列格式的 URL**，然後選擇**儲存**變更。

   ```
   https://<region>.console.aws.amazon.com/appfabric/oauth2
   ```

   在此 URL 中，*<region>* 是您設定 AppFabric 應用程式套件 AWS 區域 之 的程式碼。例如，美國東部 (維吉尼亞北部) 區域的代碼為 `us-east-1`。對於該區域，重新導向 URL 為 `https://us-east-1.console.aws.amazon.com/appfabric/oauth2`。

1. 導覽至**設定**區段，複製您的用戶端 ID 和用戶端秘密，並將其儲存為用於 AppFabric 應用程式授權。

### 必要範圍
<a name="jira-required-scopes"></a>

您必須將下列範圍新增至 Jira OAuth 應用程式的**許可**頁面：
+ 在傳統範圍下：
  + Jira API > `read:jira-user`
+ 在精細範圍下：
  + Jira API > `read:audit-log:jira`
  + Jira API > `read:user:jira`

### 應用程式授權
<a name="jira-app-authorizations"></a>

#### 租戶 ID
<a name="jira-tenant-id"></a>

AppFabric 將請求您的租戶 ID。AppFabric 中的租用戶 ID 是您的**Jira執行個體子網域**。您可以在瀏覽器的 **https：//** 和 .net 之間的地址列中找到**Jira執行個體子網域****atlassian。**

#### 租戶名稱
<a name="jira-tenant-name"></a>

輸入可識別此唯一Jira伺服器的名稱。AppFabric 使用租戶名稱來標記應用程式授權，以及從應用程式授權建立的任何擷取。

#### 用戶端 ID
<a name="jira-client-id"></a>

AppFabric 將請求您的用戶端 ID。若要在 Jira 中尋找您的用戶端 ID，請使用下列步驟：

1. 導覽至 [Atlassian 開發人員主控台](https://developer.atlassian.com/console/)。

1. 選取您用來連接 AppFabric 的 OAuth 應用程式。

1. 從**設定**頁面將用戶端 ID 輸入 AppFabric 中的用戶端 ID 欄位。

#### Client secret (用戶端密碼)
<a name="jira-client-secret"></a>

AppFabric 將請求您的用戶端秘密。AppFabric 中的**用戶端秘密**是 中的**秘密**Jira。若要在 中尋找您的**秘密**Jira，請使用下列步驟：

1. 導覽至 [Atlassian 開發人員主控台](https://developer.atlassian.com/console/)。

1. 選取您用來連接 AppFabric 的 OAuth 應用程式。

1. 從**設定**頁面將秘密輸入 AppFabric 中的**用戶端秘密**欄位。

#### 核准授權
<a name="jira-approve-authorization"></a>

在 AppFabric 中建立應用程式授權後，您會收到來自 的快顯視窗Jira，以核准授權。若要核准 AppFabric 授權，請選擇**允許**。