Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

將 Jira 與 Google SecOps 整合

本文說明如何將 Jira 與 Google Security Operations 整合。

用途

Jira 整合功能會使用 Google SecOps 功能，支援下列用途：

自動建立票證：使用 Jira 連接器，根據 Google SecOps 警告自動建立 Jira 問題，簡化資安和 IT 團隊之間的交接流程。
雙向同步：使用專屬同步工作，自動同步 Jira 票證和 Google SecOps 案件之間的留言和狀態變更，確保各平台資料一致。
事件資訊擴充：使用「Upload Attachment」(上傳附件) 動作，直接將證據、記錄和螢幕截圖附加至 Jira 問題，為修復人員提供完整背景資訊。
動態工作管理：直接從 Google SecOps 應對手冊更新、指派或連結相關 Jira 問題，自動執行標準作業程序 (SOP)。

事前準備

在 Google SecOps 平台中設定 Jira 整合功能前，請確認您具備下列項目：

產品相容性：可存取 Jira Cloud 執行個體或 Jira 資料中心 (地端部署) 環境。
驗證方式：選擇驗證方式。
- 基本驗證 (Jira Cloud)：需要使用者名稱 (電子郵件) 和 Atlassian API 權杖。
- 服務帳戶驗證 (Jira Cloud)：需要服務帳戶權杖和雲端 ID。
- 標準驗證 (Jira Data Center)：必須提供有效的使用者名稱和密碼。
API 根網址：API 根網址的格式取決於驗證方式。
- Standard/Basic：Jira 執行個體的基準網址 (例如 https://yourdomain.atlassian.net)。
- 服務帳戶：Atlassian API Proxy 網址，必須包含您的 Cloud ID (例如 https://api.atlassian.com/ex/jira/{cloud_id})。

設定 Jira Cloud 的驗證機制

如要使用 API 權杖連線至 Jira Cloud，請按照 Atlassian 說明文件中的指示產生權杖。

設定服務帳戶的驗證機制

如要為 Jira Cloud 使用權杖型驗證 (不記名權杖)：

如要進一步瞭解如何使用 Atlassian 管理控制台建立服務帳戶，請參閱「瞭解服務帳戶」。
如要擷取 Cloud ID，請前往： https://<your_tenant>.atlassian.net/_edge/tenant_info (其中 <your_tenant> 是您的 Atlassian 執行個體名稱)。
設定整合時，請將「Username」(使用者名稱) 欄位留空，以觸發不記名權杖驗證。

整合參數

Jira 整合需要下列參數：

參數	說明
`Api Root`	這是必填欄位。 Jira 執行個體的基準網址。注意：如果使用服務帳戶權杖進行驗證，網址必須採用以下格式：`https://api.atlassian.com/ex/jira/{cloud_id}`。
`Username`	選填。用於連結 Jira 的使用者名稱 (電子郵件地址)。這項參數是否為必要，取決於所選的驗證方式：如果提供，系統會使用基本驗證。如果留空，系統會預設為不記名權杖驗證 (服務帳戶必須使用)。如要進一步瞭解驗證方式，請參閱「事前準備」。
`Api Token`	這是必填欄位。用於連線至 Jira 的驗證憑證。這個欄位接受 API 權杖、服務帳戶權杖或標準密碼 (適用於資料中心)。
`Verify SSL`	選填。如果選取，整合功能會在連線至 Jira 伺服器時驗證 SSL 憑證。

如要瞭解如何在 Google SecOps 中設定整合功能，請參閱「設定整合功能」。

如有需要，您可以在後續階段進行變更。設定整合執行個體後，即可在應對手冊中使用。如要進一步瞭解如何設定及支援多個執行個體，請參閱「支援多個執行個體」。

動作

如要進一步瞭解動作，請參閱「在工作區回應待處理動作」和「在案件中執行手動動作」。

新增註解

使用「Add Comment」(新增註解) 動作，撰寫註解並新增至現有的 Jira 問題。

您可以直接在 Google SecOps 中記錄發現、提供最新資訊，以及與團隊成員協作。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Add Comment」動作需要下列參數：

參數說明

參數	說明
`Issue Key`	這是必填欄位。 Jira 問題的專屬 ID (例如 `PROJ-123`)。
`Comment`	這是必填欄位。要新增至 Jira 問題的文字。

Issue Key

這是必填欄位。

Jira 問題的專屬 ID (例如 PROJ-123)。

Comment

這是必填欄位。

要新增至 Jira 問題的文字。

動作輸出內容

「新增註解」動作會提供下列輸出內容：

動作輸出類型	可用性
案件總覽附件	無法使用
案件總覽連結	無法使用
案件總覽表格	無法使用
補充資訊表格	無法使用
JSON 結果	無法使用
輸出訊息	可用
指令碼執行結果	可用

指令碼執行結果

下表列出使用「Add Comment」動作時，指令碼結果輸出的值：

指令碼結果名稱	值
`comment_id`	Jira 中新建立註解的專屬 ID。

指派問題

使用「Assign Issue」動作，將 Jira 問題指派給特定使用者。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Assign Issue」動作需要下列參數：

參數說明

參數	說明
`Issue Key`	這是必填欄位。 Jira 問題的專屬 ID (例如 `PROJ-123`)。
`Assignee`	這是必填欄位。問題指派對象的使用者名稱或電子郵件地址。
`Jira Username`	選填。指派動作發起人的 Jira 使用者名稱。

Issue Key

這是必填欄位。

Jira 問題的專屬 ID (例如 PROJ-123)。

Assignee

這是必填欄位。

問題指派對象的使用者名稱或電子郵件地址。

Jira Username

選填。

指派動作發起人的 Jira 使用者名稱。

動作輸出內容

「指派問題」動作會提供下列輸出內容：

動作輸出類型	可用性
案件總覽附件	無法使用
案件總覽連結	無法使用
案件總覽表格	無法使用
補充資訊表格	無法使用
JSON 結果	無法使用
輸出訊息	可用
指令碼執行結果	可用

指令碼執行結果

下表列出使用「Assign Issue」(指派問題) 動作時，指令碼結果輸出的值：

指令碼結果名稱	值
`success`	`true`或`false`

建立快訊問題

使用「Create Alert Issue」(建立快訊問題) 動作，在 Jira 中為特定快訊建立新的票證。

這項動作主要用於應對手冊，可將資安事件提報給 IT 或工程團隊，以便進一步調查或修復。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Create Alert Issue」動作需要下列參數：

參數說明

Project Key

這是必填欄位。

建立問題的 Jira 專案專屬簡短金鑰 (例如 SEC)。

Summary

這是必填欄位。

問題的簡短標題或摘要。

Issue Type

這是必填欄位。

問題類型的名稱 (例如 Task、Bug 或 Incident)。

動作輸出內容

「建立快訊問題」動作會提供下列輸出內容：

動作輸出類型	可用性
案件總覽附件	無法使用
案件總覽連結	無法使用
案件總覽表格	無法使用
補充資訊表格	無法使用
JSON 結果	可用
輸出訊息	可用
指令碼執行結果	可用

JSON 結果

以下範例顯示動作成功建立問題時，收到的 JSON 結果輸出內容：

{
   "summary": "Sample issue",
   "description": "Create Enrich entities action using Insights API (IOC search). Write connector for alerts.",
   "project": {
      "key": "PR",
      "name": "Project 1",
      "projectTypeKey": "software"
   },
   "issuetype": {
     "name": "Task",
     "subtask": false
   },
   "status": {
      "name": "DONE",
      "statusCategory": {
         "name": "Done",
         "key": "done"
      }
   },
   "priority": {
      "name": "Medium",
      "id": "3"
   },
   "creator": {
      "displayName": "user1",
      "emailAddress": "john_doe@example.com"
   },
   "assignee": {
      "displayName": "user2",
      "emailAddress": "john_doe@example.com"
   },
   "created": "2018-06-19T15:23:13.701+0300",
   "updated": "2018-09-18T10:02:06.347+0300"
}

指令碼執行結果

下表列出使用「Create Alert Issue」(建立快訊問題) 動作時，指令碼結果輸出的值：

指令碼結果名稱	值
`issue_key`	新建立 Jira 問題的專屬簡短鍵 (例如 `SEC-456`)。

建立問題

使用「建立問題」動作，在 Jira 專案中建立新的票證。

這項動作提供多種自訂選項，包括使用 JSON 指定元件、標籤和自訂欄位，適合用於複雜的票證建立工作流程。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Create Issue」動作需要下列參數：

參數	說明
`Project Key`	這是必填欄位。建立問題的 Jira 專案專屬簡短金鑰 (例如 `SEC`)。
`Summary`	這是必填欄位。問題的簡短標題或摘要。
`Description`	選填。問題的詳細說明。
`Issue Type`	這是必填欄位。問題類型的名稱 (例如 `Task`、`Bug` 或 `Incident`)。
`Jira Username`	選填。執行動作的使用者 Jira 使用者名稱。
`Assignee`	選填。問題指派對象的使用者 ID。
`Components`	選填。以半形逗號分隔的 Jira 元件清單，用於與問題建立關聯。
`Labels`	選填。以半形逗號分隔的標籤清單，用於新增至問題。
`Custom Fields`	選填。 JSON 物件，包含建立期間要設定的其他欄位和值 (例如 `{"customfield_10001": "Value"}`)。如果發生衝突，系統會優先採用這個參數提供的值，並覆寫其他欄位對應。

動作輸出內容

「Create Issue」動作會提供下列輸出內容：

動作輸出類型	可用性
案件總覽附件	無法使用
案件總覽連結	無法使用
案件總覽表格	無法使用
補充資訊表格	無法使用
JSON 結果	可用
輸出訊息	可用
指令碼執行結果	可用

JSON 結果

以下範例顯示使用「Create Issue」動作時，收到的 JSON 結果輸出內容：

{
   "summary": "Sample issue",
   "description": "Create Enrich entities action using Insights API (IOC search). Write connector for alerts. In a couple of days we will have access to an instance.",
   "project": {
      "key": "PR",
      "name": "Project 1",
      "projectTypeKey": "software"
   },
   "issuetype": {
      "name": "Task",
      "description": "A task that needs to be done.",
      "subtask": false
   },
   "status": {
      "name": "DONE",
      "statusCategory": {
         "name": "Done",
         "key": "done",
         "colorName": "green"
      }
   },
   "priority": {
      "name": "Medium",
      "id": "3"
   },
   "resolution": {
      "name": "Done",
      "description": "Work has been completed on this issue."
   },
   "creator": {
      "displayName": "user1",
      "emailAddress": "john_doe@example.com",
      "active": true,
      "timeZone": "Asia/Jerusalem"
   },
   "assignee": {
      "displayName": "user2",
      "emailAddress": "john_doe@example.com",
      "active": true
   },
   "reporter": {
      "displayName": "user1",
      "emailAddress": "john_doe@example.com"
   },
   "labels": [
      "Label1"
   ],
   "attachment": [
      {
         "id": "1001",
         "filename": "file.rar",
         "mimeType": "binary/octet-stream",
         "size": 15420,
         "created": "2018-06-19T15:23:07.369+0300"
      }
   ],
   "created": "2018-06-19T15:23:13.701+0300",
   "updated": "2018-09-18T10:02:06.347+0300",
   "resolutiondate": "2018-09-18T10:02:06.340+0300",
   "watches": {
      "watchCount": 1,
      "isWatching": false
   }
}

指令碼執行結果

下表列出使用「Create Issue」(建立問題) 動作時，指令碼結果輸出的值：

指令碼結果名稱	值
`issue_key`	新建立 Jira 問題的專屬簡短鍵 (例如 `SEC-789`)。

刪除問題

使用「Delete Issue」動作，從 Jira 永久移除問題。

這項動作通常用於清除重複的票證，或移除在開發自動化動作期間產生的測試資料。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Delete Issue」動作需要下列參數：

參數說明

參數	說明
`Issue Key`	這是必填欄位。要刪除的 Jira 問題專屬簡短金鑰 (例如 `SEC-123`)。

Issue Key

這是必填欄位。

要刪除的 Jira 問題專屬簡短金鑰 (例如 SEC-123)。

動作輸出內容

「刪除問題」動作會提供下列輸出內容：

動作輸出類型	可用性
案件總覽附件	無法使用
案件總覽連結	無法使用
案件總覽表格	無法使用
補充資訊表格	無法使用
JSON 結果	無法使用
輸出訊息	可用
指令碼執行結果	可用

指令碼執行結果

下表列出使用「Delete Issue」動作時，指令碼結果輸出的值：

指令碼結果名稱	值
`success`	`true`或`false`

下載附件

使用「下載附件」動作，擷取附加至特定 Jira 問題的所有檔案。如果附件是 .eml 檔案，這項動作也會下載該電子郵件中的所有檔案。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Download Attachments」動作需要下列參數：

參數說明

參數	說明
`Issue Key`	這是必填欄位。 Jira 問題的專屬簡寫鍵 (例如 `SEC-123`)。
`Download Path`	選填。動作儲存下載附件的資料夾本機或內部路徑。所需格式取決於部署類型： SaaS 部署：路徑位於託管平台內部，例如 `/attachments/`。遠端代理程式部署：路徑必須是本機電腦上安裝遠端代理程式的絕對有效目錄路徑。例如，Windows 的 `C:\temp\attachments` 或 Linux 的 `/var/tmp/attachments/`。
`Download Attachments to the Case Wall`	選填。如果選取，這項動作會將 Jira 問題附件直接下載到目前的 Google SecOps 案件總覽。案件總覽中新增的附件有大小限制。大型檔案可能無法上傳。預設為停用。

Issue Key

這是必填欄位。

Jira 問題的專屬簡寫鍵 (例如 SEC-123)。

Download Path

選填。

動作儲存下載附件的資料夾本機或內部路徑。

所需格式取決於部署類型：

SaaS 部署：路徑位於託管平台內部，例如 /attachments/。
遠端代理程式部署：路徑必須是本機電腦上安裝遠端代理程式的絕對有效目錄路徑。例如，Windows 的 C:\temp\attachments 或 Linux 的 /var/tmp/attachments/。

Download Attachments to the Case Wall

選填。

如果選取，這項動作會將 Jira 問題附件直接下載到目前的 Google SecOps 案件總覽。

案件總覽中新增的附件有大小限制。大型檔案可能無法上傳。

預設為停用。

動作輸出內容

「下載附件」動作會提供下列輸出內容：

動作輸出類型	可用性
案件總覽附件	可用
案件總覽連結	無法使用
案件總覽表格	無法使用
補充資訊表格	無法使用
JSON 結果	可用
輸出訊息	可用
指令碼執行結果	可用

JSON 結果

以下範例顯示使用「下載附件」動作時，收到的 JSON 結果輸出內容：

[
  {
    "download_path": "downloads/Security_Evidence.eml",
    "attachment_details": {
      "id": "10007",
      "filename": "Security_Evidence.eml",
      "author": {
        "displayName": "Security Analyst",
        "emailAddress": "analyst@example.com",
        "active": true,
        "timeZone": "Asia/Calcutta"
      },
      "created": "2024-05-25T20:27:09.066+0530",
      "size": 12049140,
      "mimeType": "message/rfc822"
    }
  },
  {
    "download_path": "downloads/Logs_Attachment.txt",
    "attachment_details": {
      "id": "10005",
      "filename": "Logs_Attachment.txt",
      "author": {
        "displayName": "System Admin",
        "emailAddress": "admin@example.com",
        "active": true,
        "timeZone": "Asia/Calcutta"
      },
      "created": "2024-05-16T11:48:24.141+0530",
      "size": 43,
      "mimeType": "text/plain"
    }
  }
]

指令碼執行結果

下表列出使用「Download Attachments」動作時，指令碼結果輸出的值：

指令碼結果名稱	值
`is_success`	`true`或`false`

取得問題

使用「Get Issues」(取得問題) 動作，擷取一或多個 Jira 問題的完整詳細資料。

這項動作可使用目前的票證中繼資料 (例如狀態、指派對象和優先順序)，充實 Google SecOps 案件。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Get Issues」動作需要下列參數：

參數說明

參數	說明
`Issue Keys`	這是必填欄位。以半形逗號分隔的 Jira 問題索引鍵清單 (例如 `SEC-123, SEC-456`)。

Issue Keys

這是必填欄位。

以半形逗號分隔的 Jira 問題索引鍵清單 (例如 SEC-123, SEC-456)。

動作輸出內容

「Get Issues」動作會提供下列輸出內容：

動作輸出類型	可用性
案件總覽附件	無法使用
案件總覽連結	無法使用
案件總覽表格	無法使用
補充資訊表格	無法使用
JSON 結果	可用
輸出訊息	可用
指令碼執行結果	可用

JSON 結果

以下範例顯示使用「Get Issues」動作時，收到的 JSON 結果輸出內容：

{
  "issues_details_list": [
    {
      "key": "TES-65",
      "summary": "New summary",
      "description": "Detailed description of the security incident.",
      "project": {
        "key": "TES",
        "name": "test-project1",
        "projectTypeKey": "software"
      },
      "issuetype": {
        "name": "Bogue",
        "subtask": false
      },
      "status": {
        "name": "Fini",
        "statusCategory": {
          "name": "Terminé",
          "key": "done"
        }
      },
      "priority": {
        "name": "Medium",
        "id": "3"
      },
      "assignee": {
        "displayName": "Vasil Daskalov",
        "emailAddress": "vasil.daskalov@siemplify.co"
      },
      "creator": {
        "displayName": "admin@siemplifylab.local",
        "emailAddress": "admin@siemplifylab.local"
      },
      "created": "2021-08-31T12:15:22.089+0000",
      "updated": "2021-11-11T13:16:50.552+0000",
      "resolution": {
        "name": "Terminé",
        "description": "Ce ticket a été traité."
      },
      "labels": [],
      "components": []
    }
  ]
}

指令碼執行結果

下表列出使用「Get Issues」動作時，指令碼結果輸出的值：

指令碼結果名稱	值
`issues_details_list`	這份清單包含所要求 Jira 問題的完整中繼資料。

連結問題

使用「Link Issues」動作，在多個 Jira 問題之間建立關係。

這項動作主要用於自動化動作，可連結相關安全性事件，或追蹤調查單之間的依附關係。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Link Issues」動作需要下列參數：

參數說明

參數	說明
`Inward Issue ID`	這是必填欄位。以半形逗號分隔的傳入問題 ID 清單。舉例來說，如果 `Relation Type` 設為 `Blocks`，這個問題會在 Jira UI 中顯示 `is blocked by` 關係。
`Outward Issue IDs`	這是必填欄位。外部 Jira 問題的簡寫鍵。舉例來說，如果 `Relation Type` 設為 `Blocks`，這個問題會在 Jira UI 中顯示 `blocks` 關係。
`Relation Type`	這是必填欄位。要在問題之間建立的連結類型。如要查看可用的關係類型清單，請執行「List Relation Types」動作。預設值為 `Blocks`。

Inward Issue ID

這是必填欄位。

以半形逗號分隔的傳入問題 ID 清單。

舉例來說，如果 Relation Type 設為 Blocks，這個問題會在 Jira UI 中顯示 is blocked by 關係。

Outward Issue IDs

這是必填欄位。

外部 Jira 問題的簡寫鍵。

舉例來說，如果 Relation Type 設為 Blocks，這個問題會在 Jira UI 中顯示 blocks 關係。

Relation Type

這是必填欄位。

要在問題之間建立的連結類型。

如要查看可用的關係類型清單，請執行「List Relation Types」動作。

預設值為 Blocks。

動作輸出內容

「Link Issues」(連結問題) 動作會提供下列輸出內容：

動作輸出類型	可用性
案件總覽附件	無法使用
案件總覽連結	無法使用
案件總覽表格	無法使用
補充資訊表格	無法使用
JSON 結果	可用
輸出訊息	可用
指令碼執行結果	可用

輸出訊息

「Link Issues」動作可能會傳回下列輸出訊息：

輸出訊息訊息說明

輸出訊息	訊息說明
`Successfully linked issue ISSUE_ID with the following issues in Jira: ISSUE_IDS.` 動作無法在 Jira 中找到下列目的地問題： `ISSUE_IDS`。	動作成功
`Error executing action "Link Issues". Reason: ERROR_REASON`	動作失敗。請檢查伺服器連線、輸入參數或憑證。

Successfully linked issue ISSUE_ID with the following issues in Jira: ISSUE_IDS.

動作無法在 Jira 中找到下列目的地問題： ISSUE_IDS。

動作成功

Error executing action "Link Issues".
      Reason: ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用「Link Issues」動作時，指令碼結果輸出的值：

指令碼結果名稱	值
`success`	`true`或`false`

列出問題

使用「List Issues」動作，根據特定篩選條件搜尋及擷取 Jira 問題金鑰清單。

這項動作可用於找出與警告情境相符的現有票證，避免重複或在工作手冊中執行大量更新。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「List Issues」動作提供下列選用篩選參數。如未提供參數，這項動作會傳回整合使用者可存取的所有問題。

參數	說明
`Project Names`	選填。以半形逗號分隔的專案名稱清單，用於指定搜尋範圍。
`Summary`	選填。如果提供，動作會依特定摘要或標題篩選問題。
`Description`	選填。如果提供，動作會依說明中包含的文字篩選問題。
`Issue Types`	選填。以半形逗號分隔的問題類型清單 (例如 `Bug,Task`)。預設值為 `Bug`。
`Priorities`	選填。以半形逗號分隔的優先順序清單，用於篩選 (例如 `High,Medium`)。
`Created From`	選填。如果提供，動作會篩選在這個日期或之後建立的問題 (格式為 `YYYY/MM/DD`)。
`Updated From`	選填。如果提供，動作會篩選在這個日期或之後更新的問題 (格式為 `YYYY/MM/DD`)。
`Assignees`	選填。以半形逗號分隔的指派對象 ID 清單，用於篩選。
`Reporter`	選填。以半形逗號分隔的回報者 ID 清單，用於篩選。
`Statuses`	選填。以半形逗號分隔的問題狀態清單，用於篩選問題 (例如 `Open,In Progress`)。
`Created Before`	選填。篩選條件：最新建立日期。格式：`YYYY/MM/DD` 或相對偏移 (例如 `-24h`、`-7d`)。如未提供，則不會使用篩選器。
`Custom JQL`	選填。自訂 JQL 查詢。如果提供，系統會忽略所有其他篩選器。

動作輸出內容

「List Issues」動作會提供下列輸出內容：

動作輸出類型	可用性
案件總覽附件	無法使用
案件總覽連結	無法使用
案件總覽表格	無法使用
補充資訊表格	無法使用
JSON 結果	可用
輸出訊息	可用
指令碼執行結果	可用

JSON 結果

以下範例顯示使用「List Issues」動作時，收到的 JSON 結果輸出內容：

[ 
  "PR-123", 
  "PR-124",
  "SEC-789"
]

指令碼執行結果

下表列出使用「List Issues」動作時，指令碼結果輸出的值：

指令碼結果名稱	值
`issues`	這份清單包含找到的 Jira 問題專屬簡短鍵。

列出關係類型

使用「List Relation Types」(列出關係類型) 動作，擷取 Jira 執行個體中設定的所有可用連結關係類型清單。

這項動作可用於驗證連結問題動作的有效輸入值。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「List Relation Types」(列出關係類型) 動作需要下列參數：

參數	說明
`Filter Key`	選填。用於篩選關係類型的欄位。如果「篩選邏輯」設為 `Equal` 或 `Contains`，則必須選取 `Select One` 以外的欄位，以免發生執行錯誤。可能的值如下： `Name` `Inward` `Outward` 預設值為 `Select One`。
`Filter Logic`	選填。套用至篩選器的邏輯運算子。可能的值如下： `Not Specified` `Equal` `Contains` 預設值為 `Not Specified`。
`Filter Value`	選填。根據所選 `Filter Key` 和 `Filter Logic` 篩選時使用的特定字串值。如未提供值，即使已選取鍵和邏輯，也不會套用篩選器。
`Max Records To Return`	選填。結果中傳回的記錄數量上限。預設值為 `50`。

動作輸出內容

「List Relation Types」(列出關係類型) 動作會提供下列輸出內容：

動作輸出類型	可用性
案件總覽附件	無法使用
案件總覽連結	無法使用
案件總覽表格	可用
補充資訊表格	無法使用
JSON 結果	可用
輸出訊息	可用
指令碼執行結果	可用

案件總覽表格

「List Relation Types」動作會提供下表：

資料表名稱：Available Relation

表格欄：

名稱
向內
向外

JSON 結果

以下範例顯示使用「List Relation Types」動作時，收到的 JSON 結果輸出內容：

[{
    "id": "10000",
    "name": "Blocks",
    "inward": "is blocked by",
    "outward": "blocks"
}]

輸出訊息

「List Relation Types」(列出關係類型) 動作可傳回下列輸出訊息：

輸出訊息訊息說明

輸出訊息	訊息說明
`Successfully found relation types for the provided criteria in Jira.` `The filter was not applied, because parameter "Filter Value" has an empty value.`	動作成功。
`Error executing action "List Relation types". Reason: ERROR_REASON`	動作失敗。請檢查伺服器連線、輸入參數或憑證。

Successfully found relation types for the provided criteria in Jira.

The filter was not applied, because parameter "Filter Value" has an empty value.

動作成功。

Error executing action "List Relation types".
      Reason: ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用「List Relation Types」動作時，指令碼結果輸出的值：

指令碼結果名稱	值
`is_success`	`true`或`false`

乒乓

使用 Ping 動作測試與 Jira 的連線。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

無

動作輸出內容

Ping 動作會提供下列輸出內容：

動作輸出類型	可用性
案件總覽附件	無法使用
案件總覽連結	無法使用
案件總覽表格	無法使用
補充資訊表格	無法使用
JSON 結果	無法使用
輸出訊息	可用
指令碼執行結果	可用

指令碼執行結果

下表列出使用 Ping 動作時，指令碼結果輸出的值：

指令碼結果名稱	值
`success`	`true`或`false`

更新問題

說明

更新問題。如果是新的 Jira API，動作會嘗試根據使用者電子郵件，找出指派對象來指派問題，然後嘗試使用 displayName 欄位。

參數

參數	類型	預設值	為必填	說明
問題鍵	字串	不適用	是	要更新的問題鍵。
狀態	字串	不適用	否	指定相關轉換名稱，將這個問題轉換為所需的新狀態。
摘要	字串	不適用	否	問題的新摘要。
說明	字串	不適用	否	問題的新說明。
問題類型	字串	不適用	否	問題的新類型。
指派對象	字串	不適用	否	問題的新指派對象。
Jira 使用者名稱	字串	不適用	否	動作發起人的 Jira 使用者名稱。
元件	字串	不適用	否	問題的元件欄位。這個參數接受多個值，請以半形逗號分隔。
自訂欄位	JSON	不適用	否	指定 JSON 物件，其中包含建立問題時使用的所有欄位和值。注意：這個參數具有優先權，所有欄位都會覆寫為這個參數提供的值。範例：{"field":"value"}
標籤	字串	不適用	否	問題的元件欄位。這個參數接受多個值，請以半形逗號分隔。

執行日期

這項操作會對所有實體執行。

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項	範例
成功	True/False	Success:False

JSON 結果

{
   "comment":
     {
       "total": 0,
       "startAt": 0,
       "comments": [],
       "maxResults": 0
      },
   "creator":
     {
       "displayName": "user1",
       "name": "user1",
       "self": "",
       "avatarUrls":
          {
            "24x24": "",
            "16x16": "",
            "48x48": "",
            "32x32": ""
           },
        "emailAddress": "john_doe@example.com",
        "key": "user1user",
        "active": true,
        "timeZone": "Asia/Jerusalem",
        "accountId": "0"
       },
   "aggregatetimeestimate": null,
   "labels": ["Label1"],
   "aggregatetimespent": null,
   "watches":
      {
        "self": "",
        "watchCount": 1,
        "isWatching": false
       },
   "assignee":
      {
        "displayName": "user2",
        "name": "user2",
        "self": "",
        "avatarUrls":
           {
              "24x24": "",
              "16x16": "",
              "48x48": "",
              "32x32": ""
            },
        "emailAddress": "john_doe@example.com",
        "key": "user2",
        "active": true,
        "timeZone": "Asia/Jerusalem",
        "accountId": ""
       },
   "lastViewed": "2019-01-22T10:14:02.910+0200",
   "issuelinks": [],
   "Worklog":
      {
        "worklogs": [],
        "total": 0,
        "startAt": 0,
        "maxResults": 20
       },
   "aggregateprogress":
      {
        "progress": 0,
        "total": 0
       },
   "Priority":
      {
        "iconUrl": "",
        "self": "",
        "name": "Medium",
        "id": "3"
       },
   "votes":
       {
          "hasVoted": false,
          "self": "",
          "votes": 0
        },
   "workratio": -1,
   "fixVersions": [],
   "environment": null,
   "timespent": null,
   "attachment":
      [{
          "mimeType": "binary/octet-stream",
          "created": "2018-06-19T15:23:07.369+0300",
          "self": "",
          "author":
             {
               "displayName": "user1",
               "name": "user1",
               "self": "",
               "avatarUrls":
                  {
                     "24x24": "",
                     "16x16": "",
                     "48x48": "",
                     "32x32": ""
                   },
               "emailAddress": "john_doe@example.com",
               "key": "user1",
               "active": true,
               "timeZone": "Asia/Jerusalem",
               "accountId": "0"
              },
           "filename": "file.rar",
           "content": "",
           "id": "0",
           "size": 0
        }],
   "progress":
        {
          "progress": 0,
          "total": 0
         },
   "duedate": null,
   "status":
        {
          "statusCategory":
              {
                 "name": "Done",
                 "self": "",
                 "id": 3,
                 "key": "done",
                 "colorName": "green"
               },
          "description": "",
          "self": "",
          "iconUrl": "",
          "id": "0",
          "name": "DONE"
         },
   "updated": "2018-09-18T10:02:06.347+0300",
   "subtasks": [],
   "description": "Create Enrich entities action using Insights API (IOC search)\\n\\nWrite connector for laerts\\n\\nIn a couple of days we will have access to an instance",
   "reporter":
         {
           "displayName": "user1",
           "name": "user1",
           "self": "",
           "avatarUrls":
               {
                 "24x24": "",
                 "16x16": "",
                 "48x48": "",
                 "32x32": ""
               },
           "emailAddress": "john_doe@example.com",
           "key": "user1",
           "active": true,
           "timeZone": "Asia/Jerusalem",
           "accountId": "0"
          },
    "timeoriginalestimate": null,
    "aggregatetimeoriginalestimate": null,
    "created": "2018-06-19T15:23:13.701+0300",
    "versions": [],
    "resolutiondate": "2018-09-18T10:02:06.340+0300",
    "summary": "Sample issue",
    "project":
          {
             "name": "Project 1",
             "self": "",
             "projectTypeKey": "software",
             "avatarUrls":
                 {
                   "24x24": "",
                   "16x16": "",
                   "48x48": "",
                   "32x32": ""
                  },
             "key": "PR",
             "id": "0"
           },
    "timetracking": {},
    "components": [],
    "issuetype":
          {
             "name": "Task",
             "self": "",
             "iconUrl": "",
             "subtask": false,
             "avatarId": 10318,
             "id": "10002",
             "description": "A task that needs to be done."
           },
    "security": null,
    "resolution":
           {
             "id": "10000",
             "self": "",
             "description": "Work has been completed on this issue.",
              "name": "Done"
             },
    "timeestimate": null
}

上傳附件

說明

在問題中新增附件。

參數

參數類型預設值為必填說明

問題鍵字串不適用是檔案路徑。

檔案路徑

字串

不適用

是

參數	類型	預設值	為必填	說明
問題鍵	字串	不適用	是	檔案路徑。
檔案路徑	字串	不適用	是	要上傳的檔案絕對路徑，以半形逗號分隔。所需格式取決於部署類型： SaaS 部署：路徑位於託管平台內部，例如 `/attachments/`。遠端代理程式部署：路徑必須是本機電腦上安裝遠端代理程式的絕對有效目錄路徑。例如，Windows 的 `C:\temp\attachments` 或 Linux 的 `/var/tmp/attachments/`。

要上傳的檔案絕對路徑，以半形逗號分隔。

所需格式取決於部署類型：

SaaS 部署：路徑位於託管平台內部，例如 /attachments/。
遠端代理程式部署：路徑必須是本機電腦上安裝遠端代理程式的絕對有效目錄路徑。例如，Windows 的 C:\temp\attachments 或 Linux 的 /var/tmp/attachments/。

執行日期

這項操作會對所有實體執行。

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

N/A

搜尋使用者

在 Jira 中搜尋使用者。

實體

這項動作不會對實體執行。

動作輸入內容

如要設定動作，請使用下列參數：

參數
`User Email Addresses`	選用以半形逗號分隔的電子郵件地址清單，用於傳回使用者。
`User Names`	選用以半形逗號分隔的使用者名稱清單，用於傳回使用者。
`Project`	選用要搜尋電子郵件地址的專案名稱。如果提供，則只會傳回 `Project Assignable Users`。

動作輸出內容

動作輸出類型
案件總覽附件	不適用
案件總覽連結	不適用
案件總覽表格	不適用
補充資訊表格	不適用
JSON 結果	可用
指令碼執行結果	可用

指令碼執行結果

指令碼結果名稱	值
is_success	True/False

JSON 結果

[
 {
   "Entity": "example",
   "EntityResult": {
     "_resource": "user?accountId={0}",
     "_options": {
       "server": "https://siemplify.atlassian.net",
       "auth_url": "/rest/auth/1/session",
       "context_path": "/",
       "rest_path": "api",
       "rest_api_version": "2",
       "agile_rest_path": "agile",
       "agile_rest_api_version": "1.0",
       "verify": false,
       "resilient": true,
       "async": false,
       "async_workers": 5,
       "client_cert": null,
       "check_update": false,
       "delay_reload": 0,
       "headers": {
         "Cache-Control": "no-cache",
         "Content-Type": "application/json",
         "X-Atlassian-Token": "no-check"
       }
     },
     "_session": "<jira.resilientsession.ResilientSession object>",
     "_base_url": "{server}/rest/{rest_path}/{rest_api_version}/{path}",
     "raw": {
       "self": "https://siemplify.atlassian.net/rest/api/2/user?accountId=example-account-id",
       "accountId": "example-account-id",
       "accountType": "atlassian",
       "emailAddress": "example.user",
       "avatarUrls": {
         "48x48": "https://example.com"
       },
       "displayName": "Example",
       "active": true,
       "timeZone": "UTC",
       "locale": "en_US"
     },
     "self": "https://siemplify.atlassian.net/rest/api/2/user?accountId=example-account-id",
     "accountId": "example-account-id",
     "accountType": "atlassian",
     "emailAddress": "example.user",
     "avatarUrls": "<jira.resources.PropertyHolder object>",
     "displayName": "Example",
     "active": true,
     "timeZone": "UTC",
     "locale": "en_US"
   }
 }
]

案件總覽

這項動作會提供下列輸出訊息：

輸出訊息訊息說明

輸出訊息	訊息說明
`Successfully found the following users in Jira for project PROJECT_NAME: USER_LIST` `The following users were not found in Jira for project PROJECT_NAME: USER_LIST` `None of the provided users were found in the project PROJECT_NAME`	動作成功。
`Error executing action "Search Users". Reason: ERROR_REASON`	動作失敗。請檢查伺服器連線、輸入參數或憑證。

Successfully found the following users in Jira for project PROJECT_NAME: USER_LIST

The following users were not found in Jira for project PROJECT_NAME: USER_LIST

None of the provided users were found in the project PROJECT_NAME

動作成功。

Error executing action "Search Users".
      Reason: ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

關閉原因對應設定

Closed Reason Mapping 參數需要 JSON 結構。您可以對應靜態值，或傳遞動態 Jira 欄位名稱 (例如 resolution、customfield_10010)。如果擷取的動態原因無效或遺漏，工作會自動使用指定的 Fallback 對應。

JSON 設定範例：

{
  "Done": {
    "reason": "Maintenance",
    "root_cause": "Other"
  },
  "Fallback": {
    "reason": "Maintenance",
    "root_cause": "Other"
  }
}

連接器

Jira 連接器

說明

從 Jira 擷取問題並傳送至 Google SecOps。

在 Google SecOps 中設定 Jira 連接器

如要瞭解如何在 Google SecOps 中設定連接器，請參閱「設定連接器」一文。

連接器參數

使用下列參數設定連接器：

參數	說明
`DeviceProductField`	這是必填欄位。用於判斷裝置產品的欄位名稱。預設值為 `device_product`。
`EventClassId`	選填。用於判斷事件名稱 (子類型) 的欄位名稱。預設值為 `name`。
`PythonProcessTimeout`	這是必填欄位。執行目前指令碼的 Python 程序逾時限制 (以秒為單位)。預設值為 `60`。
`API Root`	這是必填欄位。 Jira 執行個體的 API 根目錄。注意：如果使用服務帳戶權杖進行驗證，網址必須採用以下格式：`https://api.atlassian.com/ex/jira/{cloud_id}`。預設值為 `https://{jira_address}`。
`Username`	選填。用於連結 Jira 的使用者名稱 (電子郵件地址)。這項參數是否為必要，取決於所選的驗證方式：如果提供，系統會使用基本驗證。如果留空，系統會預設為不記名權杖驗證 (服務帳戶必須使用)。如要進一步瞭解驗證方式，請參閱「事前準備」。
`API Token`	這是必填欄位。用於連線至 Jira 的驗證憑證。注意：這個欄位接受 API 權杖、服務帳戶權杖或標準密碼 (適用於資料中心)。
`Days Backwards`	選填。擷取快訊的最早天數。預設值為 `5`。
`Max Tickets Per Cycle`	選填。在一個連接器週期內擷取及處理的票證數量上限。預設值為 `10`。
`Project Names`	選填。專案名稱，以半形逗號分隔。
`Issue Statuses`	選填。問題狀態，以半形逗號分隔。
`Assignees`	選填。使用者的全名，以半形逗號分隔。
`Issue Types`	選填。問題類型，以半形逗號分隔。
`Issue Priorities`	選填。問題優先順序，以半形逗號分隔。
`Issue Components`	選填。問題元件，以半形逗號分隔。
`Proxy Server Address`	選填。要使用的 Proxy 伺服器位址。
`Proxy Username`	選填。用於驗證的 Proxy 使用者名稱。
`Proxy Password`	選填。用於驗證的 Proxy 密碼。
`Environment Field Name`	選填。說明儲存環境名稱的欄位名稱。如果找不到環境欄位，則環境為預設環境。預設值為 `""`。
`Environment Regex Pattern`	選填。要對「環境欄位名稱」欄位中的值執行的規則運算式模式。用於允許使用者透過規則運算式邏輯操控環境欄位。預設值為 `.*`。
`Use Jira Project as Environment`	選填。使用 Jira 專案做為環境，或使用環境欄位名稱做為環境。
`Verify SSL`	這是必填欄位。如果選取，整合功能會在連線至 Jira 伺服器時驗證 SSL 憑證。 (預設為啟用)。

連接器規則

Proxy 支援

連接器支援 Proxy。

動態清單和封鎖清單

連接器僅支援 Jira 內特定標籤的動態清單和封鎖清單規則。

工作

同步處理關閉工作

說明

如果對應的 Google SecOps 警示或案件已關閉，則關閉 Jira 中的票證，並將 Jira 的關閉狀態和自訂欄位同步回 Google SecOps。

參數

參數	說明
`API Root`	這是必填欄位。 Jira 執行個體 API 根網址。注意：如果使用服務帳戶權杖進行驗證，網址必須採用以下格式：`https://api.atlassian.com/ex/jira/{cloud_id}`。預設值為 `https://{jira_address}`。
`Username`	選填。用於連結 Jira 的使用者名稱 (電子郵件地址)。這項參數是否為必要，取決於所選的驗證方式：如果提供，系統會使用基本驗證。如果留空，系統會預設為不記名權杖驗證 (服務帳戶必須使用)。
`API Token`	這是必填欄位。用於連線至 Jira 的驗證憑證。注意：這個欄位接受 API 權杖、服務帳戶權杖或標準密碼 (適用於資料中心)。
`Project Names`	這是必填欄位。工作應監控的 Jira 專案名稱，以半形逗號分隔。預設值為 `project names separated by a comma`。
`Environment`	選填。環境名稱。
`Days Backwards`	這是必填欄位。同步處理過往票證狀態的天數上限。預設值為 `1`。
`Job Scope`	這是必填欄位。工作同步處理的範圍。選項： `Case`：在案件層級同步處理 Jira 問題。確認情境包含 `JIRA_ISSUE_KEY`。 `Alert`：在快訊層級同步處理 Jira 問題。如果是連接器建立的案件，系統會自動擷取 Jira 票證金鑰。如果是模擬案件，請手動將情境索引鍵設為 `JIRA_ISSUE_KEY`。預設值為 `Alert`。
`Supported Closed Statuses`	這是必填欄位。以半形逗號分隔的 Jira 關閉狀態清單，在 Google SecOps 中視為關閉 (例如 `Done, Closed`)。 SecOps 到 Jira：工作會使用清單中的第一個值 (例如 `Done`)，做為關閉 Jira 票證時的解決狀態。 Jira 到 SecOps：Jira 票證的關閉狀態必須存在於這份清單中，才能進行同步。預設值為 `Done`。
`Closed Reason Mapping`	這是必填欄位。 JSON 字典，將 Jira 關閉狀態對應至 Google SecOps 關閉原因和根本原因。支援對應至自訂欄位，且必須提供 `Fallback` 鍵。如需設定詳細資料和範例，請參閱「關閉原因和自訂欄位對應」。
`Custom Fields Mapping`	選填。 JSON 物件，定義 Google SecOps 自訂欄位顯示名稱與 Jira 自訂欄位名稱之間的對應關係，用於將資料從 Jira 同步至 Google SecOps。如需設定詳細資料和範例，請參閱「關閉原因和自訂欄位對應」。

關閉原因和自訂欄位對應

請參考下列詳細資料和範例，設定關閉原因和自訂欄位的自訂對應。

Closed Reason Mapping

定義 Jira 關閉狀態如何對應至 Google SecOps 案件或快訊關閉原因和根本原因。

標準 JSON 對應範例：
```
{
  "Done": {
    "reason": "Malicious",
    "root_cause": "Other"
  },
  "Fallback": {
    "reason": "Maintenance",
    "root_cause": "Other"
  }
}
```
如果 Jira 工單以「Done」狀態關閉，Google SecOps 案件或快訊會以「Malicious」原因和「Other」根本原因關閉。如果票證關閉時的狀態未明確對應 (例如 Closed)，系統會預設為 Fallback 設定。
自訂欄位對應範例：

如果 Jira 中有名為 Jira reason 和 Jira rootcause 的自訂欄位，請按照下列方式設定 JSON 對應：
```
{
  "Done": {
    "reason": "Jira reason",
    "root_cause": "Jira rootcause"
  },
  "Fallback": {
    "reason": "Maintenance",
    "root_cause": "Other"
  }
}
```
必要操作：
- 從 Jira reason 自訂欄位擷取的值必須解析為下列其中一個確切字串：Malicious、Maintenance、Inconclusive 或 Not malicious。否則，系統會還原為 Fallback 值。
- 如要使用 Case 工作範圍，必須在管理員設定中設定根本原因值。如果是 Alert 工作範圍，則不需進行管理員設定，且系統會接受自訂欄位中提供的任何值。

自訂欄位對應

這項對應功能僅用於將自訂欄位值從 Jira 同步至 Google SecOps。指定鍵/值組合，其中鍵是 Google SecOps 自訂欄位顯示名稱，值是 Jira 自訂欄位名稱：

{
  "SOAR Custom field": "Jira ticket id"
}

在這個範例中，Jira 欄位 Jira ticket id 的值會直接同步至 Google SecOps 欄位 SOAR Custom field。

同步處理留言工作

說明

在 Google SecOps 案件和對應的 Jira 票證之間同步註解。同步處理是雙向的，也就是從 Google SecOps 到 Jira，以及從 Jira 到 Google SecOps。

工作建立註解時，會套用前置字元。如果 Google SecOps 使用者在 Google SecOps 案件中留言，這項工作會使用「Chronicle Comment Prefix」參數，在對應的 Jira 票證中建立及同步處理使用者留言。

這項功能有兩個用途：

掌握情報：
防止工作新增的註解再次同步到另一端，導致循環。

參數

參數	說明
`API Root`	這是必填欄位。 Jira 執行個體 API 根網址。注意：如果使用服務帳戶權杖進行驗證，網址必須採用以下格式：`https://api.atlassian.com/ex/jira/{cloud_id}`。預設值為 `https://{jira_address}`。
`Username`	選填。用於連結 Jira 的使用者名稱 (電子郵件地址)。這項參數是否為必要，取決於所選的驗證方式：如果提供，系統會使用基本驗證。如果留空，系統會預設為不記名權杖驗證 (服務帳戶必須使用)。
`API Token`	這是必填欄位。用於連線至 Jira 的驗證憑證。注意：這個欄位接受 API 權杖、服務帳戶權杖或標準密碼 (適用於資料中心)。
`Project Names`	這是必填欄位。工作應監控的 Jira 專案名稱，以半形逗號分隔。預設值為 `project names separated by comma`。
`Environment`	選填。環境名稱。
`Siemplify Comment Prefix`	這是必填欄位。同步處理工作為 Jira 支援單建立的註解新增的前置字元。預設值為 `Google SecOps:`。
`Jira Comment Prefix`	這是必填欄位。同步工作新增至 Google SecOps 警示案件註解的前置字串。預設值為 `Jira Comment Sync Job:`。

還有其他問題嗎？向社群成員和 Google SecOps 專業人員尋求解答。