LogRhythm

整合版本:17.0

自第 10 版起,這項整合服務將不再提供 Alarms Connector。由於 LogRhythm 方面已淘汰 SOAP API,因此這個連接器也已淘汰。現在整個整合程序都使用 LogRhythm 7.9 版本中推出的 REST API。

詳情請參閱「SOAP API (LogRhythm 7.x.x)」。

此外,整合項目已更新至 Python 3 版,因此不支援將這個連接器 (版本 9) 與新版整合項目 (版本 10) 搭配使用,否則會導致異常行為。

請按照建議流程更新:

  1. 將整合功能更新至第 10 版前,請先使用第 9 版的整合功能,將每個「LogRhythm Alarms Connector」遷移至「LogRhythm - Rest API Alarms Connector」。

  2. 將整合項目更新至版本 10。

在 Google Security Operations 中設定 LogRhythm 整合

如需在 Google SecOps 中設定整合功能的詳細操作說明,請參閱「設定整合功能」。

整合參數

請使用下列參數設定整合:

參數顯示名稱 類型 預設值 是否為必要項目 說明
API 根層級 字串 https://{IP}:8501 LogRhythm 執行個體的 API 根目錄。
API 權杖 密碼 不適用 LogRhythm 執行個體的 API 權杖。
CA 憑證檔案 字串 不適用 Base64 編碼的 CA 憑證檔案。
驗證 SSL 核取方塊 已取消勾選 如果已啟用,請確認連線至 LogRhythm 伺服器的 SSL 憑證是否有效。

動作

乒乓

說明

使用 Google Security Operations Marketplace 分頁中整合設定頁面提供的參數,測試與 LogRhythm 的連線。

參數

不適用

用途

不適用

執行時間

這項動作不會在實體上執行,也沒有強制輸入參數。

動作執行結果

指令碼執行結果
指令碼結果名稱 價值選項 示例
is_success True/False is_success=False
JSON 結果
N/A
實體擴充

不適用

深入分析

不適用

案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果成功:「Successfully connected to the LogRhythm server with the provided connection parameters!」(已使用提供的連線參數成功連線至 LogRhythm 伺服器!)

動作應會失敗並停止執行應對手冊:

如果未成功:「Failed to connect to the LogRhythm server! Error is {0}".format(exception.stacktrace)

一般

充實實體

說明

使用 LogRhythm 的資訊擴充實體。支援的實體:主機名稱、IP 位址。

參數

參數顯示名稱 類型 預設值 是否為必要項目 說明
建立洞察資料 核取方塊 已勾選 如果啟用,這項動作會建立洞察資料,其中包含實體的所有擷取資訊。

執行日期

這項動作會對下列實體執行:

  • IP 位址
  • 主機名稱

動作執行結果

指令碼執行結果
指令碼結果名稱 價值選項 示例
is_success True/False is_success=False
JSON 結果
{
    "id": 2,
    "entity": {
        "id": 2,
        "name": "EchoTestEntity"
    },
    "name": "EchoTestHost",
    "shortDesc": "LogRhythm ECHO",
    "riskLevel": "None",
    "threatLevel": "None",
    "threatLevelComments": "",
    "recordStatusName": "Active",
    "hostZone": "Internal",
    "location": {
        "id": -1
    },
    "os": "Windows",
    "osVersion": "Microsoft Windows NT 6.2.9200.0",
    "useEventlogCredentials": false,
    "osType": "Server",
    "dateUpdated": "2021-04-14T09:18:17.677Z",
    "hostRoles": [],
    "hostIdentifiers": [
        {
            "type": "IPAddress",
            "value": "10.1.2.50",
            "dateAssigned": "2021-04-14T09:17:31Z"
        },
        {
            "type": "WindowsName",
            "value": "EchoTestHost",
            "dateAssigned": "2021-04-14T09:17:31Z"
        }
    ]
}
實體擴充
補充資料欄位名稱 邏輯 - 適用時機
說明 以 JSON 格式提供時
risk_level 以 JSON 格式提供時
threat_level 以 JSON 格式提供時
狀態 以 JSON 格式提供時
host_zone 以 JSON 格式提供時
os 以 JSON 格式提供時
類型 以 JSON 格式提供時
ips 以 JSON 格式提供時
深入分析

不適用

案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

If 資料適用於一個實體 (is_success=true):「Successfully enriched the following entities using information from LogRhythm: {entity.identifier}」。

如果某個實體沒有可用資料 (is_success=true):「Action wasn't able to enrich the following entities using information from LogRhythm: {entity.identifier}」。

如果並非所有實體都有資料 (is_success=false):「None of the provided entities were enriched.」

動作應會失敗並停止執行應對手冊:

如果系統回報嚴重錯誤,例如憑證錯誤、無法連線至伺服器或其他錯誤:「執行『Enrich Entities』動作時發生錯誤。原因:{0}''.format(error.Stacktrace)

一般
案件總覽表格 資料表名稱:{entity.identifier} 實體

更新鬧鐘

說明

在 LogRhythm 中更新警報。

參數

參數顯示名稱 類型 預設值 是否為必要項目 說明
鬧鐘 ID 字串 不適用 指定要在 LogRhythm 中更新的警報 ID。
狀態 DDL

請選取一項

可能的值:

  • 請選取一項
  • 新增
  • 開啟
  • 執行中
  • 已提報
  • 已關閉
  • 誤報
  • 已解決
  • 未解決
  • 已回報
  • 監控
指定警報的狀態。
風險分數 整數 不適用

為警報指定新的風險分數。

上限:100

執行日期

這項動作會對下列實體執行:

  • 網址
  • IP 位址

動作執行結果

指令碼執行結果
指令碼結果名稱 價值選項 示例
is_success True/False is_success=False
JSON 結果
N/A
實體擴充

不適用

深入分析

不適用

案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果 回報 200 狀態碼 (is_success=true):「Successfully updated alarm with ID {ID} in LogRhythm.」(已在 LogRhythm 中成功更新 ID 為 {ID} 的警報)。

動作應會失敗並停止執行應對手冊:

如果系統回報嚴重錯誤,例如憑證錯誤、無法連線至伺服器或其他錯誤:「執行『更新警報』動作時發生錯誤。原因:{0}''.format(error.Stacktrace)

如果狀態碼不是 200:「執行動作『更新鬧鐘』時發生錯誤。原因:{0}''.format(responseMessage)"

如果「狀態」參數設為「選取一項」,但未提供其他值:「執行『更新警報』動作時發生錯誤。原因:至少一個動作參數應提供值。

一般

取得鬧鐘詳細資料

說明

在 LogRhythm 中取得警報詳細資料。這項動作可讓您從 LogRhythm Advanced Intelligence Engine (AIE) 事件取得詳細資料,並將這些資料擷取至 Google SecOps。

參數

參數顯示名稱 類型 預設值 是否為必要項目 說明
鬧鐘 ID CSV 不適用 指定要擷取詳細資料的警報 ID 清單 (以半形逗號分隔)。
要擷取的事件數量上限 整數 50 指定要傳回的事件數。

執行日期

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

動作執行結果

指令碼執行結果
指令碼結果名稱 價值選項 示例
is_success True/False is_success=False
JSON 結果
[
  {
    "alarmRuleID": 98,
    "alarmId": 18755,
    "personId": -100,
    "alarmDate": "2021-08-17T13:36:39.78",
    "alarmStatus": 0,
    "alarmStatusName": "New",
    "entityId": 2,
    "entityName": "EchoTestEntity",
    "alarmRuleName": "LogRhythm Agent Heartbeat Missed",
    "lastUpdatedID": -100,
    "lastUpdatedName": "LogRhythm Administrator",
    "dateInserted": "2021-08-17T13:36:39.807",
    "dateUpdated": "2021-08-17T13:36:39.86",
    "associatedCases": [],
    "lastPersonID": null,
    "eventCount": 1,
    "eventDateFirst": "2021-08-17T13:36:37.057",
    "eventDateLast": "2021-08-17T13:36:37.057",
    "rbpMax": 39,
    "rbpAvg": 39,
    "smartResponseActions": null,
    "alarmDataCached": "N",
    "alarmEventsDetails": [
      {
        "account": "admin5",
        "action": "",
        "amount": null,
        "bytesIn": null,
        "bytesOut": null,
        "classificationId": 2600,
        "classificationName": "Compromise",
        "classificationTypeName": "Security",
        "command": "",
        "commonEventId": 1031412,
        "cve": "",
        "commonEventName": "AIE: CSC: Disabled Account Auth Success",
        "count": 1,
        "directionId": 0,
        "directionName": "Unknown",
        "domain": "",
        "duration": 0,
        "entityId": -1000001,
        "entityName": "",
        "group": "",
        "impactedEntityId": -100,
        "impactedEntityName": "Global Entity",
        "impactedHostId": -1,
        "impactedHostName": "",
        "impactedInterface": "",
        "impactedIP": null,
        "impactedLocation": {
          "countryCode": "",
          "name": "",
          "latitude": 0,
          "locationId": 0,
          "locationKey": "",
          "longitude": 0,
          "parentLocationId": 0,
          "recordStatus": "Deleted",
          "regionCode": "",
          "type": "NULL",
          "dateUpdated": "0001-01-01T00:00:00"
        },
        "impactedMAC": "",
        "impactedName": "",
        "impactedNATIP": "",
        "impactedNATPort": null,
        "impactedNetwork": {
          "beginIPRange": {
            "value": ""
          },
          "dateUpdated": "0001-01-01T00:00:00",
          "riskThreshold": "",
          "endIPRange": {
            "value": ""
          },
          "entityId": 0,
          "hostZone": "Unknown",
          "locationId": 0,
          "longDesc": "",
          "name": "",
          "networkId": 0,
          "recordStatus": "Deleted",
          "shortDesc": ""
        },
        "impactedPort": -1,
        "impactedZone": "Unknown",
        "itemsPacketsIn": 0,
        "itemsPacketsOut": 0,
        "logDate": "2021-08-16T09:51:16.993",
        "login": "admin5",
        "logMessage": "",
        "logSourceHostId": -1000001,
        "logSourceHostName": "AI Engine Server",
        "logSourceName": "AI Engine",
        "logSourceTypeName": "LogRhythm AI Engine",
        "messageId": 173885,
        "mpeRuleId": -1,
        "mpeRuleName": "",
        "normalDateMax": "0001-01-01T00:00:00",
        "objectName": "",
        "objectType": "",
        "originEntityId": -100,
        "originEntityName": "Global Entity",
        "originHostId": -1,
        "originHostName": "",
        "originInterface": "",
        "originIP": null,
        "originLocation": {
          "countryCode": "",
          "name": "",
          "latitude": 0,
          "locationId": 0,
          "locationKey": "",
          "longitude": 0,
          "parentLocationId": 0,
          "recordStatus": "Deleted",
          "regionCode": "",
          "type": "NULL",
          "dateUpdated": "0001-01-01T00:00:00"
        },
        "originMAC": "",
        "originName": "",
        "originNATIP": "",
        "originNATPort": null,
        "originNetwork": {
          "beginIPRange": {
            "value": ""
          },
          "dateUpdated": "0001-01-01T00:00:00",
          "riskThreshold": "",
          "endIPRange": {
            "value": ""
          },
          "entityId": 0,
          "hostZone": "Unknown",
          "locationId": 0,
          "longDesc": "",
          "name": "",
          "networkId": 0,
          "recordStatus": "Deleted",
          "shortDesc": ""
        },
        "originPort": -1,
        "originZone": "Unknown",
        "parentProcessId": "",
        "parentProcessName": "",
        "parentProcessPath": "",
        "policy": "",
        "priority": 91,
        "process": "",
        "processId": -1,
        "protocolId": -1,
        "protocolName": "",
        "quantity": 0,
        "rate": 0,
        "reason": "",
        "recipient": "",
        "result": "",
        "responseCode": "",
        "sender": "",
        "session": "",
        "recipientIdentityId": null,
        "recipientIdentityName": ""
      }
    ]
  }
]
實體擴充

不適用

深入分析

不適用

案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果回報一個實體的 200 狀態碼 (is_success=true):「Successfully retrieved details for the following alarms in LogRhythm: {IDs}」(已成功擷取 LogRhythm 中下列警報的詳細資料:{ID})

如果找不到任何警報 (is_success=true):「The following alarms were not found in LogRhythm: {IDs}」(LogRhythm 中找不到下列警報:{ID})

如果找不到所有警報 (is_success=false):「None of the provided alarms were found in LogRhythm.」

動作應會失敗並停止執行應對手冊:

如果系統回報嚴重錯誤 (例如憑證錯誤、無法連線至伺服器或其他錯誤):「執行『取得警報詳細資料』動作時發生錯誤。原因:{0}''.format(error.Stacktrace)

一般
案件總覽表格

表格名稱:Alarm {ID} Events

資料表資料欄:

  • 分類名稱
  • 分類類型
  • 名稱
  • 優先順序
  • 帳戶
  • 主機名稱
一般

新增鬧鐘留言

說明

在 LogRhythm 中為警報新增註解。

參數

參數顯示名稱 類型 預設值 是否為必要項目 說明
鬧鐘 ID 字串 不適用 指定要在 LogRhythm 中新增註解的警報 ID。
註解 字串 不適用 指定要新增至鬧鐘的留言。

執行日期

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

動作執行結果

指令碼執行結果
指令碼結果名稱 價值選項 示例
is_success True/False is_success=False
JSON 結果
N/A
實體擴充

不適用

深入分析

不適用

案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果回報 200 狀態碼 (is_success=true):「Successfully added comment to the alarm with ID {ID} in LogRhythm.」

動作應會失敗並停止執行應對手冊:

如果系統回報嚴重錯誤,例如憑證有誤、無法連線至伺服器或其他錯誤:「執行動作『Add Comment To Alarm』時發生錯誤。原因:{0}''.format(error.Stacktrace)

如果狀態碼不是 200:「Error executing action "Add Comment To Alarm". 原因:{0}''.format(responseMessage)

一般

列出案件證據

說明

在 LogRhythm 中列出案件證據。

參數

參數顯示名稱 類型 預設值 是否為必要項目 說明
案件 ID 字串 不適用 指定要傳回證據清單的案件 ID。
狀態篩選器 CSV 不適用

指定以半形逗號分隔的證據狀態篩選條件清單。

可能的值:pending、completed、failed。

如未提供任何內容,這項動作會傳回所有狀態的證據。

類型篩選器 CSV 不適用

指定證據的類型篩選條件清單 (以半形逗號分隔)。

可能的值:alarm、userEvents、log、note、file。

如未提供任何資訊,這項動作會傳回所有類型的證據。

要傳回的證據數量上限 整數 50 指定要傳回的證據數量。

執行日期

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

動作執行結果

指令碼執行結果
指令碼結果名稱 價值選項 示例
is_success True/False is_success=False
JSON 結果
[
    {
        "number": 4,
        "dateCreated": "2021-07-31T11:00:40.2433333Z",
        "dateUpdated": "2021-07-31T11:00:40.2433333Z",
        "createdBy": {
            "number": -100,
            "name": "LogRhythm Administrator",
            "disabled": false
        },
        "lastUpdatedBy": {
            "number": -100,
            "name": "LogRhythm Administrator",
            "disabled": false
        },
        "type": "file",
        "status": "completed",
        "statusMessage": null,
        "text": "test",
        "pinned": false,
        "datePinned": null,
        "file": {
            "name": "UploadCustomListTemplate .csv",
            "size": 161
        }
    }
]
實體擴充

不適用

深入分析

不適用

案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果回報 200 狀態碼 (is_success=true):「Successfully listed evidence related to the case with ID {ID} in LogRhythm.」(已在 LogRhythm 中成功列出與 ID 為 {ID} 的案件相關的證據)。

如果沒有證據 (is_success=false):「No evidence was found for the case with ID {ID} in LogRhythm.」(LogRhythm 中找不到 ID 為 {ID} 的案件證據)。

動作應會失敗並停止執行應對手冊:

如果系統回報嚴重錯誤,例如憑證錯誤、無法連線至伺服器或其他錯誤:「執行『列出案件證據』動作時發生錯誤。原因:{0}''.format(error.Stacktrace)

如果系統回報 404 狀態碼:「Error executing action "List Case Evidence". 原因:{0}''.format(message)

如果為「狀態」參數提供無效值:「執行動作『列出案件證據』時發生錯誤。原因:參數「狀態篩選器」提供的值無效:{invalid value}。可能的值:pending、completed、failed。

如果為「類型」參數提供無效值:「執行動作『列出案件證據』時發生錯誤。原因:參數「Type」中提供的值無效:{invalid value}。可能的值:alarm、userEvents、log、note、file。

一般
案件總覽

案件 {case id} 證據

類型

狀態

背景資訊

將警報新增至案件

說明

在 LogRhythm 中為案件新增警報。

參數

參數顯示名稱 類型 預設值 是否為必要項目 說明
案件 ID 字串 不適用 指定要新增警報的案件 ID。
鬧鐘 ID CSV 不適用 指定要新增至案件的警報清單 (以半形逗號分隔)。

執行日期

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

動作執行結果

指令碼執行結果
指令碼結果名稱 價值選項 示例
is_success True/False is_success=False
JSON 結果
[
    {
        "number": 23,
        "dateCreated": "2021-08-11T09:02:17.0066667Z",
        "dateUpdated": "2021-08-11T09:02:17.0066667Z",
        "createdBy": {
            "number": -100,
            "name": "LogRhythm Administrator",
            "disabled": false
        },
        "lastUpdatedBy": {
            "number": -100,
            "name": "LogRhythm Administrator",
            "disabled": false
        },
        "type": "alarm",
        "status": "completed",
        "statusMessage": null,
        "text": "",
        "pinned": false,
        "datePinned": null,
        "alarm": {
            "alarmId": 15298,
            "alarmDate": "2021-07-30T02:07:29.813+03:00",
            "alarmRuleId": 1000,
            "alarmRuleName": "AIE: ISO-27001: File Monitoring Event-File Changes",
            "dateInserted": "2021-07-30T02:07:29.82+03:00",
            "entityId": -100,
            "entityName": "Global Entity",
            "riskBasedPriorityMax": 1
        }
    },
    {
        "number": 24,
        "dateCreated": "2021-08-11T09:03:18.65Z",
        "dateUpdated": "2021-08-11T09:03:18.65Z",
        "createdBy": {
            "number": -100,
            "name": "LogRhythm Administrator",
            "disabled": false
        },
        "lastUpdatedBy": {
            "number": -100,
            "name": "LogRhythm Administrator",
            "disabled": false
        },
        "type": "alarm",
        "status": "completed",
        "statusMessage": null,
        "text": "",
        "pinned": false,
        "datePinned": null,
        "alarm": {
            "alarmId": 15297,
            "alarmDate": "2021-07-30T02:07:28.353+03:00",
            "alarmRuleId": 1419,
            "alarmRuleName": "AIE: CCF: FIM General Activity",
            "dateInserted": "2021-07-30T02:07:29.82+03:00",
            "entityId": 1,
            "entityName": "Primary Site",
            "riskBasedPriorityMax": 0
        }
    }
]
實體擴充

不適用

深入分析

不適用

案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果回報 201 狀態碼 (is_success=true):「Successfully added alarm evidence related to the case with ID {ID} in LogRhythm.」(已在 LogRhythm 中成功新增與 ID 為 {ID} 的案件相關的警報證據)。

如果系統回報 200 狀態碼 (is_success=true):「提供的所有警報證據已納入 LogRhythm 中 ID 為 {ID} 的案件。」

動作應會失敗並停止執行應對手冊:

如果系統回報嚴重錯誤,例如憑證錯誤、無法連線至伺服器或其他錯誤:「執行『將警報新增至案件』動作時發生錯誤。原因:{0}''.format(error.Stacktrace)

如果系統回報 404 狀態碼:「執行『將警報新增至案件』動作時發生錯誤。原因:{0}''.format(message or details)

一般

將檔案附加至案件

說明

在 LogRhythm 中將檔案附加至案件。

參數

參數顯示名稱 類型 預設值 是否為必要項目 說明
案件 ID 字串 不適用 指定要附加檔案的案件 ID。
檔案路徑 CSV 不適用 指定以半形逗號分隔的絕對檔案路徑清單。
注意事項 字串 不適用 指定要與檔案一併新增至案件的附註。

執行日期

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

動作執行結果

指令碼執行結果
指令碼結果名稱 價值選項 示例
is_success True/False is_success=False
JSON 結果
[
    {
        "number": 26,
        "dateCreated": "2021-08-11T09:17:33.91Z",
        "dateUpdated": "2021-08-11T09:17:33.91Z",
        "createdBy": {
            "number": -100,
            "name": "LogRhythm Administrator",
            "disabled": false
        },
        "lastUpdatedBy": {
            "number": -100,
            "name": "LogRhythm Administrator",
            "disabled": false
        },
        "type": "file",
        "status": "completed",
        "statusMessage": null,
        "text": "",
        "pinned": false,
        "datePinned": null,
        "file": {
            "name": "Get Deep Visibility Query Result_JsonResultSample.json",
            "size": 4979
        }
    }
]
實體擴充

不適用

深入分析

不適用

案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果已完成一個檔案的作業 path (is_success=true):「Successfully added the following files to the case with ID {ID} in LogRhythm.」(已成功將下列檔案新增至 LogRhythm 中 ID 為 {ID} 的案件)。

如果一個檔案路徑失敗 (is_success= true):「Action wasn't able to add the following files to the case with ID {ID} in LogRhythm: {failed file paths}」。

如果所有檔案路徑都失敗 (is_success=false):「No files were added to the case with ID {ID} in LogRhythm.」(LogRhythm 中沒有新增任何檔案至 ID 為 {ID} 的案件)。

動作應會失敗並停止執行應對手冊:

如果系統回報嚴重錯誤,例如憑證錯誤、無法連線至伺服器或其他錯誤:「Error executing action "Attach File To Case". 原因:{0}''.format(error.Stacktrace)

如果系統回報 404 狀態碼:「Error executing action "Attach File To Case". 原因:{0}''.format(message)

如果發生逾時問題:「Error executing action "Attach File To Case". 原因:動作逾時。以下檔案仍在處理中:{pending files}。請在 IDE 中增加逾時時間。注意:如果新增相同檔案,LogRhythm 會建立個別項目。

一般

將附註新增至案件

說明

在 LogRhythm 中為案件新增附註。

參數

參數顯示名稱 類型 預設值 是否為必要項目 說明
案件 ID 字串 不適用 指定要新增附註的案件 ID。
注意事項 字串 不適用 指定要新增至案件的附註。

執行日期

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

動作執行結果

指令碼執行結果
指令碼結果名稱 價值選項 示例
is_success True/False is_success=False
JSON 結果
{
    "number": 29,
    "dateCreated": "2021-08-11T12:21:11.5547306Z",
    "dateUpdated": "2021-08-11T12:21:11.5547306Z",
    "createdBy": {
        "number": -100,
        "name": "LogRhythm Administrator",
        "disabled": false
    },
    "lastUpdatedBy": {
        "number": -100,
        "name": "LogRhythm Administrator",
        "disabled": false
    },
    "type": "note",
    "status": "completed",
    "statusMessage": null,
    "text": "asdasd",
    "pinned": false,
    "datePinned": null
}
實體擴充

不適用

深入分析

不適用

案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果回報 201 狀態碼 (is_success=true):「Successfully added a note to the case with ID {ID} in LogRhythm.」(已在 LogRhythm 中成功為 ID 為 {ID} 的案件新增附註)。

動作應會失敗並停止執行應對手冊:

如果系統回報嚴重錯誤,例如憑證有誤、無法連線至伺服器或其他錯誤:「執行『將記事新增至案件』動作時發生錯誤。原因:{0}''.format(error.Stacktrace)

如果系統回報 404 狀態碼:「Error executing action "Add Note To Case". 原因:{0}''.format(message)

一般

建立客服案件

說明

在 LogRhythm 中建立案件。

參數

參數顯示名稱 類型 預設值 是否為必要項目 說明
名稱 字串 不適用 指定案件名稱。
優先順序 DDL

1

可能的值:

  • 1
  • 2
  • 3
  • 4
  • 5
指定案件的優先順序。
截止日 字串 不適用

指定案件的截止日期。

格式:ISO 8601

範例:2021-04-23T12:38Z

說明 字串 不適用 指定案件說明。

執行日期

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

動作執行結果

指令碼執行結果
指令碼結果名稱 價值選項 示例
is_success True/False is_success=False
JSON 結果
{
    "id": "BA210B5A-0E4F-4E07-A770-8C24FB82747A",
    "number": 2,
    "externalId": "",
    "dateCreated": "2021-08-11T12:37:42.8942168Z",
    "dateUpdated": "2021-08-11T12:37:42.8942168Z",
    "dateClosed": null,
    "owner": {
        "number": -100,
        "name": "LogRhythm Administrator",
        "disabled": false
    },
    "lastUpdatedBy": {
        "number": -100,
        "name": "LogRhythm Administrator",
        "disabled": false
    },
    "name": "System Compromise",
    "status": {
        "name": "Created",
        "number": 1
    },
    "priority": 1,
    "dueDate": "2019-08-24T14:15:22Z",
    "resolution": null,
    "resolutionDateUpdated": null,
    "resolutionLastUpdatedBy": null,
    "summary": "Investigated a potential system compromise. More details at http://example.com/.",
    "entity": {
        "number": -100,
        "name": "Global Entity",
        "fullName": "Global Entity"
    },
    "collaborators": [
        {
            "number": -100,
            "name": "LogRhythm Administrator",
            "disabled": false
        }
    ],
    "tags": []
}
實體擴充

不適用

深入分析

不適用

案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果回報 201 狀態碼 (is_success=true):「Successfully created case {number} in LogRhythm.」(已在 LogRhythm 中成功建立案件 {number}。)

動作應會失敗並停止執行應對手冊:

如果系統回報嚴重錯誤,例如憑證錯誤、無法連線至伺服器或其他錯誤:「Error executing action "Create Case"。原因:{0}''.format(error.Stacktrace)

如果系統回報 404 狀態碼:「Error executing action "Create Case". 原因:{0}''.format(message)

一般

可更新客服案件

說明

在 LogRhythm 中更新案件。

參數

參數顯示名稱 類型 預設值 是否為必要項目 說明
案件 ID 字串 不適用 指定需要更新的案件 ID。
名稱 字串 不適用 指定案件的新名稱。
優先順序 DDL

請選取一項

可能的值:

  • 1
  • 2
  • 3
  • 4
  • 5
指定案件的新優先順序。
截止日 字串 不適用

為案件指定新的截止日期。

格式:ISO 8601

範例:2021-04-23T12:38Z

說明 字串 不適用 指定案件的新說明。
解析度 字串 不適用 指定案件的解決方式。
狀態 DDL

請選取一項

可能的值:

  • 建立時間
  • 已完成
  • 事件
  • 已處理
  • 已解決
指定案件的新狀態。

執行日期

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

動作執行結果

指令碼執行結果
指令碼結果名稱 價值選項 示例
is_success True/False is_success=False
JSON 結果
{
    "id": "BA210B5A-0E4F-4E07-A770-8C24FB82747A",
    "number": 2,
    "externalId": "",
    "dateCreated": "2021-08-11T12:37:42.8942168Z",
    "dateUpdated": "2021-08-11T12:48:52.9765558Z",
    "dateClosed": null,
    "owner": {
        "number": -100,
        "name": "LogRhythm Administrator",
        "disabled": false
    },
    "lastUpdatedBy": {
        "number": -100,
        "name": "LogRhythm Administrator",
        "disabled": false
    },
    "name": "System Compromise",
    "status": {
        "name": "Created",
        "number": 1
    },
    "priority": 1,
    "dueDate": "2019-08-24T14:15:22Z",
    "resolution": null,
    "resolutionDateUpdated": null,
    "resolutionLastUpdatedBy": null,
    "summary": "Investigated a potential system compromise. More details at http://example.com/.",
    "entity": {
        "number": -100,
        "name": "Global Entity",
        "fullName": "Global Entity"
    },
    "collaborators": [
        {
            "number": -100,
            "name": "LogRhythm Administrator",
            "disabled": false
        }
    ],
    "tags": []
}
實體擴充

不適用

深入分析

不適用

案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果 回報 201 狀態碼 (is_success=true):「Successfully updated case {ID} in LogRhythm.」(已成功更新 LogRhythm 中的案件 {ID}。)

動作應會失敗並停止執行應對手冊:

如果 發生重大錯誤 (例如憑證錯誤、無法連線至伺服器或其他錯誤),系統會回報:「Error executing action "Update Case". Reason: {0}''.format(error.Stacktrace)"

如果系統回報 404 狀態碼:「Error executing action "Update Case". 原因:{0}''.format(message)

如果狀態碼為 400:「Error executing action "Update Case". Reason: {0}''.format(validationErrors)"

如果「狀態」或「優先順序」參數設為「選取一項」,但未提供任何其他值:「執行『更新案件』動作時發生錯誤。原因:至少一個動作參數應提供值。

一般

下載案件檔案

說明

在 LogRhythm 中下載與案件相關的檔案。

參數

參數顯示名稱 類型 預設值 是否為必要項目 說明
案件 ID 字串 不適用 指定要下載檔案的案件 ID。
下載資料夾路徑 字串 不適用 指定要儲存案件檔案的資料夾路徑。
覆寫 布林值 如果啟用這項設定,系統會覆寫名稱相同的檔案。

執行日期

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

動作執行結果

指令碼執行結果
指令碼結果名稱 價值選項 示例
is_success True/False is_success=False
JSON 結果
{"absolute_file_paths": ["file_path_1","file_path_2"]}
``` ##### Entity
Enrichment

N/A

#####  Insights

N/A

#####  Case Wall

<table>
<thead>
<tr>
<th><strong>Result type</strong></th>
<th><strong>Value/Description</strong></th>
<th><strong>Type</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>Output message*</td>
<td><p><strong>The action should not fail nor stop a playbook execution:</strong></p><p><strong></strong></p><p><em>If the</em> <strong></strong> <em>200 status code for all cases is reported (is_success=true):</em> "Successfully downloaded files related to case with ID {ID} in LogRhythm."</p><p></p><p><em>If no files are found (is_success=true): "</em>No related files were found for the case with ID {ID} in LogRhythm."</p><p></p><p><strong>The action should fail and stop a playbook execution:</strong></p><p><strong></strong></p><p><em>If a</em> <strong></strong> <em>fatal error, like wrong credentials, no connection to the server, other is reported:</em> "Error executing action "Download Case Files". Reason: {0}''.format(error.Stacktrace)"</p><p></p><p><em>If the 404 status code is reported:</em> "Error executing action "Download Case Files". Reason: {0}''.format(message)"</p><p></p><p><em>If a file with the same name already exists, but "Overwrite" is set to false:</em> "Error executing action "Download Case Files". Reason: files with path {0} already exist. Please delete the files or set "Overwrite" to true."</p></td>
<td>General</td>
</tr>
</tbody>
</table>

### List Entity Events

#### Description

List events related to entities in LogRhythm. Supported entities: Hostname, IP
Address, User, CVE, Hash, URL.

Note: This action runs as async. Adjust the script timeout value in the
Google SecOps IDE for the action as needed.

#### Parameters

<table>
<thead>
<tr>
<th><strong>Parameter Display Name</strong></th>
<th><strong>Type</strong></th>
<th><strong>Default Value</strong></th>
<th><strong>Is Mandatory</strong></th>
<th><strong>Description</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>Time Frame</td>
<td>DDL</td>
<td><p>Last Hour</p><p><strong></strong></p><p>Possible Values: </p><ul><li>Last Hour</li><li>Last 6 Hours</li><li>Last 24 Hours</li><li>Last Week</li><li>Last Month</li><li>Custom</li></ul></td>
<td>No</td>
<td>Name of the watchlist from which you want to remove values.</td>
</tr>
<tr>
<td>Start Time</td>
<td>String</td>
<td>N/A</td>
<td>No</td>
<td><p>Specify the start time for the results.</p><p></p><p>This parameter is mandatory, if "Custom" is selected for the "Time Frame" parameter. </p><p></p><p>Format: ISO 8601</p><p></p><p>Example: 2021-04-23T12:38Z</p></td>
</tr>
<tr>
<td>End Time</td>
<td>String</td>
<td>N/A</td>
<td>No</td>
<td><p>Specify the end time for the results. </p><p></p><p>If nothing is provided and "Custom" is selected for the "Time Frame" parameter then this parameter uses current time.</p><p></p><p>Format: ISO 8601</p></td>
</tr>
<tr>
<td>Sort Order</td>
<td>DDL</td>
<td><p>Datetime ASC <strong></strong> </p><p></p><p>Possible values:</p><ul><li>Datetime ASC</li><li>Datetime DESC</li><li>Risk ASC</li><li>RiskDESC</li></ul></td>
<td>No</td>
<td>Specify the sorting logic for the query.</td>
</tr>
<tr>
<td>Max Events To Return</td>
<td>Integer</td>
<td>50</td>
<td>No</td>
<td>Specify the number of events to return.</td>
</tr>
</tbody>
</table>

#### Run On

This action runs on the following entities:

*   Hostname
*   IP Address
*   User
*   CVE
*   Hash
*   URL

#### Action Results

#####  Script Result

<table>
<thead>
<tr>
<th><strong>Script Result Name</strong></th>
<th><strong>Value Options</strong></th>
<th><strong>Example</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>is_success</td>
<td>True/False</td>
<td>is_success:False</td>
</tr>
</tbody>
</table>

#####  JSON Result

```json
{
    "kBytes": 2521.025390625,
    "kBytesIn": 2500.0,
    "kBytesOut": 21.025390625,
    "outboundKBytes": 21.025390625,
    "impactedHostTotalKBytes": 2521.025390625,
    "keyField": "messageId",
    "count": 1,
    "classificationId": 3200,
    "classificationName": "Error",
    "classificationTypeName": "Operations",
    "commonEventName": "HTTP 504 : Server Error - Gateway Time-Out",
    "commonEventId": 8938,
    "direction": 3,
    "directionName": "External",
    "entityId": 2,
    "entityName": "EchoTestEntity",
    "rootEntityId": 2,
    "rootEntityName": "EchoTestEntity",
    "impactedEntityId": -100,
    "impactedEntityName": "Global Entity",
    "impactedHost": "192.0.2.11",
    "impactedInterface": "0",
    "impactedIp": "192.0.2.11",
    "impactedPort": 80,
    "impactedZoneName": "External",
    "indexedDate": 1629460029041,
    "insertedDate": 1629123439811,
    "logDate": 1629134239789,
    "logMessage": "CISCONGFW EVENT Ev_Id=436 Ev",
    "logSourceHost": "EchoTestHost",
    "logSourceHostId": 2,
    "logSourceHostName": "EchoTestHost",
    "logSourceId": 15,
    "logSourceName": "Echo_2_1000107",
    "logSourceType": 1000107,
    "logSourceTypeName": "Flat File - Cisco NGFW",
    "messageId": "23066",
    "messageTypeEnum": 2,
    "mpeRuleId": 1176829,
    "mpeRuleName": "HTTP 504 : Server Error : Gateway Timeout",
    "normalDate": 1629123439791,
    "normalDateMin": 1629123439791,
    "normalMsgDateMax": 1629123439791,
    "normalDateHour": 1629122400000,
    "originEntityId": -100,
    "originEntityName": "Global Entity",
    "originHostId": -1,
    "originHost": "192.0.2.12",
    "originInterface": "0",
    "originIp": "192.0.2.12",
    "originPort": 14042,
    "originZone": 3,
    "originZoneName": "External",
    "priority": 38,
    "process": "5",
    "processId": 300003,
    "protocolId": 6,
    "protocolName": "TCP",
    "serviceId": 1388,
    "serviceName": "HTTP",
    "portProtocol": "HTTP",
    "session": "436",
    "severity": "57",
    "url": "http://www.google.com/",
    "vendorMessageId": "504",
    "version": "2",
    "status": "504"
}

案件總覽
結果類型 值 / 說明 類型
輸出訊息*

動作不應失敗,也不應停止執行應對手冊:

如果找到一個實體的資料 (is_success=true):「Successfully retrieved events for the following entities in LogRhythm: {entity.identifier}.」(已成功擷取 LogRhythm 中下列實體的事件:{entity.identifier}。)

如果一個實體失敗 (is_success=true):「Action wasn't able to retrieve events for the following entities in LogRhythm: {entity.identifier}.」(動作無法擷取 LogRhythm 中下列實體的事件:{entity.identifier}。)

如果所有實體都失敗 (is_success=false):「Action wasn't able to retrieve events for the provided entities in LogRhythm.」(動作無法在 LogRhythm 中擷取所提供實體的事件)。

如果至少有一個實體沒有資料 (is_success=true):「在 LogRhythm 中找不到下列實體的事件:{entity.identifier}。」

如果所有實體都沒有資料 (is_success=false):「LogRhythm 中找不到所提供實體的事件。」

如果某個實體發生逾時情形 (is_success=true):「動作在執行期間逾時。待處理的實體:{entities that didn't return data}。請在 IDE 中增加動作逾時時間。」

非同步訊息:「等待下列實體的活動資訊:{entity.identifier}」

動作應會失敗並停止執行應對手冊:

如果系統回報嚴重錯誤,例如憑證錯誤、無法連線至伺服器或其他錯誤:「執行動作『列出實體事件』時發生錯誤。Reason: {0}''.format(error.Stacktrace)"

如果所有實體都發生逾時情形 (is_success=false):「Error executing action "List Entity Events". 原因:動作在執行期間逾時。系統未擷取所提供實體的事件資訊。請在 IDE 中增加動作逾時時間。」

如果「開始時間」參數為空白,且「時間範圍」參數設為「自訂」(失敗):「執行動作時發生錯誤」。原因:「時間範圍」參數選取「自訂」時,應提供「開始時間」。

如果「開始時間」參數的值大於「結束時間」參數的值 (失敗):「執行動作時發生錯誤」。原因:「結束時間」應晚於「開始時間」。

如果要傳回的項目數量上限不大於 0:「執行動作時發生錯誤」。原因:「要傳回的事件數量上限」應大於 0。

一般
案件總覽表格

資料表名稱:{entity.identifier}

資料表資料欄:

  • 分類:「classificationName」
  • 事件名稱:「commonEventName」日期:已轉換為 ISO (insertedDate)
  • 受影響的主機:impactedHost
  • 受影響的 IP:impactedIP 登入:login 雜湊:hash 網址:url
  • 優先順序:優先處理的 CVE:CVE 來源
  • 主機:originHost
  • 來源 IP:originIP

注意:如果至少有一筆記錄含有值,系統就會顯示這個資料欄。

實體

連接器

LogRhythm Cases 連接器

說明

從 LogRhythm 提取案件。

連結器參數

參數顯示名稱 類型 預設值 是否為必要項目 說明
產品欄位名稱 字串 不適用 輸入來源欄位名稱,即可擷取產品欄位名稱。
事件欄位名稱 字串 event_type 輸入來源欄位名稱,即可擷取事件欄位名稱。
環境欄位名稱 字串 ""

說明儲存環境名稱的欄位名稱。

如果找不到環境欄位,環境就是預設環境。

環境規則運算式模式 字串 .*

要對「環境欄位名稱」欄位中的值執行的 regex 模式。

預設值為 .*,可擷取所有內容並傳回未變更的值。

用於允許使用者透過規則運算式邏輯操控環境欄位。

如果 regex 模式為空值或空白,或環境值為空值,最終環境結果就是預設環境。

指令碼逾時 (秒) 整數 180 執行目前指令碼的 Python 程序逾時限制。
API 根目錄 字串 https://{IP}:8501 LogRhythm 執行個體的 API 根目錄。
API 權杖 密碼 不適用 LogRhythm API 權杖。
最多可回溯的天數 整數 1 要擷取案件的天數。
要擷取的最低優先順序 整數 不適用

用於擷取案件的最低優先順序。

如未提供任何優先順序,系統會擷取所有優先順序的案件。

可能的值:1 到 5。

快訊數量上限 整數 10 每個連接器疊代要處理的案件數。
CA 憑證檔案 字串 不適用 Base64 編碼的 CA 憑證檔案。
將許可清單當做封鎖清單使用 核取方塊 已取消勾選 啟用後,系統會將許可清單視為封鎖清單。
驗證 SSL 核取方塊 已取消勾選 如果已啟用,請確認連線至 LogRhythm 伺服器的 SSL 憑證是否有效。
Proxy 伺服器位址 字串 不適用 要使用的 Proxy 伺服器位址。
Proxy 使用者名稱 字串 不適用 用於驗證的 Proxy 使用者名稱。
Proxy 密碼 密碼 不適用 用於驗證的 Proxy 密碼。

連接器規則

Proxy 支援

連接器支援 Proxy。

LogRhythm - Rest API Alarms Connector

說明

使用 Rest API 從 LogRhythm 提取警報。

在 Google SecOps 中設定 LogRhythm - Rest API Alarms 連接器

如需在 Google SecOps 中設定連接器的詳細操作說明,請參閱設定連接器

連接器參數

請使用下列參數設定連接器:

參數顯示名稱 類型 預設值 為必填項目 說明
產品欄位名稱 字串 產品名稱 輸入來源欄位名稱,即可擷取產品欄位名稱。
事件欄位名稱 字串 classificationTypeName 輸入來源欄位名稱,即可擷取事件欄位名稱。
環境欄位名稱 字串 ""

說明儲存環境名稱的欄位名稱。

如果找不到環境欄位,環境就是預設環境。

環境規則運算式模式 字串 .*

要對「環境欄位名稱」欄位中的值執行的 regex 模式。

預設值為 .*,可擷取所有內容並傳回未變更的值。

用於允許使用者透過規則運算式邏輯操控環境欄位。

如果 regex 模式為空值或空白,或環境值為空值,最終環境結果就是預設環境。

指令碼逾時 (秒) 整數 180 執行目前指令碼的 Python 程序逾時限制。
API 根層級 字串 https://{IP}:8501 LogRhythm 執行個體的 API 根目錄。
API 權杖 密碼 不適用 LogRhythm API 權杖。
可倒轉的小時數上限 整數 1 要擷取快訊的小時數。
要擷取的鬧鐘數量上限 整數 10 每個連接器疊代要處理的快訊數量。
將許可清單當做封鎖清單使用 核取方塊 已取消勾選 啟用後,系統會將許可清單視為封鎖清單。
驗證 SSL 核取方塊 已取消勾選 如果已啟用,請確認連線至 LogRhythm 伺服器的 SSL 憑證是否有效。
Proxy 伺服器位址 字串 不適用 要使用的 Proxy 伺服器位址。
Proxy 使用者名稱 字串 不適用 用於驗證的 Proxy 使用者名稱。
Proxy 密碼 密碼 不適用 用於驗證的 Proxy 密碼。

連接器規則

Proxy 支援

連接器支援 Proxy。

工作

同步處理案件留言

說明

這項工作會同步處理 LogRhythm 案件和 Google SecOps 案件中的註解。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
API 根目錄 字串 https://{IP}:8501 LogRhythm 執行個體的 API 根目錄。
API 權杖 密碼 不適用 LogRhythm API 權杖。
CA 憑證檔案 字串 不適用 Base64 編碼的 CA 憑證檔案。
驗證 SSL 核取方塊 已勾選 如果已啟用,請確認連線至 LogRhythm 伺服器的 SSL 憑證是否有效。

同步處理已結案的案件

說明

這項工作會同步處理已結案的 LogRhythm 案件和 Google SecOps 警報。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
API 根目錄 字串 https://{IP}:8501 LogRhythm 執行個體的 API 根目錄。
API 權杖 密碼 不適用 LogRhythm API 權杖。
CA 憑證檔案 字串 不適用 Base64 編碼的 CA 憑證檔案。
可倒轉的小時數上限 整數 24 指定要回溯同步處理狀態的小時數。
驗證 SSL 核取方塊 已勾選 如果已啟用,請確認連線至 LogRhythm 伺服器的 SSL 憑證是否有效。

同步處理警報註解

說明

這項工作會同步處理 LogRhythm 警報和 Google SecOps 案件中的留言。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
API 根目錄 字串 https://{IP}:8501 LogRhythm 執行個體的 API 根目錄。
API 權杖 密碼 不適用 LogRhythm API 權杖。
CA 憑證檔案 字串 不適用 Base64 編碼的 CA 憑證檔案。
驗證 SSL 核取方塊 已勾選 如果已啟用,請確認連線至 LogRhythm 伺服器的 SSL 憑證是否有效。

同步處理已關閉的鬧鐘

說明

這項工作會同步處理已關閉的 LogRhythm 警報和 Google SecOps 快訊。

參數

參數顯示名稱 類型 預設值 為必填項目 說明
API 根目錄 字串 https://{IP}:8501 LogRhythm 執行個體的 API 根目錄。
API 權杖 密碼 不適用 LogRhythm API 權杖。
CA 憑證檔案 字串 不適用 Base64 編碼的 CA 憑證檔案。
可倒轉的小時數上限 整數 24 指定要回溯同步處理狀態的小時數。
驗證 SSL 核取方塊 已勾選 如果已啟用,請確認連線至 LogRhythm 伺服器的 SSL 憑證是否有效。

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