將 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 伺服器的基準網址,格式為 https://SERVER_ADDRESS。

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 範本名稱。

預設值為 Standard。

Source

必填。

以半形逗號分隔的清單,列出允許規則的來源 IP 位址或網路物件,或使用關鍵字 all 納入所有來源。這項動作會將所有值轉換為小寫。

預設值為 all。

Service

必填。

以半形逗號分隔的允許網路服務清單,格式為通訊協定和通訊埠組合 (例如 tcp/80),或使用關鍵字 all 允許所有服務。

預設值為 ALL。

Subject

選填。

AlgoSec FireFlow 中流量變更要求的主旨行。

預設值為 Siemplify Allow IP request。

Owner

選填。

變更要求擁有者的使用者名稱或 ID。

如未提供值,AlgoSec 會將建立票證的已驗證使用者指派為擁有者。

Due Date

選填。

變更要求的預計完成日期和時間,採用 ISO 8601 格式,例如 2021-08-13T08:16:10Z。

Expiration Date

選填。

允許流量規則的到期日期和時間,採用 ISO 8601 格式,例如 2021-08-13T08:16:10Z。

Custom Fields

選填。

以鍵/值組合形式提供的其他 FireFlow 變更要求欄位,例如 {"Owner": "admin@example.com", "Subject": "Allow IP request"}。

如果提供這個參數,則會覆寫 Subject、Owner、Due Date 和 Expiration Date 參數。

動作輸出內容

「允許 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 範本名稱。

預設值為 Standard。

Source

必填。

以半形逗號分隔的封鎖規則來源 IP 位址或網路物件清單,或使用關鍵字 all 納入所有來源。這項動作會將所有值轉換為小寫。

預設值為 all。

Service

必填。

以逗號分隔的網路服務清單,格式為通訊協定和通訊埠組合 (例如 tcp/80),或使用關鍵字 all 封鎖所有服務。

預設值為 ALL。

Subject

選填。

AlgoSec FireFlow 中流量變更要求的主旨行。

預設值為 Siemplify Block IP request。

Owner

選填。

變更要求擁有者的使用者名稱或 ID。 如果省略這個參數,AlgoSec 會將建立票證的已驗證使用者指派為擁有者。

Due Date

選填。

變更要求的預計完成日期和時間,採用 ISO 8601 格式,例如 2021-08-13T08:16:10Z。

Expiration Date

選填。

封鎖流量規則的到期日期和時間,採用 ISO 8601 格式,例如 2021-08-13T08:16:10Z。

Custom Fields

選填。

以鍵/值組合形式提供的其他 FireFlow 變更要求欄位,例如 {"Owner": "admin@example.com", "Subject": "Block IP request"}。

如果提供這個參數,則會覆寫 Subject、Owner、Due Date 和 Expiration Date 參數。

動作輸出內容

「封鎖 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 參數篩選範本名稱時,套用的比對邏輯。

可能的值如下:

  • Equal
  • Contains

預設值為 Equal。

Filter Value

選填。

範本名稱 (區分大小寫) 或子字串,用於根據所選 Filter Logic 篩選可用範本。

如未指定篩選器值,這項動作會傳回所有範本,直到達到設定的上限。

Max Templates To Return

選填。

要傳回的範本數量上限。

預設值為 50。

動作輸出內容

「List Templates」動作會提供下列輸出內容:

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

「List Templates」動作會在案件牆上提供下表:

  • 資料表名稱:Available Templates

  • 資料欄:

    • Name
    • Description
    • Type
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 中有範本,並檢查 Filter Value 參數的拼寫和大小寫,或將 Filter Logic 變更為 Contains。

Error executing action AlgoSec - List Templates. Reason: ERROR_REASON

動作失敗。

請確認 AlgoSec 伺服器連線參數有效,且 Max Templates To Return 設為大於 0 的數字。

指令碼執行結果

下表列出使用「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 可連上 API Root 網址、Username 和 Password 憑證有效,以及 SSL 憑證設定正確。

指令碼執行結果

下表列出使用 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

必填。

以半形逗號分隔的目標生命週期狀態清單,符合時會完成動作。如果您提供至少一個有效狀態,這項動作會忽略無效的狀態名稱。

可能的值如下:

  • resolved
  • reconcile
  • open
  • check
  • implementation plan
  • implement
  • validate

預設值為 resolved。

動作輸出內容

「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

動作失敗。

確認 Request ID 對應至現有的流量變更要求、Status 參數中至少提供一個有效值,以及 AlgoSec 伺服器憑證有效。

指令碼執行結果

下表列出使用「Wait for Change Request Status Update」動作時,指令碼結果輸出的值:

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

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