将 Palo Alto Next Gen Firewall 与 Google SecOps 集成
本文档提供了有关如何将 Palo Alto Next Gen Firewall 与 Google Security Operations 集成的指南。
准备工作
此集成需要在 PAN-OS 中具有自定义管理员角色。确保 API 账号具有已启用 API 访问权限的角色配置文件。
集成级权限
管理员角色需要对 REST API 或 XML API 标签页中的以下节点具有 Read/Write 访问权限:
- 配置 > 设备:
Address Groups、Address Objects、Security Policies和URL Categories。 - 操作请求:
Commit(用于应用更改)和Operational Requests(Read)。
按操作划分的最低权限
请参阅下表,了解执行每项集成操作所需的特定 API 路径和权限。
| 操作 | 所需权限 |
|---|---|
| 将 IP 添加到群组 | 配置 > 设备 > Address Groups 和 Address Objects (Read/Write) |
| 在政策中屏蔽 IP | 配置 > 设备 > Security Policies 和 Address Objects (Read/Write) |
| 屏蔽网址/取消屏蔽网址 | 配置 > 设备 > URL Categories (Read/Write) |
| 提交更改 | 操作请求 > Commit (Read/Write) |
| 修改/获取遭屏蔽的应用 | 配置 > 设备 > Security Policies (Read/Write) 和操作请求 (Read) |
| Ping | 基准 API 访问权限(密钥生成) |
集成参数
Palo Alto Next Gen Firewall 集成需要以下参数:
| 参数显示名称 | 类型 | 默认值 | 为必填项 | 说明 |
|---|---|---|---|---|
| API 根 | 字符串 | https://x.x.x.x/api | 是 | Palo Alto Networks 新一代防火墙实例的 API 根。 |
| 用户名 | 字符串 | 不适用 | 是 | Palo Alto Networks 新一代防火墙账号的用户名。 |
| 密码 | 密码 | 不适用 | 是 | Palo Alto Networks 新一代防火墙账号的密码。 |
| 验证 SSL | 复选框 | 尚未核查 | 否 | 如果启用此设置,系统会验证与 Palo Alto Networks 新一代防火墙服务器连接的 SSL 证书是否有效。 |
如需了解如何在 Google SecOps 中配置集成,请参阅配置集成。
如有需要,您可以在后续阶段进行更改。配置集成实例后,您可以在 playbook 中使用该实例。如需详细了解如何配置和支持多个实例,请参阅支持多个实例。
操作
如需详细了解操作,请参阅 在工作桌上响应待处理的操作和在案例中运行手动操作。
将 IP 添加到群组
向地址组添加 IP 地址。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 设备名称 | 字符串 | 不适用 | 该组所在的设备名称。NGFW 的默认设备名称为 localhost.localdomain。如果配置不同,请参阅 https://php/rest/browse.php/config::devices,查看所有设备名称的列表,然后选择相关设备。 |
| Vsys 名称 | 字符串 | 不适用 | 指定要对其运行操作的 vsys 的逗号分隔列表。NGFW 的默认 vsys 名称为 vsys1。如果配置不同,请参阅 https://{ip}/php/rest/browse.php/config::devices::entry[@name='{device name{']::vsys,了解设备上所有可用 vsys 的列表。 |
| 地址组名称 | 字符串 | 不适用 | 群组名称值。 |
| 使用共享对象 | 复选框 | 不适用 | 如果启用,操作将使用共享对象,而不是 vsys。注意:如果共享地址组不存在,此操作不会创建共享地址组。 |
使用场景
不适用
运行时间
此操作在 IP 地址实体上运行。
操作执行结果
实体丰富化
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | “值”选项 | 示例 |
|---|---|---|
| 成功 | True/False | success:False |
JSON 结果
["1.1.1.1", "2.2.2.2"]
案例墙
| 结果类型 | 值/说明 | 类型 |
|---|---|---|
| 输出消息* | 一个 vsys 和一个 IP 成功 (is_success=true):已成功将以下 IP 添加到 Palo Alto NGFW 中 vsys“{vsys name}”的群组“{group_name}”:{entity.identifiers} 一个 vsys 和一个 IP 未成功 (is_success=true):操作未能将以下 IP 添加到 Palo Alto NGFW 中 vsys“{vsys name}”的群组“{group_name}”:{entity.identifiers} 并非 vsys 中的所有 IP 都成功(如果所有 vsys 的行为相同,则 is_success=false;如果部分 vsys 的行为相同,则 is_success=true):未将任何 IP 添加到 Palo Alto NGFW 中 vsys“{vsys name}”的群组“{group_name}”。 如果至少有一个 vsys 未找到(失败):执行“将 IP 添加到组”操作时出错。原因:在 Palo Alto NGFW 中找不到以下 vsys:{vsys that were not found} 如果“使用共享对象”处于停用状态,并且未提供“设备名称”和“Vsys 名称”(失败):执行操作“{action_name}”时出错:应启用“使用共享对象”参数,或提供“设备名称”和“Vsys 名称”。 如果设备名称无效(失败):执行“将 IP 添加到群组”操作时出错。原因:找不到设备“{device name}”。请检查拼写。 如果“使用共享对象”已启用,并且至少添加了一个 IP 地址 (is_success=true):已成功将以下 IP 地址添加到 Palo Alto NGFW 中的共享地址组“{Group Name}”:\n {entity.identifier} 如果“使用共享对象”已启用,并且一个 IP 地址已属于地址组 (is_success=true):以下 IP 地址已属于 Palo Alto NGFW 中的共享地址组“{Group Name}”:\n {entity.identifier} 如果“使用共享对象”已启用,且至少有一个 IP 地址未添加 (is_success=true):操作未能将以下 IP 地址添加到 Palo Alto NGFW 中的共享地址组“{Group Name}”:\n {entity.identifier} 如果“使用共享对象”已启用,但未添加任何 IP 地址 (is_success=false):未向 Palo Alto NGFW 中的共享地址组“{Group Name}”添加任何 IP 地址。 如果未找到地址组(失败):执行操作“将 IP 添加到组”时出错。在 Palo Alto NGFW 中找不到共享地址组“{Group Name}”。 严重错误:执行“将 IP 添加到群组”操作时出错。原因:{error traceback} |
常规 |
在政策中屏蔽 IP
在政策中屏蔽 IP 地址(每个 IP 地址需单独添加到政策中)。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 设备名称 | 字符串 | 不适用 | 该组所在的设备名称。NGFW 的默认设备名称为 localhost.localdomain。如果配置不同,请参阅 https://php/rest/browse.php/config::devices,查看所有设备名称的列表,然后选择相关设备。 |
| Vsys 名称 | 字符串 | 不适用 | “指定要执行操作的 vsys 的逗号分隔列表。NGFW 的默认 vsys 名称为 vsys1。如果配置不同,请参阅 https://{ip}/php/rest/browse.php/config::devices::entry[@name='{device name{']::vsys,了解设备上所有可用 vsys 的列表。” |
| 政策名称 | 字符串 | 不适用 | 政策名称值。 |
| 目标 | 字符串 | 不适用 | 必须是来源或目的地。 |
使用场景
不适用
运行时间
此操作在 IP 地址实体上运行。
操作执行结果
实体丰富化
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | “值”选项 | 示例 |
|---|---|---|
| 成功 | True/False | success:False |
JSON 结果
[
"1.1.1.1",
"2.2.2.2"
]
案例墙
| 结果类型 | 值/说明 | 类型 |
|---|---|---|
| 输出消息* | 一个 vsys 和一个 IP 成功 (is_success=true):已成功在 Palo Alto NGFW 中为 vsys“{vsys name}”在政策“{policy name}”中屏蔽以下 IP:{entity.identifiers} 一个 vsys 和一个 IP 未成功 (is_success=true):操作无法在 Palo Alto NGFW 中 vsys“{vsys name}”的政策“{policy_name}”中屏蔽以下 IP:{entity.identifiers} 并非 vsys 中的所有 IP 都成功(如果所有 vsys 的行为相同,则 is_success=false;如果部分 vsys 的行为相同,则 is_success=true):在 Palo Alto NGFW 中,vsys“{vsys name}”的政策“{policy_name}”中未屏蔽任何 IP。 如果在某些 vsys 中未找到政策名称 (is_success=true):在 Palo Alto NGFW 的以下 vsys 中未找到政策“{policy name}”:{vsys that don't have the policy} 如果至少有一个 vsys 未找到(失败):执行操作“在政策中屏蔽 IP”时出错。原因:在 Palo Alto NGFW 中找不到以下 vsys:{vsys that were not found} 如果在所有 vsys 中都找不到政策名称(失败):执行“在政策中屏蔽 IP”操作时出错。原因:在提供的 vsys 中找不到政策“{policy name}”。请检查拼写。 如果设备名称无效(失败):执行“屏蔽政策中的 IP”操作时出错。原因:未找到设备“{device name}”。请检查拼写。 if Target != source or destination: 执行操作“在政策中屏蔽 IP”时出错。原因:目标应为“source”或“destination” 严重错误:执行操作“在政策中屏蔽 IP”时出错。原因:{error traceback} |
常规 |
屏蔽网址
向给定网址类别添加网址。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 设备名称 | 字符串 | 不适用 | 该组所在的设备名称。NGFW 的默认设备名称为 localhost.localdomain。如果配置不同,请参阅 https://php/rest/browse.php/config::devices,查看所有设备名称的列表,然后选择相关设备。 |
| Vsys 名称 | 字符串 | 不适用 | “指定要执行操作的 vsys 的逗号分隔列表。NGFW 的默认 vsys 名称为 vsys1。如果配置不同,请参阅 https://{ip}/php/rest/browse.php/config::devices::entry[@name='{device name{']::vsys,了解设备上所有可用 vsys 的列表。” |
| 网址类别名称 | 字符串 | 不适用 | 政策名称值。 |
| 使用共享对象 | 复选框 | 不适用 | 如果启用,操作将使用共享对象,而不是 vsys。 |
使用场景
不适用
运行时间
此操作在网址实体上运行。
操作执行结果
实体丰富化
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | “值”选项 | 示例 |
|---|---|---|
| 成功 | True/False | success:False |
JSON 结果
[
"www.example.com"
]
案例墙
| 结果类型 | 值/说明 | 类型 |
|---|---|---|
| 输出消息* | 一个 vsys 和一个网址成功(is_success=true):已成功将以下网址添加到 Palo Alto NGFW 中 vsys“{vsys name}”的类别“{category_name}”:{entity.identifiers} 一个 vsys 和一个网址未成功 (is_success=true):操作未能将以下网址添加到 Palo Alto NGFW 中 vsys“{vsys name}”的类别“{category_name}”:{entity.identifiers} 并非 vsys 中的所有网址都成功:未将任何网址添加到 Palo Alto NGFW 中 vsys“{vsys name}”的类别“{category_name}”中。 If Group name wasn't found in some vsys (is_success=true): Category "{category name}" wasn't found in the following vsys in the Palo Alto NGFW: {vsys that don't have the category} 如果“使用共享对象”处于停用状态,并且未提供“设备名称”和“Vsys 名称”(失败):执行操作“{action_name}”时出错:应启用“使用共享对象”参数,或提供“设备名称”和“Vsys 名称”。 如果至少有一个 vsys 未找到(失败):执行操作“屏蔽网址”时出错。原因:在 Palo Alto NGFW 中找不到以下 vsys:{vsys that were not found} 如果在所有 vsys 中都找不到类别名称(失败):执行“屏蔽网址”操作时出错。原因:在提供的 vsys 中找不到类别“{category name}”。请检查拼写。 如果设备名称无效(失败):执行“屏蔽网址”操作时出错。原因:未找到设备“{device name}”。请检查拼写。 如果“使用共享对象”已启用,并且至少添加了一个网址 (is_success=true):已成功将以下网址添加到 Palo Alto NGFW 中的共享类别“{Category Name}”:\n {entity.identifier} 如果“使用共享对象”已启用,并且某个网址已属于网址类别 (is_success=true):以下网址已属于 Palo Alto NGFW 中的共享类别“{Category Name}”:\n {entity.identifier} 如果“使用共享对象”已启用,且至少有一个网址未添加 (is_success=true):操作无法将以下网址添加到 Palo Alto NGFW 中的共享类别“{Category Name}”:\n {entity.identifier} 如果“使用共享对象”已启用,但未添加任何网址 (is_success=false):未向 Palo Alto NGFW 中的共享类别“{Category Name}”添加任何网址。 如果未找到类别(失败):执行“屏蔽网址”操作时出错。在 Palo Alto NGFW 中找不到共享类别“{Category Name}”。 严重错误:执行“屏蔽网址”操作时出错。原因:{error traceback} |
常规 |
提交更改
在 Palo Alto NGFW 中提交更改。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 仅显示我的更改 | 字符串 | 不适用 | 仅提交已配置的用途更改。 |
使用场景
不适用
运行时间
此操作会在所有实体上运行。
操作执行结果
实体丰富化
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | “值”选项 | 示例 |
|---|---|---|
| 成功 | True/False | success:False |
JSON 结果
N/A
修改遭屏蔽的应用
屏蔽和取消屏蔽应用。每个应用都会添加到给定政策中或从中移除。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 要屏蔽的应用 | 字符串 | 不适用 | 要屏蔽的应用列表,以英文逗号分隔。示例:apple-siri,app2 |
| 要取消屏蔽的应用 | 字符串 | 不适用 | 要取消屏蔽的应用列表,以英文逗号分隔。示例:apple-siri,app2 |
| 设备名称 | 字符串 | 不适用 | 该组所在的设备名称。NGFW 的默认设备名称为 localhost.localdomain。如果配置不同,请参阅 https://php/rest/browse.php/config::devices,查看所有设备名称的列表,然后选择相关设备。 |
| Vsys 名称 | 字符串 | 不适用 | “指定要执行操作的 vsys 的逗号分隔列表。NGFW 的默认 vsys 名称为 vsys1。如果配置不同,请参阅 https://{ip}/php/rest/browse.php/config::devices::entry[@name='{device name{']::vsys,了解设备上所有可用 vsys 的列表。” |
| 政策名称 | 字符串 | 不适用 | 政策名称值。 |
使用场景
不适用
运行时间
此操作会在所有实体上运行。
操作执行结果
实体丰富化
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | “值”选项 | 示例 |
|---|---|---|
| 成功 | True/False | success:False |
JSON 结果
[
"1und1-mail",
"Filter",
"Group1",
"SiemplifyAppBlacklist",
"apple-siri",
"google-analytics"
]
案例墙
| 结果类型 | 值/说明 | 类型 |
|---|---|---|
| 输出消息* | 一个 vsys 成功屏蔽应用 (is_success=true):已成功将以下应用添加到 Palo Alto NGFW 中 vsys“{vsys name}”的政策“{policy name}”:{applications to block} 一个 vsys 屏蔽一个应用不成功 (is_success-=true):操作无法将以下应用添加到 Palo Alto NGFW 中 vsys“{vsys name}”的政策“{policy name}”中:{applications to block} 一个 vsys 无法屏蔽所有应用 (is_success-=true):未将任何应用添加到 Palo Alto NGFW 中 vsys“{vsys name}”的政策“{policy name}”:{applications to block} 一个 vsys 成功取消屏蔽应用 (is_success=true):已成功从 Palo Alto NGFW 中 vsys“{vsys name}”的政策“{policy name}”中移除以下应用:{applications to block} 一个 vsys 无法屏蔽一个应用 (is_success-=true):操作无法从 Palo Alto NGFW 中 vsys“{vsys name}”的政策“{policy name}”中移除以下应用:{applications to block} 一个 vsys 未能成功屏蔽所有应用 (is_success-=true):未从 Palo Alto NGFW 中 vsys“{vsys name}”的政策“{policy name}”中移除任何应用:{applications to block} 如果在某些 vsys 中未找到政策名称 (is_success=true):在 Palo Alto NGFW 的以下 vsys 中未找到政策“{policy name}”:{vsys that don't have the policy} 如果至少有一个 vsys 未找到(失败):执行“Edit Blocked Applications”(修改屏蔽的应用)操作时出错。原因:在 Palo Alto NGFW 中找不到以下 vsys:{vsys that were not found} 如果在所有 vsys 中都找不到政策名称(失败):执行“Edit Blocked Applications”(修改被屏蔽的应用)操作时出错。原因:在提供的 vsys 中找不到政策“{policy name}”。请检查拼写。 如果设备名称无效(失败):执行“修改已屏蔽的应用”操作时出错。原因:未找到设备“{device name}”。请检查拼写。 严重错误:执行“修改屏蔽的应用”操作时出错。原因:{error traceback} |
常规 |
获取遭屏蔽的应用
列出给定政策中所有被屏蔽的应用。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 设备名称 | 字符串 | 不适用 | 该组所在的设备名称。NGFW 的默认设备名称为 localhost.localdomain。如果配置不同,请参阅 https://php/rest/browse.php/config::devices,查看所有设备名称的列表,然后选择相关设备。 |
| Vsys 名称 | 字符串 | 不适用 | “指定要执行操作的 vsys 的逗号分隔列表。NGFW 的默认 vsys 名称为 vsys1。如果配置不同,请参阅 https://{ip}/php/rest/browse.php/config::devices::entry[@name='{device name{']::vsys,了解设备上所有可用 vsys 的列表。” |
| 政策名称 | 字符串 | 不适用 | 政策名称值。 |
使用场景
不适用
运行时间
此操作会在所有实体上运行。
操作执行结果
实体丰富化
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | “值”选项 | 示例 |
|---|---|---|
| blocked_applications | 不适用 | 不适用 |
JSON 结果
[
"1und1-mail",
"Filter",
"Group1",
"SiemplifyAppBlacklist",
"apple-siri",
"google-analytics"
]
案例墙
| 结果类型 | 值/说明 | 类型 |
|---|---|---|
| 输出消息* | 一个 vsys 成功 (is_success=true):已成功列出 Palo Alto NGFW 中以下 vsys 中可用的已屏蔽应用:{vsys with success} 一个 vsys 未成功 (is_success=true):操作无法在 Palo Alto NGFW 的以下 vsys 中列出可用的被屏蔽应用:{vsys with success} 所有 vsys 中的所有 IP 均未成功:在 Palo Alto NGFW 中提供的 vsys 中未找到被屏蔽的应用。 如果在某些 vsys 中未找到政策名称 (is_success=true):在 Palo Alto NGFW 的以下 vsys 中未找到政策“{policy name}”:{没有该政策的 vsys} 如果至少有一个 vsys 未找到(失败):执行操作“获取被屏蔽的应用”时出错。原因:在 Palo Alto NGFW 中找不到以下 vsys:{vsys that were not found} 如果在所有 vsys 中都找不到政策名称(失败):执行“获取被屏蔽的应用”操作时出错。原因:在提供的 vsys 中找不到政策“{policy name}”。请检查拼写。 如果设备名称无效(失败):执行“获取被屏蔽的应用”操作时出错。原因:未找到设备“{device name}”。请检查拼写。 严重错误:执行“获取被屏蔽的应用”操作时出错。原因:{error traceback} |
常规 |
Ping
测试与 Panorama 的连接。
参数
不适用
使用场景
不适用
运行时间
此操作会在所有实体上运行。
操作执行结果
实体丰富化
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | “值”选项 | 示例 |
|---|---|---|
| 成功 | True/False | success:False |
JSON 结果
N/A
从群组中移除 IP
从地址组中移除 IP 地址。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 设备名称 | 字符串 | 不适用 | 该组所在的设备名称。NGFW 的默认设备名称为 localhost.localdomain。如果配置不同,请参阅 https://php/rest/browse.php/config::devices,查看所有设备名称的列表,然后选择相关设备。 |
| Vsys 名称 | 字符串 | 不适用 | “指定要执行操作的 vsys 的逗号分隔列表。NGFW 的默认 vsys 名称为 vsys1。如果配置不同,请参阅 https://{ip}/php/rest/browse.php/config::devices::entry[@name='{device name{']::vsys,了解设备上所有可用 vsys 的列表。” |
| 地址组名称 | 字符串 | 不适用 | 所需地址组的名称。 |
| 使用共享对象 | 复选框 | 不适用 | 如果启用,操作将使用共享对象,而不是 vsys。注意:如果共享地址组不存在,此操作不会创建共享地址组。 |
使用场景
不适用
运行时间
此操作在 IP 地址实体上运行。
操作执行结果
实体丰富化
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | “值”选项 | 示例 |
|---|---|---|
| 成功 | True/False | success:False |
JSON 结果
[
"1.1.1.1",
"2.2.2.2"
]
案例墙
| 结果类型 | 值/说明 | 类型 |
|---|---|---|
| 输出消息* | 一个 vsys 和一个 IP 成功 (is_success=true):已成功从 Palo Alto NGFW 中 vsys“{vsys name}”的群组“{group_name}”中移除以下 IP:{entity.identifiers} 一个 vsys 和一个 IP 未成功 (is_success=true):操作无法从 Palo Alto NGFW 中 vsys“{vsys name}”的群组“{group_name}”中移除以下 IP:{entity.identifiers} 并非 vsys 中的所有 IP 都成功(如果所有 vsys 的行为相同,则 is_success=false;如果部分 vsys 的行为相同,则 is_success=true):未从 Palo Alto NGFW 中 vsys“{vsys name}”的群组“{group_name}”中移除任何 IP。 If Group name wasn't found in some vsys (is_success=true): Group "{group name}" wasn't found in the following vsys in the Palo Alto NGFW: {vsys that don't have the group} 如果至少有一个 vsys 未找到(失败):执行“从群组中移除 IP”操作时出错。原因:在 Palo Alto NGFW 中找不到以下 vsys:{vsys that were not found} 如果“使用共享对象”处于停用状态,并且未提供“设备名称”和“Vsys 名称”(失败):执行操作“{action_name}”时出错:应启用“使用共享对象”参数,或提供“设备名称”和“Vsys 名称”。 If Group name wasn't found in all vsys (fail):执行“Remove Ips from group”操作时出错。原因:在提供的 vsys 中找不到群组“{group name}”。请检查拼写。 如果设备名称无效(失败):执行“从群组中移除 IP”操作时出错。原因:未找到设备“{device name}”。请检查拼写。 如果“使用共享对象”已启用,并且至少移除了一个 IP 地址 (is_success=true):已成功从 Palo Alto NGFW 中的共享地址组“{Group Name}”中移除以下 IP 地址:\n {entity.identifier} 如果“使用共享对象”已启用,并且某个 IP 地址不属于地址组 (is_success=true):以下 IP 地址不属于 Palo Alto NGFW 中的共享地址组“{Group Name}”:\n {entity.identifier} 如果未找到地址组(失败):执行“从组中移除 IP”操作时出错。在 Palo Alto NGFW 中找不到共享地址组“{Group Name}”。 严重错误:执行“从群组中移除 IP”操作时出错。原因:{error traceback} |
常规 |
在政策中取消屏蔽 IP
在政策中解除对 IP 地址的屏蔽(每个 IP 地址都会单独从政策中移除)。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 设备名称 | 字符串 | 不适用 | 该组所在的设备名称。NGFW 的默认设备名称为 localhost.localdomain。如果配置不同,请参阅 https://php/rest/browse.php/config::devices,查看所有设备名称的列表,然后选择相关设备。 |
| Vsys 名称 | 字符串 | 不适用 | “指定要执行操作的 vsys 的逗号分隔列表。NGFW 的默认 vsys 名称为 vsys1。如果配置不同,请参阅 https://{ip}/php/rest/browse.php/config::devices::entry[@name='{device name{']::vsys,了解设备上所有可用 vsys 的列表。” |
| 政策名称 | 字符串 | 不适用 | 政策名称值。 |
| 目标 | 字符串 | 不适用 | 必须是来源或目的地。 |
使用场景
不适用
运行时间
此操作在 IP 地址实体上运行。
操作执行结果
实体丰富化
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | “值”选项 | 示例 |
|---|---|---|
| 成功 | True/False | success:False |
JSON 结果
[
"1.1.1.1",
"2.2.2.2"
]
案例墙
| 结果类型 | 值/说明 | 类型 |
|---|---|---|
| 输出消息* | 一个 vsys 和一个 IP 成功 (is_success=true):已成功在 Palo Alto NGFW 中为 vsys“{vsys name}”在政策“{policy name}”中解除对以下 IP 的屏蔽:{entity.identifiers} 一个 vsys 和一个 IP 未成功 (is_success=true):操作无法在 Palo Alto NGFW 中为 vsys“{vsys name}”在政策“{policy_name}”中解除屏蔽以下 IP:{entity.identifiers} vsys 中的所有 IP 均未成功:Palo Alto NGFW 中 vsys“{vsys name}”的政策“{policy_name}”中没有 IP 被解除屏蔽。 如果在某些 vsys 中未找到政策名称 (is_success=true):在 Palo Alto NGFW 的以下 vsys 中未找到政策“{policy name}”:{vsys that don't have the policy} 如果至少有一个 vsys 未找到(失败):执行“在政策中取消屏蔽 IP”操作时出错。原因:在 Palo Alto NGFW 中找不到以下 vsys:{vsys that were not found} If Policy name wasn't found in all vsys (fail): Error executing action "Unblock Ips in policy". 原因:在提供的 vsys 中找不到政策“{policy name}”。请检查拼写。 如果设备名称无效(失败):执行“在政策中取消屏蔽 IP”操作时出错。原因:未找到设备“{device name}”。请检查拼写。 if Target != source or destination.: 执行“在政策中取消屏蔽 IP”操作时出错。原因:目标应为“source”或“destination”。 严重错误:执行操作“在政策中取消屏蔽 IP”时出错。原因:{error traceback} |
常规 |
取消屏蔽网址
从给定网址类别中移除网址。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 设备名称 | 字符串 | 不适用 | 该组所在的设备名称。NGFW 的默认设备名称为 localhost.localdomain。如果配置不同,请参阅 https://php/rest/browse.php/config::devices,查看所有设备名称的列表,然后选择相关设备。 |
| Vsys 名称 | 字符串 | 不适用 | “指定要执行操作的 vsys 的逗号分隔列表。NGFW 的默认 vsys 名称为 vsys1。如果配置不同,请参阅 https://{ip}/php/rest/browse.php/config::devices::entry[@name='{device name{']::vsys,了解设备上所有可用 vsys 的列表。” |
| 网址类别名称 | 字符串 | 不适用 | 不适用 |
| 使用共享对象 | 复选框 | 不适用 | 如果启用,操作将使用共享对象,而不是 vsys。 |
使用场景
不适用
运行时间
此操作在网址实体上运行。
操作执行结果
实体丰富化
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | “值”选项 | 示例 |
|---|---|---|
| 成功 | True/False | success:False |
JSON 结果
[
"www.example.com"
]
案例墙
| 结果类型 | 值/说明 | 类型 |
|---|---|---|
| 输出消息* | 一个 vsys 和一个网址成功(is_success=true):已成功从 Palo Alto NGFW 中 vsys“{vsys name}”的类别“{category_name}”中移除以下网址:{entity.identifiers} 一个 vsys 和一个网址未成功 (is_success=true):操作未能将以下网址从 Palo Alto NGFW 中 vsys“{vsys name}”的“{category_name}”类别中移除:{entity.identifiers} vsys 中的所有网址均未成功:未从 Palo Alto NGFW 中 vsys“{vsys name}”的类别“{category_name}”中移除任何网址。 If Group name wasn't found in some vsys (is_success=true): Category "{category name}" wasn't found in the following vsys in the Palo Alto NGFW: {vsys that don't have the category} 如果至少有一个 vsys 未找到(失败):执行“Unblock Urls”(解除网址屏蔽)操作时出错。原因:在 Palo Alto NGFW 中找不到以下 vsys:{vsys that were not found} 如果“使用共享对象”处于停用状态,并且未提供“设备名称”和“Vsys 名称”(失败):执行操作“{action_name}”时出错:应启用“使用共享对象”参数,或提供“设备名称”和“Vsys 名称”。 如果在所有 vsys 中都找不到类别名称(失败):执行“Unblock Urls”(取消屏蔽网址)操作时出错。原因:在提供的 vsys 中找不到类别“{category name}”。请检查拼写。 如果设备名称无效(失败):执行“取消屏蔽网址”操作时出错。原因:未找到设备“{device name}”。请检查拼写。 如果“使用共享对象”已启用,并且至少添加了一个网址 (is_success=true):已成功从 Palo Alto NGFW 中的共享类别“{Category Name}”中移除以下网址:\n {entity.identifier} 如果“使用共享对象”已启用,并且某个网址已属于网址类别 (is_success=true): 以下网址不属于 Palo Alto NGFW 中的共享类别“{Category Name}”:\n {entity.identifier} 如果未找到类别(失败):执行“屏蔽网址”操作时出错。在 Palo Alto NGFW 中找不到共享类别“{Category Name}”。 严重错误:执行“取消屏蔽网址”操作时出错。原因:{error traceback} |
常规 |
需要更多帮助?获得社区成员和 Google SecOps 专业人士的解答。