將 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)
乒乓 基準 API 存取權 (keygen)

整合參數

Palo Alto Next Gen Firewall 整合功能需要下列參數:

參數顯示名稱 類型 預設值 為必填 說明
API 根 字串 https://x.x.x.x/api 是 Palo Alto Networks Next-Generation Firewall 執行個體的 API 根目錄。
使用者名稱 字串 不適用 是 Palo Alto Networks Next-Generation Firewall 帳戶的使用者名稱。
密碼 密碼 不適用 是 Palo Alto Networks Next-Generation Firewall 帳戶的密碼。
驗證 SSL 核取方塊 已取消勾選 否 如果啟用,則會驗證連至 Palo Alto Networks Next-Generation Firewall 伺服器的 SSL 憑證是否有效。

如要瞭解如何在 Google SecOps 中設定整合功能,請參閱「設定整合功能」。

如有需要,您可以在後續階段進行變更。設定整合執行個體後,即可在應對手冊中使用。如要進一步瞭解如何設定及支援多個執行個體,請參閱「支援多個執行個體」。

動作

如要進一步瞭解動作,請參閱「 在工作區回應待處理動作」和「在案件中執行手動動作」。

將 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 均未成功 (is_success=false,如果所有 vsys 的行為相同,且部分成功,則 is_success=true):Palo Alto NGFW 中 vsys「{vsys name}」的群組「{group_name}」未新增任何 IP。

如果至少有一個 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):未將任何 IP 位址新增至 Palo Alto NGFW 的共用位址群組「{Group Name}」。

如果找不到位址群組 (失敗):執行「將 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}

Not success for all IPs in vsys (is_success=false, if the same behavior for all vsys and is_success=true if partial): No IPs were blocked in policy "{policy_name}" for vsys "{vsys name}" in Palo Alto NGFW.

如果在某些 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」動作時發生錯誤。原因:目標應為「來源」或「目的地」

重大錯誤:執行「封鎖政策中的 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}

Not success for all URLs in vsys: 沒有任何網址新增至 Palo Alto NGFW 中 vsys「{vsys name}」的「{category_name}」類別。

如果在部分 vsys 中找不到群組名稱 (is_success=true):在 Palo Alto NGFW 的下列 vsys 中找不到「{category name}」類別:{沒有該類別的 vsys}

如果「使用共用物件」已停用,且未提供「裝置名稱」和「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}

Not success for one vsys for blocking of all applications (is_success-=true): No applications were added to the policy "{policy name}" in vsys "{vsys name}" in Palo Alto NGFW: {applications to block}

成功解除封鎖一個 vsys 的應用程式 (is_success=true):已成功從 Palo Alto NGFW 中 vsys「{vsys name}」的政策「{policy name}」移除下列應用程式:{applications to block}

Not success for one vsys for blocking of one application (is_success-=true):動作無法從 Palo Alto NGFW 中 vsys「{vsys name}」的政策「{policy name}」移除下列應用程式:{applications to block}

Not success for one vsys for blocking of all applications (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 找不到 (失敗):執行「編輯封鎖的應用程式」動作時發生錯誤。原因:在 Palo Alto NGFW 找不到下列 vsys:{vsys that were not found}

如果在所有 vsys 中找不到政策名稱 (失敗):執行「編輯封鎖的應用程式」動作時發生錯誤。原因:在提供的 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 that don't have the policy}

如果至少有一個 vsys 找不到 (失敗):執行「Get Blocked Applications」動作時發生錯誤。原因:在 Palo Alto NGFW 找不到下列 vsys:{vsys that were not found}

如果所有 vsys 中都找不到政策名稱 (失敗):執行「Get Blocked Applications」動作時發生錯誤。原因:在提供的 vsys 中找不到「{policy name}」政策。請檢查拼字。

如果裝置名稱無效 (失敗):執行「取得封鎖的應用程式」動作時發生錯誤。原因:找不到裝置「{device name}」。請檢查拼字。

重大錯誤:執行「取得封鎖的應用程式」動作時發生錯誤。原因:{error traceback}

一般

乒乓

測試與 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}

Not success for all IPs in vsys (is_success=false, if the same behavior for all vsys and is_success=true if partial): Palo Alto NGFW 中,沒有任何 IP 從 vsys「{vsys name}」的群組「{group_name}」中移除。

如果在部分 vsys 中找不到群組名稱 (is_success=true):在 Palo Alto NGFW 的下列 vsys 中找不到群組「{group name}」:{沒有群組的 vsys}

如果至少有一個 vsys 找不到 (失敗):執行「從群組中移除 IP」動作時發生錯誤。原因:在 Palo Alto NGFW 找不到下列 vsys:{vsys that were not found}

如果「使用共用物件」已停用,且未提供「裝置名稱」和「Vsys 名稱」(失敗):執行「{action_name}」動作時發生錯誤:應啟用「使用共用物件」參數,或提供「裝置名稱」和「Vsys 名稱」。

如果在所有 vsys 中找不到群組名稱 (失敗):執行「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}

如果在所有 vsys 中找不到政策名稱 (失敗):執行「Unblock Ips in policy」動作時發生錯誤。原因:在提供的 vsys 中找不到「{policy name}」政策。請檢查拼字。

如果裝置名稱無效 (失敗):執行「解除封鎖政策中的 IP」動作時發生錯誤。原因:找不到裝置「{device name}」。請檢查拼字。

if Target != source or destination.: 執行「解除封鎖政策中的 IP」動作時發生錯誤。原因:目標應為「來源」或「目的地」。

重大錯誤:執行「解除封鎖政策中的 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}」類別移除任何網址。

如果在部分 vsys 中找不到群組名稱 (is_success=true):在 Palo Alto NGFW 的下列 vsys 中找不到「{category name}」類別:{vsys that don't have the category}

如果至少有一個 vsys 找不到 (失敗):執行「解除封鎖網址」動作時發生錯誤。原因:在 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 專業人員尋求解答。