將 AlgoSec 與 Google SecOps 整合
本文說明如何將 AlgoSec 與 Google Security Operations 整合。
用途
AlgoSec 整合功能會使用 Google SecOps 功能,支援下列用途:
自動化威脅防堵:在安全性調查期間提交自動化捨棄流量變更要求,封鎖受管理防火牆中的惡意 IP 位址。
控管流量授權:在 AlgoSec FireFlow 建立標準化允許規則,允許合法的業務流量傳送至已驗證的目的地 IP 位址。
範本探索和管理:擷取可用的 FireFlow 變更要求範本,確保自動應變動作符合組織的變更管理政策。
非同步變更生命週期追蹤:監控提交的流量變更要求,直到達到目標作業狀態 (例如已解決或實作)。
事前準備
在 Google SecOps 設定 AlgoSec 整合功能前,請確認環境符合下列需求:
網路連線:確認 Google SecOps (或為地端部署環境部署的遠端代理程式),可透過 TCP 通訊埠
443上的 HTTPS 連線至 AlgoSec 伺服器。FireFlow 範本:在 AlgoSec FireFlow 中啟用至少一個流量變更要求範本 (例如
Standard),再執行提交變更要求的動作。最小權限使用者權限:設定專屬 AlgoSec FireFlow 服務帳戶,並授予執行工作手冊動作所需的最低權限,詳情請參閱下表:
| 動作 | 必要的 AlgoSec FireFlow 權限 |
|---|---|
Allow IP |
使用 FireFlow 進行驗證、建立允許規則的流量變更要求,以及讀取流量變更要求詳細資料。 |
Block IP |
使用 FireFlow 進行驗證、建立捨棄規則的流量變更要求,以及讀取流量變更要求詳細資料。 |
List Templates |
使用 FireFlow 進行驗證,並查看可用的變更要求範本。 |
Ping |
使用 FireFlow 進行驗證,並查看可用的變更要求範本,以驗證連線能力。 |
Wait for Change Request Status Update |
使用 FireFlow 進行驗證,並讀取流量變更要求詳細資料和生命週期狀態。 |
如要進一步瞭解如何設定 FireFlow 角色、使用者帳戶和變更要求範本,請參閱 AlgoSec FireFlow 官方說明文件。
整合參數
AlgoSec 整合需要下列參數:
| 參數 | 說明 |
|---|---|
API Root |
必填。 AlgoSec 伺服器的基準網址,格式為 |
Username |
必填。 用於驗證的 AlgoSec FireFlow 帳戶使用者名稱。 |
Password |
必填。 用於驗證的 AlgoSec FireFlow 帳戶密碼。 |
Verify SSL |
必填。 如果選取,整合功能會在連線至 AlgoSec 伺服器時驗證 SSL 憑證。 (預設為啟用)。 |
如要瞭解如何在 Google SecOps 中設定整合功能,請參閱「設定整合功能」。
如有需要,您可以在後續階段進行變更。設定整合執行個體後,即可在應對手冊中使用。如要進一步瞭解如何設定及支援多個執行個體,請參閱「支援多個執行個體」。
動作
如要進一步瞭解動作,請參閱「在工作區回應待處理動作」和「在案件中執行手動動作」。
允許 IP
使用「允許 IP」動作,在 AlgoSec FireFlow 中提交流量變更要求,允許流量傳送至案件的 IP Address 實體 (做為目的地地址)。
這項動作會在 IP Address Google SecOps 實體上執行。
動作輸入內容
「Allow IP」(允許 IP) 動作需要下列參數:
| 參數 | 說明 |
|---|---|
Template |
必填。 要用於流量變更要求的 AlgoSec FireFlow 範本名稱。 預設值為 |
Source |
必填。 以半形逗號分隔的清單,列出允許規則的來源 IP 位址或網路物件,或使用關鍵字 預設值為 |
Service |
必填。 以半形逗號分隔的允許網路服務清單,格式為通訊協定和通訊埠組合 (例如 預設值為 |
Subject |
選填。 AlgoSec FireFlow 中流量變更要求的主旨行。 預設值為 |
Owner |
選填。 變更要求擁有者的使用者名稱或 ID。 如未提供值,AlgoSec 會將建立票證的已驗證使用者指派為擁有者。 |
Due Date |
選填。 變更要求的預計完成日期和時間,採用 ISO 8601 格式,例如 |
Expiration Date |
選填。 允許流量規則的到期日期和時間,採用 ISO 8601 格式,例如 |
Custom Fields |
選填。 以鍵/值組合形式提供的其他 FireFlow 變更要求欄位,例如 如果提供這個參數,則會覆寫 |
動作輸出內容
「允許 IP」動作會提供下列輸出內容:
| 動作輸出類型 | 可用性 |
|---|---|
| 案件總覽附件 | 無法使用 |
| 案件總覽連結 | 可用 |
| 案件總覽表格 | 無法使用 |
| 實體擴充表格 | 無法使用 |
| JSON 結果 | 可用 |
| 輸出訊息 | 可用 |
| 指令碼執行結果 | 可用 |
案件總覽連結
「允許 IP」動作會在案件總覽中提供下列連結:
連結標題:
Change Request Link連結目標:在 AlgoSec FireFlow 網頁介面中,開啟已建立的流量變更要求。
JSON 結果
以下範例顯示使用「Allow IP」(允許 IP) 動作時,收到的 JSON 結果輸出內容:
{
"status": "Success",
"messages": [],
"data": {
"id": 10,
"fields": [
{
"name": "Owner",
"values": [
"admin@example.com"
]
},
{
"name": "Creator",
"values": [
"admin@example.com"
]
},
{
"name": "Due",
"values": [
"2021-08-31 00:00:00"
]
},
{
"name": "LastUpdated",
"values": [
"2021-08-13 12:31:23"
]
},
{
"name": "Requestor",
"values": [
"admin@example.com"
]
}
],
"originalTraffic": [
{
"source": {
"items": [
{
"value": "all"
}
]
},
"destination": {
"items": [
{
"value": "192.0.2.3"
}
]
},
"service": {
"items": [
{
"value": "ALL"
}
]
},
"application": {
"items": [
{
"value": "any"
}
]
},
"user": {
"items": [
{
"value": "any"
}
]
},
"action": "Allow"
}
],
"plannedTraffic": [
{
"source": {
"items": [
{
"value": "0.0.0.0-255.255.255.255"
}
]
},
"destination": {
"items": [
{
"value": "192.0.2.3"
}
]
},
"service": {
"items": [
{
"value": "tcp/*"
},
{
"value": "udp/*"
},
{
"value": "ospf"
},
{
"value": "icmp/*"
},
{
"value": "gre"
},
{
"value": "ipsec_50"
},
{
"value": "ipsec_51"
}
]
},
"application": {
"items": [
{
"value": "any"
}
]
},
"user": {
"items": [
{
"value": "any"
}
]
},
"action": "Allow"
}
]
}
}
輸出訊息
「允許 IP」動作會提供下列輸出訊息:
| 輸出訊息 | 訊息說明 |
|---|---|
Successfully created a traffic change request to allow traffic
to the provided entities in AlgoSec |
動作成功。 |
Error executing action AlgoSec - Allow IP. Reason:
ERROR_REASON |
動作失敗。 請確認 AlgoSec 伺服器網址和憑證有效、FireFlow 中有指定的範本名稱、日期參數採用 ISO 8601 格式,以及所有自訂欄位均採用有效的鍵/值組合格式。 |
指令碼執行結果
下表列出使用「Allow IP」(允許 IP) 動作時,指令碼結果輸出的值:
| 指令碼結果名稱 | 值 |
|---|---|
is_success |
true或false |
封鎖 IP
使用「封鎖 IP」動作,在 AlgoSec FireFlow 中提交流量變更要求,封鎖傳送至案件 IP Address 實體 (做為目的地地址) 的流量。
這項動作會在 IP Address Google SecOps 實體上執行。
動作輸入內容
「封鎖 IP」動作需要下列參數:
| 參數 | 說明 |
|---|---|
Template |
必填。 要用於流量變更要求的 AlgoSec FireFlow 範本名稱。 預設值為 |
Source |
必填。 以半形逗號分隔的封鎖規則來源 IP 位址或網路物件清單,或使用關鍵字 預設值為 |
Service |
必填。 以逗號分隔的網路服務清單,格式為通訊協定和通訊埠組合 (例如 預設值為 |
Subject |
選填。 AlgoSec FireFlow 中流量變更要求的主旨行。 預設值為 |
Owner |
選填。 變更要求擁有者的使用者名稱或 ID。 如果省略這個參數,AlgoSec 會將建立票證的已驗證使用者指派為擁有者。 |
Due Date |
選填。 變更要求的預計完成日期和時間,採用 ISO 8601 格式,例如 |
Expiration Date |
選填。 封鎖流量規則的到期日期和時間,採用 ISO 8601 格式,例如 |
Custom Fields |
選填。 以鍵/值組合形式提供的其他 FireFlow 變更要求欄位,例如 如果提供這個參數,則會覆寫 |
動作輸出內容
「封鎖 IP」動作會提供下列輸出內容:
| 動作輸出類型 | 可用性 |
|---|---|
| 案件總覽附件 | 無法使用 |
| 案件總覽連結 | 可用 |
| 案件總覽表格 | 無法使用 |
| 實體擴充表格 | 無法使用 |
| JSON 結果 | 可用 |
| 輸出訊息 | 可用 |
| 指令碼執行結果 | 可用 |
案件總覽連結
「封鎖 IP」動作會在案件總覽中提供下列連結:
連結標題:
Change Request Link連結目標:在 AlgoSec FireFlow 網頁介面中,開啟已建立的流量變更要求。
JSON 結果
以下範例顯示使用「Block IP」動作時,收到的 JSON 結果輸出內容:
{
"status": "Success",
"messages": [],
"data": {
"id": 11,
"fields": [
{
"name": "Owner",
"values": [
"admin@example.com"
]
},
{
"name": "Creator",
"values": [
"admin@example.com"
]
},
{
"name": "Due",
"values": [
"2021-08-31 00:00:00"
]
},
{
"name": "LastUpdated",
"values": [
"2021-08-13 12:35:10"
]
},
{
"name": "Requestor",
"values": [
"admin@example.com"
]
}
],
"originalTraffic": [
{
"source": {
"items": [
{
"value": "all"
}
]
},
"destination": {
"items": [
{
"value": "192.0.2.3"
}
]
},
"service": {
"items": [
{
"value": "ALL"
}
]
},
"application": {
"items": [
{
"value": "any"
}
]
},
"user": {
"items": [
{
"value": "any"
}
]
},
"action": "Drop"
}
],
"plannedTraffic": [
{
"source": {
"items": [
{
"value": "0.0.0.0-255.255.255.255"
}
]
},
"destination": {
"items": [
{
"value": "192.0.2.3"
}
]
},
"service": {
"items": [
{
"value": "tcp/*"
},
{
"value": "udp/*"
},
{
"value": "ospf"
},
{
"value": "icmp/*"
},
{
"value": "gre"
},
{
"value": "ipsec_50"
},
{
"value": "ipsec_51"
}
]
},
"application": {
"items": [
{
"value": "any"
}
]
},
"user": {
"items": [
{
"value": "any"
}
]
},
"action": "Drop"
}
]
}
}
輸出訊息
「封鎖 IP」動作會提供下列輸出訊息:
| 輸出訊息 | 訊息說明 |
|---|---|
Successfully created a traffic change request to block traffic
to the provided entities in AlgoSec |
動作成功。 |
Error executing action AlgoSec - Block IP. Reason:
ERROR_REASON |
動作失敗。 請確認 AlgoSec 伺服器網址和憑證有效、FireFlow 中有指定的範本名稱、日期參數採用 ISO 8601 格式,以及所有自訂欄位均採用有效的鍵/值組合格式。 |
指令碼執行結果
下表列出使用「封鎖 IP」動作時,指令碼結果輸出的值:
| 指令碼結果名稱 | 值 |
|---|---|
is_success |
true或false |
可列出範本
使用「List Templates」動作,擷取 AlgoSec FireFlow 中設定的可用變更要求範本。您可以依名稱篩選範本,找出自動化流量變更要求所需的確切範本名稱。
這項動作不會在 Google SecOps 實體上執行。
動作輸入內容
List Templates 動作需要下列參數:
| 參數 | 說明 |
|---|---|
Filter Logic |
選填。 使用 可能的值如下:
預設值為 |
Filter Value |
選填。 範本名稱 (區分大小寫) 或子字串,用於根據所選 如未指定篩選器值,這項動作會傳回所有範本,直到達到設定的上限。 |
Max Templates To Return |
選填。 要傳回的範本數量上限。 預設值為 |
動作輸出內容
「List Templates」動作會提供下列輸出內容:
| 動作輸出類型 | 可用性 |
|---|---|
| 案件總覽附件 | 無法使用 |
| 案件總覽連結 | 無法使用 |
| 案件總覽表格 | 可用 |
| 實體擴充表格 | 無法使用 |
| JSON 結果 | 可用 |
| 輸出訊息 | 可用 |
| 指令碼執行結果 | 可用 |
案件總覽表格
「List Templates」動作會在案件牆上提供下表:
資料表名稱:
Available Templates資料欄:
NameDescriptionType
JSON 結果
以下範例顯示使用「List Templates」動作時,收到的 JSON 結果輸出內容:
[
{
"id": 142,
"name": "110: Multi-Approval Request",
"description": "Create a traffic change request which requires multiple approvals",
"type": "Traffic Change",
"enabled": true
},
{
"id": 597,
"name": "190: Verbatim Rule Addition",
"description": "Create a traffic change request for bulk rules addition as specified",
"type": "Traffic Change",
"enabled": true
},
{
"id": 550,
"name": "Basic Change Traffic Request",
"description": "Create a basic change traffic request",
"type": "Traffic Change",
"enabled": true
}
]
輸出訊息
「List Templates」動作會提供下列輸出訊息:
| 輸出訊息 | 訊息說明 |
|---|---|
Successfully found templates for the provided criteria in
AlgoSec. |
動作成功。 |
No templates were found for the provided criteria in
AlgoSec. |
動作失敗。 確認 AlgoSec FireFlow 中有範本,並檢查 |
Error executing action AlgoSec - List Templates. Reason:
ERROR_REASON |
動作失敗。 請確認 AlgoSec 伺服器連線參數有效,且 |
指令碼執行結果
下表列出使用「List Templates」動作時,指令碼結果輸出的值:
| 指令碼結果名稱 | 值 |
|---|---|
is_success |
true或false |
乒乓
使用「Ping」動作,透過設定的整合參數,測試與 AlgoSec 伺服器的連線能力和驗證。
這項動作不會在 Google SecOps 實體上執行。
動作輸入內容
無。
動作輸出內容
Ping 動作會提供下列輸出內容:
| 動作輸出類型 | 可用性 |
|---|---|
| 案件總覽附件 | 無法使用 |
| 案件總覽連結 | 無法使用 |
| 案件總覽表格 | 無法使用 |
| 實體擴充表格 | 無法使用 |
| JSON 結果 | 無法使用 |
| 輸出訊息 | 可用 |
| 指令碼執行結果 | 可用 |
輸出訊息
Ping 動作會提供下列輸出訊息:
| 輸出訊息 | 訊息說明 |
|---|---|
Successfully connected to the AlgoSec server with the provided
connection parameters! |
動作成功。 |
Failed to connect to the AlgoSec server! Error is
ERROR_REASON |
動作失敗。 請確認 Google SecOps 可連上 |
指令碼執行結果
下表列出使用 Ping 動作時,指令碼結果輸出的值:
| 指令碼結果名稱 | 值 |
|---|---|
is_success |
true或false |
等待變更要求狀態更新
使用「Wait for Change Request Status Update」動作,監控 AlgoSec FireFlow 中的流量變更要求,直到達到目標狀態。
這項動作不會在 Google SecOps 實體上執行。
動作輸入內容
「Wait for Change Request Status Update」(等待變更要求狀態更新) 動作需要下列參數:
| 參數 | 說明 |
|---|---|
Request ID |
必填。 要監控的 AlgoSec 流量變更要求數字 ID。 |
Status |
必填。 以半形逗號分隔的目標生命週期狀態清單,符合時會完成動作。如果您提供至少一個有效狀態,這項動作會忽略無效的狀態名稱。 可能的值如下:
預設值為 |
動作輸出內容
「Wait for Change Request Status Update」(等待變更要求狀態更新) 動作會提供下列輸出內容:
| 動作輸出類型 | 可用性 |
|---|---|
| 案件總覽附件 | 無法使用 |
| 案件總覽連結 | 無法使用 |
| 案件總覽表格 | 無法使用 |
| 實體擴充表格 | 無法使用 |
| JSON 結果 | 可用 |
| 輸出訊息 | 可用 |
| 指令碼執行結果 | 可用 |
JSON 結果
以下範例顯示使用「Wait for Change Request Status Update」(等待變更要求狀態更新) 動作時,收到的 JSON 結果輸出內容:
{
"status": "Success",
"messages": [],
"data": {
"id": 6,
"subChangeRequests": [
12
],
"fields": [
{
"name": "Risk Level",
"values": [
"No Risk"
]
},
{
"name": "Owner",
"values": [
"admin@example.com"
]
},
{
"name": "Creator",
"values": [
"admin@example.com"
]
},
{
"name": "LastUpdated",
"values": [
"2021-08-13 13:50:58"
]
},
{
"name": "Requestor",
"values": [
"admin@example.com"
]
},
{
"name": "Form Type",
"values": [
"Traffic Change"
]
},
{
"name": "Risks Number",
"values": [
"0"
]
},
{
"name": "Initial Plan status",
"values": [
"Result OK"
]
},
{
"name": "Workflow",
"values": [
"Basic"
]
},
{
"name": "Subject",
"values": [
"1"
]
},
{
"name": "status",
"values": [
"resolved"
]
}
],
"originalTraffic": [
{
"source": {
"items": [
{
"value": "all"
}
]
},
"destination": {
"items": [
{
"value": "192.0.2.2"
}
]
},
"service": {
"items": [
{
"value": "tcp/80"
}
]
},
"application": {
"items": [
{
"value": "any"
}
]
},
"user": {
"items": [
{
"value": "any"
}
]
},
"action": "Allow"
}
],
"plannedTraffic": [
{
"source": {
"items": [
{
"value": "0.0.0.0-255.255.255.255"
}
]
},
"destination": {
"items": [
{
"value": "192.0.2.2"
}
]
},
"service": {
"items": [
{
"value": "tcp/80"
}
]
},
"application": {
"items": [
{
"value": "any"
}
]
},
"user": {
"items": [
{
"value": "any"
}
]
},
"action": "Allow"
}
]
}
}
輸出訊息
「Wait for Change Request Status Update」(等待變更要求狀態更新) 動作會提供下列輸出訊息:
| 輸出訊息 | 訊息說明 |
|---|---|
Status of the change request with ID
REQUEST_ID was updated to status:
STATUS. |
動作成功。 |
Waiting for a change request to be updated... |
這項動作仍在執行中,並會輪詢 AlgoSec FireFlow,直到變更要求達到其中一個目標狀態為止。 |
Error executing action AlgoSec - Wait for Change Request Status
Update. Reason: action ran into a timeout during execution. Current status
of the change request: STATUS.
Please increase the timeout for the action in the IDE. |
動作失敗。 請在 Google SecOps IDE 中增加動作執行逾時時間,或確認變更要求在 AlgoSec FireFlow 的核准工作流程中正常進行。 |
Error executing action AlgoSec - Wait for Change Request Status
Update. Reason:
ERROR_REASON |
動作失敗。 確認 |
指令碼執行結果
下表列出使用「Wait for Change Request Status Update」動作時,指令碼結果輸出的值:
| 指令碼結果名稱 | 值 |
|---|---|
is_success |
true或false |
還有其他問題嗎?向社群成員和 Google SecOps 專家尋求解答。