将 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 专业人士的解答。