Cisco Orbital
本文說明如何將 Cisco Orbital 與 Google Security Operations 整合。
應用實例
執行主動動作：執行 SQL 查詢，取得端點的更多資訊。
設定 Cisco Orbital 整合，以便與 Google Security Operations 搭配使用
產品權限
如要驗證，您必須產生權杖，並在 API 要求中使用。
如何產生用戶端 ID 和用戶端密鑰
如要產生用戶端 ID 和用戶端密鑰，請按照下列步驟操作：
- 登入 Cisco Orbital。
- 前往帳戶設定，然後按一下「Create API Credentials」。
- 填寫欄位。
- 複製用戶端 ID 和用戶端密鑰。
在 Google SecOps 中設定 Cisco Orbital 整合
如要瞭解如何在 Google SecOps 中設定整合功能，請參閱「設定整合功能」一文。
整合參數
請使用下列參數設定整合：
| 參數顯示名稱 | 類型 | 預設值 | 為必填項目 | 說明 |
|---|---|---|---|---|
| 執行個體名稱 | 字串 | 不適用 | 否 | 要設定整合的執行個體名稱。 |
| 說明 | 字串 | 不適用 | 否 | 執行個體的說明。 |
| 用戶端 ID | 字串 | 不適用 | 是 | Cisco Orbital 帳戶的用戶端 ID。 |
| 用戶端密鑰 | 密碼 | 不適用 | 是 | Cisco Orbital 帳戶的用戶端密鑰。 |
| 驗證 SSL | 核取方塊 | 已勾選 | 否 | 如果啟用，系統會驗證與 Cisco Orbital 伺服器連線的 SSL 憑證是否有效。 |
| 遠端執行 | 核取方塊 | 已取消勾選 | 否 | 勾選這個欄位，即可從遠端執行設定的整合項目。勾選後，系統會顯示選取遠端使用者 (代理) 的選項。 |
動作
乒乓
說明
在 Google SecOps Content Hub 的整合設定頁面，使用提供的參數測試與 Cisco Orbital 的連線能力。
參數
不適用
執行日期
這項動作不會對實體執行，也沒有必要輸入參數。
動作執行結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
案件總覽
| 結果類型 | 值 / 說明 | 類型 |
|---|---|---|
| 輸出訊息* | 動作不應失敗，也不應停止執行應對手冊： 如果成功： 「已使用提供的連線參數成功連線至 Cisco Orbital 伺服器！」 動作應失敗並停止執行應對手冊： 如果未成功： 「Failed to connect to the Cisco Orbital server! 錯誤為 {0}".format(exception.stacktrace) |
一般 |
執行查詢
說明
根據 Cisco Orbital 中的 IP 和主機名稱實體，對端點執行查詢。
參數
| 參數顯示名稱 | 類型 | 預設值 | 為必填項目 | 說明 |
|---|---|---|---|---|
| 查詢 | 字串 | 不適用 | 是 | 指定要執行的查詢。 |
| 名稱 | 字串 | 不適用 | 否 | 指定查詢工作的名稱。如未指定，動作會使用下列格式的名稱：PRODUCT_NAME-GUID |
| 自訂脈絡資料欄位 | 字串 | 不適用 | 否 | 指定應新增至工作的其他自訂背景資訊欄位。格式：key_1:value_1,key_2:value_1。 |
| 要傳回的結果數量上限 | 整數 | 100 | 否 | 指定應傳回的結果數量。 |
| 隱藏案件總覽表格 | 核取方塊 | 不適用 | 否 | 如果啟用，動作就不會準備案件牆表格。 |
| 逾時 | 整數 | 1 | 否 | 指定要等待結果幾分鐘，再完成動作執行。最長 5 分鐘。預設值：1 分鐘。 |
執行日期
這項動作會對下列實體執行：
- IP 位址
- 主機
動作執行結果
指令碼執行結果
| 指令碼執行結果名稱 | 價值選項 | 範例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 結果
{
"results": [
{
"node": "eXHZw6pLMxepKQtf9B8VTQ",
"osQuery": [
{
"sql": "SELECT name,pid FROM processes;"
}
],
"osQueryResult": [
{
"types": [
"",
""
],
"columns": [
"name",
"pid"
],
"values": [
"[System Process]",
"0",
"System",
"4",
"Registry",
"88",
"smss.exe",
"516",
"csrss.exe",
"596",
"wininit.exe",
"672",
"csrss.exe",
"680",
"winlogon.exe",
"724",
"services.exe",
"796",
"lsass.exe",
"804",
"svchost.exe",
"916",
"fontdrvhost.exe",
"936",
"svchost.exe",
"944",
"svchost.exe",
"1020",
"svchost.exe",
"296",
"fontdrvhost.exe",
"560",
"dwm.exe",
"1048",
"svchost.exe",
"1136",
"svchost.exe",
"1144",
"svchost.exe",
"1192",
"svchost.exe",
"1256",
"svchost.exe",
"1280",
"svchost.exe",
"1372",
"svchost.exe",
"1392",
"svchost.exe",
"1488",
"svchost.exe",
"1504",
"svchost.exe",
"1552",
"svchost.exe",
"1604",
"svchost.exe",
"1716",
"svchost.exe",
"1724",
"svchost.exe",
"1804",
"svchost.exe",
"1812",
"svchost.exe",
"1964"
],
"error": "",
"secs": 0.06800670176744461,
"label": "",
"name": ""
}
],
"error": {
"en": ""
},
"hostinfo": {
"osinfo": {
"os": "windows",
"osname": "Windows 10 Enterprise Evaluation",
"release": "6.3",
"version": "10.0.18363",
"arch": "amd64"
},
"hostname": "TIP-HW-HOST-034",
"interfaces": {
"Ethernet0": {
"name": "Ethernet0",
"mac": "00:50:56:a2:05:8b",
"ipv4": "172.30.202.128/24",
"ipv6": "fe80::983:e8ed:c392:3e3e/64",
"active": true
}
},
"external": {
"name": "",
"mac": "",
"ipv4": "185.180.102.139",
"active": true
},
"updated": "2020-10-12T12:03:30.1329732Z",
"version": "v1.7.6"
},
"rowcount": 149,
"context": {
"description": "front desk",
"lol": "kek",
"value": "anything\"}"
}
},
{
"node": "oHNPQUeWwK1ql3R2J13GSw",
"osQuery": [
{
"sql": "SELECT name,pid FROM processes;"
}
],
"osQueryResult": [
{
"types": [
"",
""
],
"columns": [
"name",
"pid"
],
"values": [
"[System Process]",
"0",
"System",
"4",
"Registry",
"88",
"smss.exe",
"360",
"csrss.exe",
"440",
"wininit.exe",
"520",
"csrss.exe",
"536",
"winlogon.exe",
"616",
"services.exe",
"656",
"lsass.exe",
"664",
"svchost.exe",
"772",
"fontdrvhost.exe",
"784",
"fontdrvhost.exe",
"792",
"svchost.exe",
"864",
"svchost.exe",
"6852",
"SystemSettings.exe",
"7864",
"YourPhone.exe",
"5160",
"RuntimeBroker.exe",
"516",
"dllhost.exe",
"1496"
],
"error": "",
"secs": 0.025061199441552162,
"label": "",
"name": ""
}
],
"error": {
"en": ""
},
"hostinfo": {
"osinfo": {
"os": "windows",
"osname": "Windows 10 Enterprise Evaluation",
"release": "6.3",
"version": "10.0.18363",
"arch": "amd64"
},
"hostname": "TIP-HW-HOST-033",
"fqdn": {
"127.0.0.1": "www.virustotal.com"
},
"interfaces": {
"Ethernet0": {
"name": "Ethernet0",
"mac": "00:50:56:a2:66:8a",
"ipv4": "172.30.202.127/24",
"ipv6": "fe80::84:5a0f:7973:63/64",
"active": true
}
},
"external": {
"name": "",
"mac": "",
"ipv4": "185.180.102.139",
"active": true
},
"updated": "2020-10-07T00:11:31.0951018Z",
"version": "v1.7.6"
},
"rowcount": 132,
"context": {
"description": "front desk",
"lol": "kek",
"value": "anything\"}"
}
}
],
"error": {
"en": ""
},
"next": ""
}
案件總覽
| 結果類型 | 值 / 說明 | 類型 |
|---|---|---|
| 輸出訊息\* | 動作不應失敗，也不應停止執行應對手冊： 如果 SQL 查詢在其中一個實體上執行時未發生錯誤 (is_success=true)： "Successfully executed query and retrieved results from Cisco Orbital on the following entities:\n".format(entity.identifier) 如果未在某些實體上執行 SQL 查詢 (is_success=true)： "Action wasn't able to successfully execute query and retrieve results from Cisco Orbital on the following entities:\n".format(entity.identifier) 如果第一個回應回報 400 狀態碼 (is_success=false)：「Action wasn't able to execute queries in Cisco Orbital. Reason: {0}".format(comma-separated list of errors) 如果所有結果都發生錯誤：「動作無法在 Cisco Orbital 中對所有提供的實體執行查詢。原因：查詢有誤。」 非同步訊息：「已提交查詢。等待結果，直到逾時。」 動作應失敗並停止執行應對手冊： 如果發生嚴重錯誤，例如憑證錯誤、無法連線至伺服器等，系統會回報： 「Error executing action "List Buckets". 原因：{0}''.format(error.Stacktrace) 如果「Timeout」參數不在 1 到 5 的範圍內：「Timeout value should be in range from 1 to 5.」 |
一般 |
案件總覽表格 針對沒有錯誤的結果 |
如果實體類型是主機名稱： 資料表名稱： "Results for {0}".format(entity.identifier) 如果是其他實體類型： 資料表名稱： "Results for {0} ({1})".format(entity.identifier, hostinfo/hostname) 回應中的所有資料欄都會做為表格資料欄。 |
一般 |
還有其他問題嗎？向社群成員和 Google SecOps 專家尋求解答。