將 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 專業人員尋求解答。