FireEye CM
本文說明如何將 FireEye CM 與 Google Security Operations 整合。
應用實例
- 擷取 Trellix Central Management 警示,並用於建立 Google Security Operations 警示。接著,在 Google SecOps 中,警示可用於透過應對手冊或手動分析執行自動化調度管理。
- 執行主動動作:使用 Google SecOps 的 Trellix Central Management 代理程式下載快訊構件、建立規則、IOC 動態饋給
在 Google SecOps 中設定 FireEye CM 整合
如要瞭解如何在 Google SecOps 中設定整合功能,請參閱「設定整合功能」一文。
整合參數
請使用下列參數設定整合:
| 參數顯示名稱 | 類型 | 預設值 | 為必填項目 | 說明 |
|---|---|---|---|---|
| 執行個體名稱 | 字串 | 不適用 | 否 | 要設定整合的執行個體名稱。 |
| 說明 | 字串 | 不適用 | 否 | 執行個體的說明。 |
| API 根層級 | 字串 | https://: |
是 | Trellix Central Management 伺服器的 API 根目錄。 |
| 使用者名稱 | 字串 | 不適用 | 是 | Trellix Central Management 帳戶的使用者名稱。 |
| 密碼 | 密碼 | 不適用 | 是 | Trellix Central Management 帳戶的密碼。 |
| 驗證 SSL | 核取方塊 | 已勾選 | 是 | 如果已啟用,請確認連至 Trellix Central Management 伺服器的 SSL 憑證有效。 |
| 遠端執行 | 核取方塊 | 已取消勾選 | 否 | 勾選這個欄位,即可從遠端執行設定的整合項目。勾選後,系統會顯示選取遠端使用者 (代理) 的選項。 |
動作
乒乓
說明
在 Google SecOps Content Hub 頁面的整合設定頁面,使用提供的參數測試與 Trellix 集中式管理 的連線能力。
執行日期
這項動作不會對實體執行,也沒有必要輸入參數。
動作執行結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
案件總覽
| 結果類型 | 值 / 說明 | 類型 |
|---|---|---|
| 輸出訊息* | 動作不應失敗或停止執行應對手冊: if successful: 動作應失敗並停止執行應對手冊: 如果未成功: 列印「Failed to connect to the Trellix Central Management server! 錯誤為 {0}".format(exception.stacktrace) |
一般 |
新增 IOC 動態饋給
說明
根據實體,在 Trellix Central Management 中新增 IOC 動態饋給。僅支援 MD5 和 SHA256 雜湊。
參數
| 參數顯示名稱 | 類型 | 預設值 | 為必填項目 | 說明 |
|---|---|---|---|---|
| 動作 | DDL | 快訊 可能的值 快訊 封鎖 |
是 | 指定新動態饋給應執行的動作。 |
| 註解 | 字串 | 不適用 | 否 | 為動態饋給提供其他意見。 |
| 擷取網域 | 核取方塊 | 不適用 | 是 | 如果啟用,動作會從網址擷取網域部分,並用於建立 IOC 動態饋給。 |
執行日期
這項動作會對下列實體執行:
- IP 位址
- 網址
- 雜湊 (MD5/SHA256)
動作執行結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
案件總覽
| 結果類型 | 值 / 說明 | 類型 |
|---|---|---|
| 輸出訊息* | 動作不應失敗或停止執行應對手冊: if status code 200 for at least one entity type(is_success = true): if some of the entity types were not used properly (is_success =true) : 如果沒有任何實體成功用於建立動態饋給:(is_success=false) 動作應失敗並停止執行應對手冊: 如果發生嚴重錯誤,例如憑證錯誤、無法連線至伺服器等: 列印「執行『新增 IOC 動態饋給』動作時發生錯誤。原因:{0}''.format(error.Stacktrace) |
一般 |
刪除 IOC 動態饋給
說明
在 Trellix Central Management 中刪除 IOC 動態饋給。
參數
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 動態饋給名稱 | 字串 | 不適用 | 是 | 指定要刪除的動態饋給名稱。 |
執行日期
這項動作不會對實體執行,也沒有必要輸入參數。
動作執行結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
案件總覽
| 結果類型 | 值 / 說明 | 類型 |
|---|---|---|
| 輸出訊息* | 這項動作不應失敗,也不應停止執行自動化教戰手冊: if status code 200 and feedName was found in the list for last request (is_success = false): "Action wasn't able to delete feed '{0}' in Trellix Central Management. 如果一開始沒有動態饋給名稱:「動作無法刪除 Trellix Central Management 中的 IOC 動態饋給」。原因:找不到動態饋給「{feed_name}」。 動作應失敗並停止執行應對手冊: |
一般 |
列出隔離的電子郵件
說明
列出隔離的電子郵件。必須將 FireEye EX 連結至 Trellix Central Management。
參數
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 開始時間 | 字串 | 不適用 | 否 | 如果指定,則只會傳回在開始時間後建立的電子郵件。如未指定開始和結束時間,這項動作會傳回過去 24 小時內隔離的電子郵件。格式:YYYY-MM-DD'T'HH:MM:SS.SSS-HHMM |
| 結束時間 | 字串 | 不適用 | 否 | 如果指定,系統只會傳回在結束時間前建立的電子郵件。如未指定開始和結束時間,這項動作會傳回過去 24 小時內隔離的電子郵件。格式:YYYY-MM-DD'T'HH:MM:SS.SSS-HHMM |
| 寄件者篩選器 | 字串 | 不適用 | 否 | 如果指定,則只會傳回這位寄件者所有遭隔離的電子郵件。 |
| 主旨篩選器 | 字串 | 不適用 | 否 | 如果指定,則只會傳回具有這個主旨的所有隔離電子郵件。 |
| 要傳回的電子郵件數量上限 | 字串 | 50 | 否 | 指定要傳回的電子郵件數量。上限為 10,000。這是 Trellix Central Management 的限制。 |
執行日期
這項動作不會對實體執行,也沒有必要輸入參數。
動作執行結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON 結果
[
{
"completed_at": "2020-06-09T08:21:17",
"email_uuid": "x-x-x-x-x",
"quarantine_path": "/data/email-analysis/quarantine2/2020-06-09/08/49h33n3HZczxNgc",
"subject": "qwe",
"message_id": "ec7d161d-c0f5-7e32-8f53-468393ccc9b6@fex2-lab.local",
"from": "xxxx.xxxx2@xxxx-xxx.xxxx",
"queue_id": "49h33n3HZczxNgc"
},
{
"completed_at": "2020-06-09T08:21:42",
"email_uuid": "58800022-51f7-4b07-b6b1-c5d88434283f",
"quarantine_path": "/data/email-analysis/quarantine2/2020-06-09/08/49h34G5TVczxNgg",
"subject": "rew",
"message_id": "625607a6-a99d-004a-4ad6-69c3ec795168@fex2-lab.local",
"from": "xxxx.xxxx2@xxxx-xxx.xxxx",
"queue_id": "49h34G5TVczxNgg"
}
]
案件總覽
| 結果類型 | 值/說明 | 類型 |
|---|---|---|
| 輸出訊息* | 這項動作不應失敗,也不應停止執行應對手冊: 如果沒有可用資料 (is_success = true):「No quarantined emails were found in Trellix Central Management!」 動作應失敗並停止執行自動化動作: |
一般 |
| 案件總覽表格 | 名稱:隔離的電子郵件 資料欄:
|
釋出隔離的電子郵件
說明
釋出隔離的電子郵件。必須將 FireEye EX 連結至 Trellix Central Management。
參數
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 佇列 ID | 字串 | 不適用 | 是 | 指定要釋出的電子郵件佇列 ID。 |
| 感應器名稱 | 字串 | 不適用 | 否 | 指定感應器名稱,釋出隔離的電子郵件。如未指定,動作會嘗試自動尋找感應器。 |
執行日期
這項動作不會對實體執行,也沒有必要輸入參數。
動作執行結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
案件總覽
| 結果類型 | 值 / 說明 | 類型 |
|---|---|---|
| 輸出訊息* | 動作不應失敗,也不應停止執行自動化動作: if status code 200 and response is not empty (is_success = false): "Email with queue id {0} was not released. 原因:{1}」。 如果發生嚴重錯誤 (例如憑證錯誤、無法連線至伺服器等),動作應失敗並停止執行自動化動作: 如果系統未自動找到感應器:「執行『釋出隔離電子郵件』動作時發生錯誤。原因:找不到 FireEye EX 裝置的感應器。請在「Sensor Name」參數中手動提供。''.format(error.Stacktrace) 如果提供的感應器無效:「執行『釋出隔離電子郵件』動作時發生錯誤。原因:找不到 FireEye EX 裝置名稱為「{0}」的感應器。請檢查拼字。''.format(error.Stacktrace) |
一般 |
下載隔離的電子郵件
說明
下載隔離的電子郵件。必須將 FireEye EX 連結至 Trellix Central Management。
參數
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 佇列 ID | 字串 | 不適用 | 是 | 指定要下載的電子郵件佇列 ID。 |
| 下載資料夾路徑 | 字串 | 不適用 | 是 | 指定動作應儲存檔案的資料夾絕對路徑。 |
| 覆寫 | 核取方塊 | 是 | 是 | 如果啟用,動作會覆寫路徑相同的現有檔案。 |
| 感應器名稱 | 字串 | 不適用 | 否 | 指定感應器名稱,下載隔離的電子郵件。如未指定,動作會嘗試自動尋找感應器。 |
執行日期
這項動作不會對實體執行,也沒有必要輸入參數。
動作執行結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON 結果
file_path = {absolute file path to the file}
案件總覽
| 結果類型 | 值 / 說明 | 類型 |
|---|---|---|
| 輸出訊息* | 這項動作不應失敗,也不應停止執行自動化腳本: if status code 200 and xml in the response (is_success = false): "Email with queue id {0} was not downloaded. 原因:{1}」。 動作應失敗並停止執行自動化動作: 如果系統未自動找到感應器:「執行『下載隔離電子郵件』動作時發生錯誤。原因:找不到 FireEye EX 裝置的感應器。請在「Sensor Name」參數中手動提供。''.format(error.Stacktrace) 如果提供的感應器無效:「Error executing action "Download Quarantined Email". 原因:找不到 FireEye EX 裝置名稱為「{0}」的感應器。請檢查拼字。''.format(error.Stacktrace) |
一般 |
刪除隔離的電子郵件
說明
刪除隔離的電子郵件。必須將 FireEye EX 連結至 Trellix Central Management。
參數
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 佇列 ID | 字串 | 不適用 | 是 | 指定要刪除的電子郵件佇列 ID。 |
| 感應器名稱 | 字串 | 不適用 | 否 | 指定感應器名稱,指出要刪除隔離電子郵件的位置。如未指定,動作會嘗試自動尋找感應器。 |
執行日期
這項動作不會對實體執行,也沒有必要輸入參數。
動作執行結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
案件總覽
| 結果類型 | 值 / 說明 | 類型 |
|---|---|---|
| 輸出訊息* | 動作不應失敗,也不應停止執行應對手冊: if status code 200 and response is not empty: "Email with queue id {0} was not deleted. 原因:{1}」。 如果發生嚴重錯誤,例如憑證錯誤、無法連線至伺服器等:「執行『刪除隔離電子郵件』動作時發生錯誤。原因:{0}''.format(error.Stacktrace) 如果系統未自動找到感應器:「執行『刪除隔離電子郵件』動作時發生錯誤。原因:找不到 FireEye EX 裝置的感應器。請在「Sensor Name」參數中手動提供。''.format(error.Stacktrace) 如果提供的感應器無效:「執行『刪除隔離電子郵件』動作時發生錯誤。原因:找不到 FireEye EX 裝置名稱為「{0}」的感應器。請檢查拼字。''.format(error.Stacktrace) |
一般 |
下載快訊構件
說明
從 Trellix Central Management 下載警告構件。
參數
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 快訊 UUID | 字串 | 不適用 | 是 | 指定要從哪個快訊 UUID 下載構件。 |
| 下載資料夾路徑 | 字串 | 不適用 | 是 | 指定動作應儲存檔案的資料夾絕對路徑。 |
| 覆寫 | 核取方塊 | 已勾選 | 是 | 如果啟用,動作會覆寫路徑相同的現有檔案。 |
執行日期
系統不會對實體執行這項動作。
動作執行結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON 結果
file_path = {absolute file path to the file}
案件總覽
| 結果類型 | 值 / 說明 | 類型 |
|---|---|---|
| 輸出訊息* | 動作不應失敗,也不應停止執行教戰手冊: 如果該路徑已有檔案 (is_success = false):「動作無法下載 Trellix Central Management 快訊構件,快訊 ID 為 {0}。原因:已有相同路徑的檔案。 if status code 404 (is_success = false): "Artifacts for alert with uuid {0} were not found. 」。 動作應失敗並停止執行自動化腳本: |
一般 |
列出 IOC 動態饋給
說明
列出 Trellix Central Management 中可用的 IOC 動態饋給。
參數
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 要傳回的 IOC 動態饋給數量上限 | 字串 | 50 | 否 | 指定要傳回的 IOC 動態饋給數量。預設值為 50。 |
執行日期
系統不會對實體執行這項動作。
動作執行結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON 結果
{
"customFeedInfo": [
{
"feedName": "ad",
"status": "Feed processed",
"feedType": "url",
"uploadDate": "2020/10/13 10:32:28",
"feedAction": "alert",
"feedSource": "",
"contentMeta": [
{
"contentType": "ip",
"feedCount": 0
},
{
"contentType": "domain",
"feedCount": 0
},
{
"contentType": "url",
"feedCount": 3
},
{
"contentType": "hash",
"feedCount": 0
}
]
},
{
"feedName": "adasdasdas",
"status": "Feed processed",
"feedType": "domain",
"uploadDate": "2020/10/13 10:34:29",
"feedAction": "alert",
"feedSource": "",
"contentMeta": [
{
"contentType": "ip",
"feedCount": 0
},
{
"contentType": "domain",
"feedCount": 3
},
{
"contentType": "url",
"feedCount": 0
},
{
"contentType": "hash",
"feedCount": 0
}
]
},
{
"feedName": "qweqwe",
"status": "Feed processed",
"feedType": "ip",
"uploadDate": "2020/10/13 10:16:31",
"feedAction": "alert",
"feedSource": "",
"contentMeta": [
{
"contentType": "ip",
"feedCount": 3
},
{
"contentType": "domain",
"feedCount": 0
},
{
"contentType": "url",
"feedCount": 0
},
{
"contentType": "hash",
"feedCount": 0
}
]
}
]
}
案件總覽
| 結果類型 | 值/說明 | 類型 |
|---|---|---|
| 輸出訊息* | 動作不應失敗,也不應停止執行應對手冊: 如果找不到任何項目:「No IOC feeds were found in Trellix Central Management」 動作應失敗並停止執行自動化動作: |
一般 |
| 案件總覽表格 | 資料表名稱:可用的 IOC 動態饋給 表格欄: 名稱 狀態 類型 動作 留言 IP 數量 網址數量 網域數量 雜湊計數 上傳時間 |
一般 |
將規則新增至自訂規則檔案
說明
在 Trellix Central Management 的自訂規則檔案中新增規則。
參數
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 規則 | 字串 | 不適用 | 是 | 指定要新增至自訂規則檔案的規則。 |
| 感應器名稱 | 字串 | 不適用 | 否 | 指定要新增規則的感應器名稱。如未指定,動作會嘗試自動尋找感應器。 |
執行日期
系統不會對實體執行這項動作。
動作執行結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
案件總覽
| 結果類型 | 值 / 說明 | 類型 |
|---|---|---|
| 輸出訊息* | 這項動作不應失敗,也不應停止執行應對手冊: 動作應失敗並停止執行應對手冊: 如果系統未自動找到感應器:「Error executing action "Add Rule To Custom Rules File". 原因:找不到 FireEye NX 設備的感應器。請在「Sensor Name」參數中手動提供。''.format(error.Stacktrace) 如果提供無效的感應器:「執行『將規則新增至自訂規則檔案』動作時發生錯誤。原因:找不到 FireEye NX 裝置名稱為「{0}」的感應器。請檢查拼字。''.format(error.Stacktrace) |
一般 |
確認警告
說明
在 Trellix Central Management 中確認警告。
參數
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 快訊 UUID | 字串 | 不適用 | 是 | 指定要確認的警告 UUID。 |
| 註解 | 字串 | 不適用 | 是 | 指定註解,說明確認原因。 |
執行日期
系統不會對實體執行這項動作。
動作執行結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
案件總覽
| 結果類型 | 值 / 說明 | 類型 |
|---|---|---|
| 輸出訊息* | 動作不應失敗,也不應停止執行應對手冊: 如果狀態碼為 404 (is_success = false):「動作無法確認 ID 為 {0} 的 Trellix Central Management 快訊。原因:找不到 ID 為 {0} 的快訊。」。 如果狀態碼為 400 (is_success = false):「動作無法確認 ID 為 {0} 的 Trellix Central Management 警示。原因:{1}」。 動作應失敗並停止執行自動化動作: |
一般 |
下載自訂規則檔案
說明
從 Trellix Central Management 下載自訂規則檔案。
參數
| 參數顯示名稱 | 類型 | 預設值 | 是否為必要 | 說明 |
|---|---|---|---|---|
| 感應器名稱 | 字串 | 不適用 | 否 | 指定要新增規則的感應器名稱。如未指定,動作會嘗試自動尋找感應器。 |
| 下載資料夾路徑 | 字串 | 不適用 | 是 | 指定資料夾的絕對路徑,檔案應下載至該資料夾。 |
| 覆寫 | 核取方塊 | 已勾選 | 是 | 如果啟用,動作會覆寫路徑相同的現有檔案。 |
執行日期
系統不會對實體執行這項動作。
動作執行結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON 結果
File Path = "absolute path to the file"
案件總覽
| 結果類型 | 值 / 說明 | 類型 |
|---|---|---|
| 輸出訊息* | 動作不應失敗,也不應停止執行教戰手冊: 如果狀態碼為 500 或 400 (is_success = false):「動作無法從 Trellix Central Management 的設備『{0}』下載自訂規則檔案。原因:{1}」。 如果系統未自動找到感應器:「Error executing action "Download Custom Rules File". 原因:找不到 FireEye NX 設備的感應器。請在「Sensor Name」參數中手動提供。''.format(error.Stacktrace) 如果提供的感應器無效:「執行『下載自訂規則檔案』動作時發生錯誤。原因:找不到 FireEye NX 裝置名稱為「{0}」的感應器。請檢查拼字。''.format(error.Stacktrace) |
一般 |
連接器
FireEye CM - 警示連接器
說明
連接器會將 Trellix Central Management 警告擷取至 Google SecOps。包括 FireEye NX 和 EX 裝置產生的警示。
在 Google SecOps 中設定 FireEye CM - Alerts 連接器
如要瞭解如何在 Google SecOps 中設定連接器,請參閱「設定連接器」一文。
連接器參數
使用下列參數設定連接器:
| 參數顯示名稱 | 類型 | 預設值 | 為必填項目 | 說明 |
|---|---|---|---|---|
| 產品欄位名稱 | 字串 | 感應器 | 是 | 輸入來源欄位名稱,擷取產品欄位名稱。 |
| 事件欄位名稱 | 字串 | eventType | 是 | 輸入來源欄位名稱,擷取事件欄位名稱。 |
環境欄位名稱 |
字串 | "" | 否 | 說明儲存環境名稱的欄位名稱。 如果找不到環境欄位,則環境為預設環境。 |
環境規則運算式模式 |
字串 | .* | 否 | 要對「環境欄位名稱」欄位中的值執行的規則運算式模式。 預設值為 .*,可擷取所有值並傳回未變更的值。 用於允許使用者透過規則運算式邏輯操控環境欄位。 如果規則運算式模式為空值或空白,或環境值為空值,則最終環境結果為預設環境。 |
| 指令碼逾時 (秒) | 整數 | 180 | 是 | 執行目前指令碼的 Python 程序逾時限制。 |
| API 根層級 | 字串 | https://x.x.x.x:x | 是 | Trellix Central Management 伺服器的 API 根目錄。 |
| 使用者名稱 | 字串 | 不適用 | 是 | Trellix Central Management 帳戶的使用者名稱。 |
| 密碼 | 密碼 | 不適用 | 是 | Trellix Central Management 帳戶的密碼。 |
| 擷取過去幾小時內的資料 (上限) | 整數 | 1 | 否 | 要擷取快訊的時間範圍 (以小時為單位)。 |
| 驗證 SSL | 核取方塊 | 已勾選 | 是 | 如果已啟用,請確認連至 Trellix Central Management 伺服器的 SSL 憑證有效。 |
| 將許可清單當做黑名單使用 | 核取方塊 | 已取消勾選 | 是 | 如果啟用,許可清單會當做黑名單使用。 |
| Proxy 伺服器位址 | 字串 | 不適用 | 否 | 要使用的 Proxy 伺服器位址。 |
| Proxy 使用者名稱 | 字串 | 不適用 | 否 | 用於驗證的 Proxy 使用者名稱。 |
| Proxy 密碼 | 密碼 | 不適用 | 否 | 用於驗證的 Proxy 密碼。 |
連接器規則
Proxy 支援
連接器支援 Proxy。
還有其他問題嗎?向社群成員和 Google SecOps 專家尋求解答。