将 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 服务器的基础网址,格式为 |
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 模板的名称。 默认值为 |
Source |
必填。 允许规则的来源 IP 地址或网络对象的逗号分隔列表,或包含所有来源的关键字 默认值为 |
Service |
必填。 以逗号分隔的要允许的网络服务列表,格式为协议和端口对(例如 默认值为 |
Subject |
可选。 AlgoSec FireFlow 中流量更改请求的主题行。 默认值为 |
Owner |
可选。 拥有变更请求的用户的用户名或标识符。 如果您未提供值,AlgoSec 会将创建工单的经过身份验证的用户指定为所有者。 |
Due Date |
可选。 采用 ISO 8601 格式的变更请求的目标完成日期和时间,例如 |
Expiration Date |
可选。 允许的流量规则的失效日期和时间,采用 ISO 8601 格式,例如 |
Custom Fields |
可选。 以键值对形式提供的其他 FireFlow 变更请求字段,例如 如果提供,此参数会替换 |
操作输出
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 模板的名称。 默认值为 |
Source |
必填。 屏蔽规则的来源 IP 地址或网络对象的逗号分隔列表,或包含所有来源的关键字 默认值为 |
Service |
必填。 要屏蔽的网络服务的逗号分隔列表,格式为协议和端口对(例如 默认值为 |
Subject |
可选。 AlgoSec FireFlow 中流量更改请求的主题行。 默认值为 |
Owner |
可选。 拥有变更请求的用户的用户名或标识符。如果您省略此参数,AlgoSec 会将创建工单的经过身份验证的用户分配为所有者。 |
Due Date |
可选。 采用 ISO 8601 格式的变更请求的目标完成日期和时间,例如 |
Expiration Date |
可选。 屏蔽流量规则的失效日期和时间,采用 ISO 8601 格式,例如 |
Custom Fields |
可选。 以键值对形式提供的其他 FireFlow 变更请求字段,例如 如果提供,此参数会替换 |
操作输出
屏蔽 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 |
可选。 区分大小写的模板名称或子字符串,用于根据所选 如果您未指定过滤条件值,该操作将返回所有模板,直至达到配置的上限。 |
Max Templates To Return |
可选。 要返回的模板数量上限。 默认值为 |
操作输出
列出模板操作提供以下输出:
| 操作输出类型 | 可用性 |
|---|---|
| 案例墙附件 | 不可用 |
| 案例墙链接 | 不可用 |
| 案例墙表格 | 可用 |
| 实体丰富化表 | 不可用 |
| JSON 结果 | 可用 |
| 输出消息 | 可用 |
| 脚本结果 | 可用 |
案例墙表格
列出模板操作会在案例墙上提供下表:
表名称:
Available Templates列:
NameDescriptionType
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 中是否存在模板,并检查 |
Error executing action AlgoSec - List Templates. Reason:
ERROR_REASON |
操作失败。 验证 AlgoSec 服务器连接参数是否有效,以及 |
脚本结果
下表列出了使用列出模板操作时脚本结果输出的值:
| 脚本结果名称 | 值 |
|---|---|
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 访问 |
脚本结果
下表列出了使用 Ping 操作时脚本结果输出的值:
| 脚本结果名称 | 值 |
|---|---|
is_success |
true 或 false |
等待变更请求状态更新
使用等待变更请求状态更新操作,在 AlgoSec FireFlow 中监控流量变更请求,直到其达到目标状态。
此操作不会在 Google SecOps 实体上运行。
操作输入
等待变更请求状态更新操作需要以下参数:
| 参数 | 说明 |
|---|---|
Request ID |
必填。 要监控的 AlgoSec 流量更改请求的数字标识符。 |
Status |
必填。 以英文逗号分隔的目标生命周期状态列表,这些状态在匹配时会完成操作。如果您提供了至少一个有效状态,则该操作会忽略无效状态名称。 可能的值如下:
默认值为 |
操作输出
等待变更请求状态更新操作提供以下输出:
| 操作输出类型 | 可用性 |
|---|---|
| 案例墙附件 | 不可用 |
| 案例墙链接 | 不可用 |
| 案例墙表格 | 不可用 |
| 实体丰富化表 | 不可用 |
| 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 |
操作失败。 验证 |
脚本结果
下表列出了使用等待变更请求状态更新操作时脚本结果输出的值:
| 脚本结果名称 | 值 |
|---|---|
is_success |
true 或 false |
需要更多帮助?获得社区成员和 Google SecOps 专业人士的解答。