将 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 服务账号配置 playbook 中所用操作所需的最低权限,如下表所示:

操作 所需的 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 中配置集成,请参阅配置集成。

如有需要,您可以在后续阶段进行更改。配置集成实例后,您可以在 playbook 中使用该实例。如需详细了解如何配置和支持多个实例,请参阅支持多个实例。

操作

如需详细了解操作,请参阅在工作桌上响应待处理的操作和在案例中运行手动操作。

允许 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 Allow IP request。

Owner

可选。

拥有变更请求的用户的用户名或标识符。

如果您未提供值,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 参数。

操作输出

Allow IP(允许 IP)操作会提供以下输出:

操作输出类型 可用性
案例墙附件 不可用
案例墙链接 可用
案例墙表格 不可用
实体丰富化表 不可用
JSON 结果 可用
输出消息 可用
脚本结果 可用

允许 IP 操作会在案例墙上提供以下链接:

  • 链接标题:Change Request Link

  • 链接目标:在 AlgoSec FireFlow 网页界面中打开创建的流量更改请求。

JSON 结果

以下示例展示了使用允许 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 格式,并将所有自定义字段设置为有效的键值对。

脚本结果

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

可选。

拥有变更请求的用户的用户名或标识符。如果您省略此参数,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 结果

以下示例展示了使用屏蔽 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

列出模板

使用列出模板操作检索在 AlgoSec FireFlow 中配置的可用变更请求模板。您可以按名称过滤模板,以确定在自动执行流量更改请求时所需的确切模板名称。

此操作不会在 Google SecOps 实体上运行。

操作输入

List Templates 操作需要以下参数:

参数 说明
Filter Logic

可选。

使用 Filter Value 参数过滤模板名称时应用的匹配逻辑。

可能的值如下:

  • Equal
  • Contains

默认值为 Equal。

Filter Value

可选。

区分大小写的模板名称或子字符串,用于根据所选 Filter Logic 过滤可用模板。

如果您未指定过滤条件值,该操作将返回所有模板,直至达到配置的上限。

Max Templates To Return

可选。

要返回的模板数量上限。

默认值为 50。

操作输出

列出模板操作提供以下输出:

操作输出类型 可用性
案例墙附件 不可用
案例墙链接 不可用
案例墙表格 可用
实体丰富化表 不可用
JSON 结果 可用
输出消息 可用
脚本结果 可用
案例墙表格

列出模板操作会在案例墙上提供下表:

  • 表名称:Available Templates

  • 列:

    • Name
    • Description
    • Type
JSON 结果

以下示例展示了使用列出模板操作时收到的 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
    }
]
输出消息

列出模板操作提供以下输出消息:

输出消息 消息说明
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 的数字。

脚本结果

下表列出了使用列出模板操作时脚本结果输出的值:

脚本结果名称 值
is_success true 或 false

Ping

使用 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

等待变更请求状态更新

使用等待变更请求状态更新操作,在 AlgoSec FireFlow 中监控流量变更请求,直到其达到目标状态。

此操作不会在 Google SecOps 实体上运行。

操作输入

等待变更请求状态更新操作需要以下参数:

参数 说明
Request ID

必填。

要监控的 AlgoSec 流量更改请求的数字标识符。

Status

必填。

以英文逗号分隔的目标生命周期状态列表,这些状态在匹配时会完成操作。如果您提供了至少一个有效状态,则该操作会忽略无效状态名称。

可能的值如下:

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

默认值为 resolved。

操作输出

等待变更请求状态更新操作提供以下输出:

操作输出类型 可用性
案例墙附件 不可用
案例墙链接 不可用
案例墙表格 不可用
实体丰富化表 不可用
JSON 结果 可用
输出消息 可用
脚本结果 可用
JSON 结果

以下示例展示了使用等待变更请求状态更新操作时收到的 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"
            }
        ]
    }
}
输出消息

等待变更请求状态更新操作会提供以下输出消息:

输出消息 消息说明
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 服务器凭据是否有效。

脚本结果

下表列出了使用等待变更请求状态更新操作时脚本结果输出的值:

脚本结果名称 值
is_success true 或 false

需要更多帮助?获得社区成员和 Google SecOps 专业人士的解答。