feat(panos): new PAN-OS / Panorama firewall-containment integration
PAN-OS XML API, 10 commands: register/unregister IP tag (Dynamic Address Group fast-block, no commit), address create/delete, custom URL category create/edit, EDL list/refresh, commit. API-key auth, targets a vsys, stdlib-only. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Guillaume BOURGEOIS
@@ -0,0 +1,125 @@
|
||||
id: panos
|
||||
name: PAN-OS / Panorama
|
||||
version: 1.0.0
|
||||
description: "Palo Alto Networks PAN-OS / Panorama (XML API) — firewall containment: register/unregister IP tags for Dynamic Address Groups (fast block, no commit), create/delete address objects, create/edit custom URL categories, list and refresh External Dynamic Lists, and commit. API-key authentication; stdlib-only, no extra Python dependencies. Targets a firewall vsys."
|
||||
changelog: "1.0.0 — Initial release: register/unregister IP tag, address create/delete, custom URL category create/edit, EDL list/refresh, commit."
|
||||
category: network
|
||||
|
||||
# Per-instance configuration. The API key is sent as the 'key' query parameter.
|
||||
# vsys is the firewall virtual system (default vsys1).
|
||||
config_schema:
|
||||
properties:
|
||||
server:
|
||||
type: string
|
||||
description: "PAN-OS / Panorama URL (e.g. https://192.168.0.1)"
|
||||
api_key:
|
||||
type: string
|
||||
description: "PAN-OS API key"
|
||||
x-soar-sensitive: true
|
||||
port:
|
||||
type: number
|
||||
description: "HTTPS port (default 443)"
|
||||
default: 443
|
||||
vsys:
|
||||
type: string
|
||||
description: "Virtual system (default vsys1)"
|
||||
default: "vsys1"
|
||||
insecure:
|
||||
type: boolean
|
||||
description: "Trust any TLS certificate (not secure)"
|
||||
default: false
|
||||
required:
|
||||
- server
|
||||
- api_key
|
||||
|
||||
commands:
|
||||
- id: register_ip_tag
|
||||
name: panos-register-ip-tag
|
||||
description: "Register (tag) an IP address so a Dynamic Address Group matching the tag blocks it immediately — no commit required."
|
||||
inputs_schema:
|
||||
properties:
|
||||
ip: { type: string, description: "IP address to tag" }
|
||||
tags: { type: string, description: "Comma-separated tags to attach" }
|
||||
timeout: { type: number, description: "Tag timeout in seconds (0 or empty = no timeout)" }
|
||||
required: [ip, tags]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: unregister_ip_tag
|
||||
name: panos-unregister-ip-tag
|
||||
description: "Remove tags from an IP address (releases it from tag-based Dynamic Address Groups)."
|
||||
inputs_schema:
|
||||
properties:
|
||||
ip: { type: string, description: "IP address to untag" }
|
||||
tags: { type: string, description: "Comma-separated tags to remove" }
|
||||
required: [ip, tags]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: create_address
|
||||
name: panos-create-address
|
||||
description: "Create an address object (ip-netmask, ip-range, or fqdn)."
|
||||
inputs_schema:
|
||||
properties:
|
||||
name: { type: string, description: "Address object name" }
|
||||
value: { type: string, description: "Address value (e.g. 10.0.0.5/32, 10.0.0.1-10.0.0.9, or bad.example.com)" }
|
||||
type: { type: string, description: "Address type: ip-netmask (default), ip-range, or fqdn" }
|
||||
description: { type: string, description: "Optional description" }
|
||||
required: [name, value]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: delete_address
|
||||
name: panos-delete-address
|
||||
description: "Delete an address object by name."
|
||||
inputs_schema:
|
||||
properties:
|
||||
name: { type: string, description: "Address object name" }
|
||||
required: [name]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: create_custom_url_category
|
||||
name: panos-create-custom-url-category
|
||||
description: "Create a custom URL category populated with the given URLs (used by a URL-filtering deny rule)."
|
||||
inputs_schema:
|
||||
properties:
|
||||
name: { type: string, description: "Custom URL category name" }
|
||||
urls: { type: string, description: "Comma-separated URLs/domains to include" }
|
||||
description: { type: string, description: "Optional description" }
|
||||
required: [name, urls]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: edit_custom_url_category
|
||||
name: panos-edit-custom-url-category
|
||||
description: "Replace the URL list of an existing custom URL category."
|
||||
inputs_schema:
|
||||
properties:
|
||||
name: { type: string, description: "Custom URL category name" }
|
||||
urls: { type: string, description: "Comma-separated URLs/domains that become the category's full list" }
|
||||
required: [name, urls]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: list_edl
|
||||
name: panos-list-edl
|
||||
description: "List External Dynamic Lists configured on the device."
|
||||
risk: read
|
||||
inputs_schema:
|
||||
properties: {}
|
||||
required: []
|
||||
outputs_schema: { properties: {} }
|
||||
- id: refresh_edl
|
||||
name: panos-refresh-edl
|
||||
description: "Force an immediate refresh of an External Dynamic List."
|
||||
inputs_schema:
|
||||
properties:
|
||||
name: { type: string, description: "External Dynamic List name" }
|
||||
required: [name]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: commit
|
||||
name: panos-commit
|
||||
description: "Commit the candidate configuration."
|
||||
inputs_schema:
|
||||
properties:
|
||||
description: { type: string, description: "Optional commit description" }
|
||||
required: []
|
||||
outputs_schema: { properties: {} }
|
||||
|
||||
- id: test_connection
|
||||
name: panos-test-connection
|
||||
description: "Verify connectivity and the API key (used by the Test button)."
|
||||
risk: read
|
||||
inputs_schema:
|
||||
properties: {}
|
||||
required: []
|
||||
outputs_schema: { properties: {} }
|
||||
@@ -0,0 +1,100 @@
|
||||
import json, os, sys, urllib.parse, urllib.request, urllib.error, ssl
|
||||
import xml.etree.ElementTree as ET
|
||||
from xml.sax.saxutils import escape
|
||||
|
||||
|
||||
def _cfg():
|
||||
return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
|
||||
|
||||
|
||||
def _inputs():
|
||||
return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
|
||||
|
||||
|
||||
def _ctx(cfg):
|
||||
if cfg.get("insecure"):
|
||||
c = ssl.create_default_context()
|
||||
c.check_hostname = False
|
||||
c.verify_mode = ssl.CERT_NONE
|
||||
return c
|
||||
return None
|
||||
|
||||
|
||||
def _base(cfg):
|
||||
server = str(cfg.get("server", "")).rstrip("/")
|
||||
port = cfg.get("port") or 443
|
||||
return server + ":" + str(port) + "/api/"
|
||||
|
||||
|
||||
def _vsys(cfg):
|
||||
return cfg.get("vsys") or "vsys1"
|
||||
|
||||
|
||||
def _xpath_addr_prefix(cfg):
|
||||
return ("/config/devices/entry[@name='localhost.localdomain']/vsys/entry[@name='"
|
||||
+ _vsys(cfg) + "']")
|
||||
|
||||
|
||||
def api(cfg, params):
|
||||
p = dict(params)
|
||||
p["key"] = str(cfg.get("api_key", ""))
|
||||
url = _base(cfg) + "?" + urllib.parse.urlencode(p)
|
||||
req = urllib.request.Request(url, method="GET")
|
||||
with urllib.request.urlopen(req, timeout=90, context=_ctx(cfg)) as r:
|
||||
raw = r.read()
|
||||
text = raw.decode("utf-8", "replace")
|
||||
try:
|
||||
root = ET.fromstring(raw)
|
||||
except Exception:
|
||||
raise Exception("Invalid XML response: " + text[:500])
|
||||
if root.attrib.get("status") != "success":
|
||||
raise Exception("PAN-OS error: " + text[:800])
|
||||
return root, text
|
||||
|
||||
|
||||
def _to_dict(elem):
|
||||
# Shallow XML→dict for returning results
|
||||
d = dict(elem.attrib)
|
||||
children = list(elem)
|
||||
if not children:
|
||||
if elem.text and elem.text.strip():
|
||||
d["_text"] = elem.text.strip()
|
||||
return d
|
||||
for c in children:
|
||||
cd = _to_dict(c)
|
||||
if c.tag in d:
|
||||
if not isinstance(d[c.tag], list):
|
||||
d[c.tag] = [d[c.tag]]
|
||||
d[c.tag].append(cd)
|
||||
else:
|
||||
d[c.tag] = cd
|
||||
return d
|
||||
|
||||
|
||||
def _run(fn):
|
||||
try:
|
||||
print(json.dumps(fn(_cfg(), _inputs())))
|
||||
except urllib.error.HTTPError as e:
|
||||
print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
|
||||
sys.exit(1)
|
||||
except Exception as e:
|
||||
print(json.dumps({"error": str(e)}))
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
def main(cfg, inputs):
|
||||
description = str(inputs.get("description") or "").strip()
|
||||
|
||||
cmd = "<commit>"
|
||||
if description:
|
||||
cmd += "<description>" + escape(description) + "</description>"
|
||||
cmd += "</commit>"
|
||||
|
||||
root, text = api(cfg, {"type": "commit", "cmd": cmd})
|
||||
|
||||
job = root.findtext(".//job")
|
||||
|
||||
return {"ok": True, "job": job}
|
||||
|
||||
|
||||
_run(main)
|
||||
@@ -0,0 +1,111 @@
|
||||
import json, os, sys, urllib.parse, urllib.request, urllib.error, ssl
|
||||
import xml.etree.ElementTree as ET
|
||||
from xml.sax.saxutils import escape
|
||||
|
||||
|
||||
def _cfg():
|
||||
return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
|
||||
|
||||
|
||||
def _inputs():
|
||||
return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
|
||||
|
||||
|
||||
def _ctx(cfg):
|
||||
if cfg.get("insecure"):
|
||||
c = ssl.create_default_context()
|
||||
c.check_hostname = False
|
||||
c.verify_mode = ssl.CERT_NONE
|
||||
return c
|
||||
return None
|
||||
|
||||
|
||||
def _base(cfg):
|
||||
server = str(cfg.get("server", "")).rstrip("/")
|
||||
port = cfg.get("port") or 443
|
||||
return server + ":" + str(port) + "/api/"
|
||||
|
||||
|
||||
def _vsys(cfg):
|
||||
return cfg.get("vsys") or "vsys1"
|
||||
|
||||
|
||||
def _xpath_addr_prefix(cfg):
|
||||
return ("/config/devices/entry[@name='localhost.localdomain']/vsys/entry[@name='"
|
||||
+ _vsys(cfg) + "']")
|
||||
|
||||
|
||||
def api(cfg, params):
|
||||
p = dict(params)
|
||||
p["key"] = str(cfg.get("api_key", ""))
|
||||
url = _base(cfg) + "?" + urllib.parse.urlencode(p)
|
||||
req = urllib.request.Request(url, method="GET")
|
||||
with urllib.request.urlopen(req, timeout=90, context=_ctx(cfg)) as r:
|
||||
raw = r.read()
|
||||
text = raw.decode("utf-8", "replace")
|
||||
try:
|
||||
root = ET.fromstring(raw)
|
||||
except Exception:
|
||||
raise Exception("Invalid XML response: " + text[:500])
|
||||
if root.attrib.get("status") != "success":
|
||||
raise Exception("PAN-OS error: " + text[:800])
|
||||
return root, text
|
||||
|
||||
|
||||
def _to_dict(elem):
|
||||
# Shallow XML→dict for returning results
|
||||
d = dict(elem.attrib)
|
||||
children = list(elem)
|
||||
if not children:
|
||||
if elem.text and elem.text.strip():
|
||||
d["_text"] = elem.text.strip()
|
||||
return d
|
||||
for c in children:
|
||||
cd = _to_dict(c)
|
||||
if c.tag in d:
|
||||
if not isinstance(d[c.tag], list):
|
||||
d[c.tag] = [d[c.tag]]
|
||||
d[c.tag].append(cd)
|
||||
else:
|
||||
d[c.tag] = cd
|
||||
return d
|
||||
|
||||
|
||||
def _run(fn):
|
||||
try:
|
||||
print(json.dumps(fn(_cfg(), _inputs())))
|
||||
except urllib.error.HTTPError as e:
|
||||
print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
|
||||
sys.exit(1)
|
||||
except Exception as e:
|
||||
print(json.dumps({"error": str(e)}))
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
def main(cfg, inputs):
|
||||
name = str(inputs.get("name") or "").strip()
|
||||
if not name:
|
||||
raise Exception("name is required")
|
||||
|
||||
value = str(inputs.get("value") or "").strip()
|
||||
if not value:
|
||||
raise Exception("value is required")
|
||||
|
||||
addr_type = str(inputs.get("type") or "ip-netmask").strip() or "ip-netmask"
|
||||
if addr_type not in ("ip-netmask", "ip-range", "fqdn"):
|
||||
raise Exception("type must be one of ip-netmask, ip-range, fqdn")
|
||||
|
||||
description = str(inputs.get("description") or "").strip()
|
||||
|
||||
element = "<" + addr_type + ">" + escape(value) + "</" + addr_type + ">"
|
||||
if description:
|
||||
element += "<description>" + escape(description) + "</description>"
|
||||
|
||||
xpath = _xpath_addr_prefix(cfg) + "/address/entry[@name='" + name + "']"
|
||||
|
||||
api(cfg, {"type": "config", "action": "set", "xpath": xpath, "element": element})
|
||||
|
||||
return {"ok": True, "name": name}
|
||||
|
||||
|
||||
_run(main)
|
||||
@@ -0,0 +1,110 @@
|
||||
import json, os, sys, urllib.parse, urllib.request, urllib.error, ssl
|
||||
import xml.etree.ElementTree as ET
|
||||
from xml.sax.saxutils import escape
|
||||
|
||||
|
||||
def _cfg():
|
||||
return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
|
||||
|
||||
|
||||
def _inputs():
|
||||
return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
|
||||
|
||||
|
||||
def _ctx(cfg):
|
||||
if cfg.get("insecure"):
|
||||
c = ssl.create_default_context()
|
||||
c.check_hostname = False
|
||||
c.verify_mode = ssl.CERT_NONE
|
||||
return c
|
||||
return None
|
||||
|
||||
|
||||
def _base(cfg):
|
||||
server = str(cfg.get("server", "")).rstrip("/")
|
||||
port = cfg.get("port") or 443
|
||||
return server + ":" + str(port) + "/api/"
|
||||
|
||||
|
||||
def _vsys(cfg):
|
||||
return cfg.get("vsys") or "vsys1"
|
||||
|
||||
|
||||
def _xpath_addr_prefix(cfg):
|
||||
return ("/config/devices/entry[@name='localhost.localdomain']/vsys/entry[@name='"
|
||||
+ _vsys(cfg) + "']")
|
||||
|
||||
|
||||
def api(cfg, params):
|
||||
p = dict(params)
|
||||
p["key"] = str(cfg.get("api_key", ""))
|
||||
url = _base(cfg) + "?" + urllib.parse.urlencode(p)
|
||||
req = urllib.request.Request(url, method="GET")
|
||||
with urllib.request.urlopen(req, timeout=90, context=_ctx(cfg)) as r:
|
||||
raw = r.read()
|
||||
text = raw.decode("utf-8", "replace")
|
||||
try:
|
||||
root = ET.fromstring(raw)
|
||||
except Exception:
|
||||
raise Exception("Invalid XML response: " + text[:500])
|
||||
if root.attrib.get("status") != "success":
|
||||
raise Exception("PAN-OS error: " + text[:800])
|
||||
return root, text
|
||||
|
||||
|
||||
def _to_dict(elem):
|
||||
# Shallow XML→dict for returning results
|
||||
d = dict(elem.attrib)
|
||||
children = list(elem)
|
||||
if not children:
|
||||
if elem.text and elem.text.strip():
|
||||
d["_text"] = elem.text.strip()
|
||||
return d
|
||||
for c in children:
|
||||
cd = _to_dict(c)
|
||||
if c.tag in d:
|
||||
if not isinstance(d[c.tag], list):
|
||||
d[c.tag] = [d[c.tag]]
|
||||
d[c.tag].append(cd)
|
||||
else:
|
||||
d[c.tag] = cd
|
||||
return d
|
||||
|
||||
|
||||
def _run(fn):
|
||||
try:
|
||||
print(json.dumps(fn(_cfg(), _inputs())))
|
||||
except urllib.error.HTTPError as e:
|
||||
print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
|
||||
sys.exit(1)
|
||||
except Exception as e:
|
||||
print(json.dumps({"error": str(e)}))
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
def main(cfg, inputs):
|
||||
name = str(inputs.get("name") or "").strip()
|
||||
if not name:
|
||||
raise Exception("name is required")
|
||||
|
||||
urls = [s.strip() for s in str(inputs.get("urls") or "").split(",") if s.strip()]
|
||||
if not urls:
|
||||
raise Exception("urls is required")
|
||||
|
||||
description = str(inputs.get("description") or "").strip()
|
||||
|
||||
members = "".join("<member>" + escape(u) + "</member>" for u in urls)
|
||||
element = "<list>" + members + "</list><type>URL List</type>"
|
||||
if description:
|
||||
element += "<description>" + escape(description) + "</description>"
|
||||
|
||||
xpath = (
|
||||
_xpath_addr_prefix(cfg) + "/profiles/custom-url-category/entry[@name='" + name + "']"
|
||||
)
|
||||
|
||||
api(cfg, {"type": "config", "action": "set", "xpath": xpath, "element": element})
|
||||
|
||||
return {"ok": True, "name": name}
|
||||
|
||||
|
||||
_run(main)
|
||||
@@ -0,0 +1,96 @@
|
||||
import json, os, sys, urllib.parse, urllib.request, urllib.error, ssl
|
||||
import xml.etree.ElementTree as ET
|
||||
|
||||
|
||||
def _cfg():
|
||||
return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
|
||||
|
||||
|
||||
def _inputs():
|
||||
return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
|
||||
|
||||
|
||||
def _ctx(cfg):
|
||||
if cfg.get("insecure"):
|
||||
c = ssl.create_default_context()
|
||||
c.check_hostname = False
|
||||
c.verify_mode = ssl.CERT_NONE
|
||||
return c
|
||||
return None
|
||||
|
||||
|
||||
def _base(cfg):
|
||||
server = str(cfg.get("server", "")).rstrip("/")
|
||||
port = cfg.get("port") or 443
|
||||
return server + ":" + str(port) + "/api/"
|
||||
|
||||
|
||||
def _vsys(cfg):
|
||||
return cfg.get("vsys") or "vsys1"
|
||||
|
||||
|
||||
def _xpath_addr_prefix(cfg):
|
||||
return ("/config/devices/entry[@name='localhost.localdomain']/vsys/entry[@name='"
|
||||
+ _vsys(cfg) + "']")
|
||||
|
||||
|
||||
def api(cfg, params):
|
||||
p = dict(params)
|
||||
p["key"] = str(cfg.get("api_key", ""))
|
||||
url = _base(cfg) + "?" + urllib.parse.urlencode(p)
|
||||
req = urllib.request.Request(url, method="GET")
|
||||
with urllib.request.urlopen(req, timeout=90, context=_ctx(cfg)) as r:
|
||||
raw = r.read()
|
||||
text = raw.decode("utf-8", "replace")
|
||||
try:
|
||||
root = ET.fromstring(raw)
|
||||
except Exception:
|
||||
raise Exception("Invalid XML response: " + text[:500])
|
||||
if root.attrib.get("status") != "success":
|
||||
raise Exception("PAN-OS error: " + text[:800])
|
||||
return root, text
|
||||
|
||||
|
||||
def _to_dict(elem):
|
||||
# Shallow XML→dict for returning results
|
||||
d = dict(elem.attrib)
|
||||
children = list(elem)
|
||||
if not children:
|
||||
if elem.text and elem.text.strip():
|
||||
d["_text"] = elem.text.strip()
|
||||
return d
|
||||
for c in children:
|
||||
cd = _to_dict(c)
|
||||
if c.tag in d:
|
||||
if not isinstance(d[c.tag], list):
|
||||
d[c.tag] = [d[c.tag]]
|
||||
d[c.tag].append(cd)
|
||||
else:
|
||||
d[c.tag] = cd
|
||||
return d
|
||||
|
||||
|
||||
def _run(fn):
|
||||
try:
|
||||
print(json.dumps(fn(_cfg(), _inputs())))
|
||||
except urllib.error.HTTPError as e:
|
||||
print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
|
||||
sys.exit(1)
|
||||
except Exception as e:
|
||||
print(json.dumps({"error": str(e)}))
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
def main(cfg, inputs):
|
||||
name = str(inputs.get("name") or "").strip()
|
||||
if not name:
|
||||
raise Exception("name is required")
|
||||
|
||||
xpath = _xpath_addr_prefix(cfg) + "/address/entry[@name='" + name + "']"
|
||||
|
||||
api(cfg, {"type": "config", "action": "delete", "xpath": xpath})
|
||||
|
||||
return {"ok": True, "name": name}
|
||||
|
||||
|
||||
_run(main)
|
||||
@@ -0,0 +1,107 @@
|
||||
import json, os, sys, urllib.parse, urllib.request, urllib.error, ssl
|
||||
import xml.etree.ElementTree as ET
|
||||
from xml.sax.saxutils import escape
|
||||
|
||||
|
||||
def _cfg():
|
||||
return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
|
||||
|
||||
|
||||
def _inputs():
|
||||
return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
|
||||
|
||||
|
||||
def _ctx(cfg):
|
||||
if cfg.get("insecure"):
|
||||
c = ssl.create_default_context()
|
||||
c.check_hostname = False
|
||||
c.verify_mode = ssl.CERT_NONE
|
||||
return c
|
||||
return None
|
||||
|
||||
|
||||
def _base(cfg):
|
||||
server = str(cfg.get("server", "")).rstrip("/")
|
||||
port = cfg.get("port") or 443
|
||||
return server + ":" + str(port) + "/api/"
|
||||
|
||||
|
||||
def _vsys(cfg):
|
||||
return cfg.get("vsys") or "vsys1"
|
||||
|
||||
|
||||
def _xpath_addr_prefix(cfg):
|
||||
return ("/config/devices/entry[@name='localhost.localdomain']/vsys/entry[@name='"
|
||||
+ _vsys(cfg) + "']")
|
||||
|
||||
|
||||
def api(cfg, params):
|
||||
p = dict(params)
|
||||
p["key"] = str(cfg.get("api_key", ""))
|
||||
url = _base(cfg) + "?" + urllib.parse.urlencode(p)
|
||||
req = urllib.request.Request(url, method="GET")
|
||||
with urllib.request.urlopen(req, timeout=90, context=_ctx(cfg)) as r:
|
||||
raw = r.read()
|
||||
text = raw.decode("utf-8", "replace")
|
||||
try:
|
||||
root = ET.fromstring(raw)
|
||||
except Exception:
|
||||
raise Exception("Invalid XML response: " + text[:500])
|
||||
if root.attrib.get("status") != "success":
|
||||
raise Exception("PAN-OS error: " + text[:800])
|
||||
return root, text
|
||||
|
||||
|
||||
def _to_dict(elem):
|
||||
# Shallow XML→dict for returning results
|
||||
d = dict(elem.attrib)
|
||||
children = list(elem)
|
||||
if not children:
|
||||
if elem.text and elem.text.strip():
|
||||
d["_text"] = elem.text.strip()
|
||||
return d
|
||||
for c in children:
|
||||
cd = _to_dict(c)
|
||||
if c.tag in d:
|
||||
if not isinstance(d[c.tag], list):
|
||||
d[c.tag] = [d[c.tag]]
|
||||
d[c.tag].append(cd)
|
||||
else:
|
||||
d[c.tag] = cd
|
||||
return d
|
||||
|
||||
|
||||
def _run(fn):
|
||||
try:
|
||||
print(json.dumps(fn(_cfg(), _inputs())))
|
||||
except urllib.error.HTTPError as e:
|
||||
print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
|
||||
sys.exit(1)
|
||||
except Exception as e:
|
||||
print(json.dumps({"error": str(e)}))
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
def main(cfg, inputs):
|
||||
name = str(inputs.get("name") or "").strip()
|
||||
if not name:
|
||||
raise Exception("name is required")
|
||||
|
||||
urls = [s.strip() for s in str(inputs.get("urls") or "").split(",") if s.strip()]
|
||||
if not urls:
|
||||
raise Exception("urls is required")
|
||||
|
||||
members = "".join("<member>" + escape(u) + "</member>" for u in urls)
|
||||
element = "<list>" + members + "</list>"
|
||||
|
||||
xpath = (
|
||||
_xpath_addr_prefix(cfg)
|
||||
+ "/profiles/custom-url-category/entry[@name='" + name + "']/list"
|
||||
)
|
||||
|
||||
api(cfg, {"type": "config", "action": "edit", "xpath": xpath, "element": element})
|
||||
|
||||
return {"ok": True, "name": name}
|
||||
|
||||
|
||||
_run(main)
|
||||
@@ -0,0 +1,96 @@
|
||||
import json, os, sys, urllib.parse, urllib.request, urllib.error, ssl
|
||||
import xml.etree.ElementTree as ET
|
||||
|
||||
|
||||
def _cfg():
|
||||
return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
|
||||
|
||||
|
||||
def _inputs():
|
||||
return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
|
||||
|
||||
|
||||
def _ctx(cfg):
|
||||
if cfg.get("insecure"):
|
||||
c = ssl.create_default_context()
|
||||
c.check_hostname = False
|
||||
c.verify_mode = ssl.CERT_NONE
|
||||
return c
|
||||
return None
|
||||
|
||||
|
||||
def _base(cfg):
|
||||
server = str(cfg.get("server", "")).rstrip("/")
|
||||
port = cfg.get("port") or 443
|
||||
return server + ":" + str(port) + "/api/"
|
||||
|
||||
|
||||
def _vsys(cfg):
|
||||
return cfg.get("vsys") or "vsys1"
|
||||
|
||||
|
||||
def _xpath_addr_prefix(cfg):
|
||||
return ("/config/devices/entry[@name='localhost.localdomain']/vsys/entry[@name='"
|
||||
+ _vsys(cfg) + "']")
|
||||
|
||||
|
||||
def api(cfg, params):
|
||||
p = dict(params)
|
||||
p["key"] = str(cfg.get("api_key", ""))
|
||||
url = _base(cfg) + "?" + urllib.parse.urlencode(p)
|
||||
req = urllib.request.Request(url, method="GET")
|
||||
with urllib.request.urlopen(req, timeout=90, context=_ctx(cfg)) as r:
|
||||
raw = r.read()
|
||||
text = raw.decode("utf-8", "replace")
|
||||
try:
|
||||
root = ET.fromstring(raw)
|
||||
except Exception:
|
||||
raise Exception("Invalid XML response: " + text[:500])
|
||||
if root.attrib.get("status") != "success":
|
||||
raise Exception("PAN-OS error: " + text[:800])
|
||||
return root, text
|
||||
|
||||
|
||||
def _to_dict(elem):
|
||||
# Shallow XML→dict for returning results
|
||||
d = dict(elem.attrib)
|
||||
children = list(elem)
|
||||
if not children:
|
||||
if elem.text and elem.text.strip():
|
||||
d["_text"] = elem.text.strip()
|
||||
return d
|
||||
for c in children:
|
||||
cd = _to_dict(c)
|
||||
if c.tag in d:
|
||||
if not isinstance(d[c.tag], list):
|
||||
d[c.tag] = [d[c.tag]]
|
||||
d[c.tag].append(cd)
|
||||
else:
|
||||
d[c.tag] = cd
|
||||
return d
|
||||
|
||||
|
||||
def _run(fn):
|
||||
try:
|
||||
print(json.dumps(fn(_cfg(), _inputs())))
|
||||
except urllib.error.HTTPError as e:
|
||||
print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
|
||||
sys.exit(1)
|
||||
except Exception as e:
|
||||
print(json.dumps({"error": str(e)}))
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
def main(cfg, inputs):
|
||||
xpath = _xpath_addr_prefix(cfg) + "/external-list"
|
||||
|
||||
root, text = api(cfg, {"type": "config", "action": "get", "xpath": xpath})
|
||||
|
||||
result_elem = root.find("result")
|
||||
if result_elem is None:
|
||||
return {"result": {}}
|
||||
|
||||
return {"result": _to_dict(result_elem)}
|
||||
|
||||
|
||||
_run(main)
|
||||
@@ -0,0 +1,101 @@
|
||||
import json, os, sys, urllib.parse, urllib.request, urllib.error, ssl
|
||||
import xml.etree.ElementTree as ET
|
||||
from xml.sax.saxutils import escape
|
||||
|
||||
|
||||
def _cfg():
|
||||
return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
|
||||
|
||||
|
||||
def _inputs():
|
||||
return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
|
||||
|
||||
|
||||
def _ctx(cfg):
|
||||
if cfg.get("insecure"):
|
||||
c = ssl.create_default_context()
|
||||
c.check_hostname = False
|
||||
c.verify_mode = ssl.CERT_NONE
|
||||
return c
|
||||
return None
|
||||
|
||||
|
||||
def _base(cfg):
|
||||
server = str(cfg.get("server", "")).rstrip("/")
|
||||
port = cfg.get("port") or 443
|
||||
return server + ":" + str(port) + "/api/"
|
||||
|
||||
|
||||
def _vsys(cfg):
|
||||
return cfg.get("vsys") or "vsys1"
|
||||
|
||||
|
||||
def _xpath_addr_prefix(cfg):
|
||||
return ("/config/devices/entry[@name='localhost.localdomain']/vsys/entry[@name='"
|
||||
+ _vsys(cfg) + "']")
|
||||
|
||||
|
||||
def api(cfg, params):
|
||||
p = dict(params)
|
||||
p["key"] = str(cfg.get("api_key", ""))
|
||||
url = _base(cfg) + "?" + urllib.parse.urlencode(p)
|
||||
req = urllib.request.Request(url, method="GET")
|
||||
with urllib.request.urlopen(req, timeout=90, context=_ctx(cfg)) as r:
|
||||
raw = r.read()
|
||||
text = raw.decode("utf-8", "replace")
|
||||
try:
|
||||
root = ET.fromstring(raw)
|
||||
except Exception:
|
||||
raise Exception("Invalid XML response: " + text[:500])
|
||||
if root.attrib.get("status") != "success":
|
||||
raise Exception("PAN-OS error: " + text[:800])
|
||||
return root, text
|
||||
|
||||
|
||||
def _to_dict(elem):
|
||||
# Shallow XML→dict for returning results
|
||||
d = dict(elem.attrib)
|
||||
children = list(elem)
|
||||
if not children:
|
||||
if elem.text and elem.text.strip():
|
||||
d["_text"] = elem.text.strip()
|
||||
return d
|
||||
for c in children:
|
||||
cd = _to_dict(c)
|
||||
if c.tag in d:
|
||||
if not isinstance(d[c.tag], list):
|
||||
d[c.tag] = [d[c.tag]]
|
||||
d[c.tag].append(cd)
|
||||
else:
|
||||
d[c.tag] = cd
|
||||
return d
|
||||
|
||||
|
||||
def _run(fn):
|
||||
try:
|
||||
print(json.dumps(fn(_cfg(), _inputs())))
|
||||
except urllib.error.HTTPError as e:
|
||||
print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
|
||||
sys.exit(1)
|
||||
except Exception as e:
|
||||
print(json.dumps({"error": str(e)}))
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
def main(cfg, inputs):
|
||||
name = str(inputs.get("name") or "").strip()
|
||||
if not name:
|
||||
raise Exception("name is required")
|
||||
|
||||
cmd = (
|
||||
"<request><system><external-list><refresh><name>"
|
||||
+ escape(name)
|
||||
+ "</name></refresh></external-list></system></request>"
|
||||
)
|
||||
|
||||
api(cfg, {"type": "op", "cmd": cmd})
|
||||
|
||||
return {"ok": True, "name": name}
|
||||
|
||||
|
||||
_run(main)
|
||||
@@ -0,0 +1,119 @@
|
||||
import json, os, sys, urllib.parse, urllib.request, urllib.error, ssl
|
||||
import xml.etree.ElementTree as ET
|
||||
from xml.sax.saxutils import escape, quoteattr
|
||||
|
||||
|
||||
def _cfg():
|
||||
return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
|
||||
|
||||
|
||||
def _inputs():
|
||||
return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
|
||||
|
||||
|
||||
def _ctx(cfg):
|
||||
if cfg.get("insecure"):
|
||||
c = ssl.create_default_context()
|
||||
c.check_hostname = False
|
||||
c.verify_mode = ssl.CERT_NONE
|
||||
return c
|
||||
return None
|
||||
|
||||
|
||||
def _base(cfg):
|
||||
server = str(cfg.get("server", "")).rstrip("/")
|
||||
port = cfg.get("port") or 443
|
||||
return server + ":" + str(port) + "/api/"
|
||||
|
||||
|
||||
def _vsys(cfg):
|
||||
return cfg.get("vsys") or "vsys1"
|
||||
|
||||
|
||||
def _xpath_addr_prefix(cfg):
|
||||
return ("/config/devices/entry[@name='localhost.localdomain']/vsys/entry[@name='"
|
||||
+ _vsys(cfg) + "']")
|
||||
|
||||
|
||||
def api(cfg, params):
|
||||
p = dict(params)
|
||||
p["key"] = str(cfg.get("api_key", ""))
|
||||
url = _base(cfg) + "?" + urllib.parse.urlencode(p)
|
||||
req = urllib.request.Request(url, method="GET")
|
||||
with urllib.request.urlopen(req, timeout=90, context=_ctx(cfg)) as r:
|
||||
raw = r.read()
|
||||
text = raw.decode("utf-8", "replace")
|
||||
try:
|
||||
root = ET.fromstring(raw)
|
||||
except Exception:
|
||||
raise Exception("Invalid XML response: " + text[:500])
|
||||
if root.attrib.get("status") != "success":
|
||||
raise Exception("PAN-OS error: " + text[:800])
|
||||
return root, text
|
||||
|
||||
|
||||
def _to_dict(elem):
|
||||
# Shallow XML→dict for returning results
|
||||
d = dict(elem.attrib)
|
||||
children = list(elem)
|
||||
if not children:
|
||||
if elem.text and elem.text.strip():
|
||||
d["_text"] = elem.text.strip()
|
||||
return d
|
||||
for c in children:
|
||||
cd = _to_dict(c)
|
||||
if c.tag in d:
|
||||
if not isinstance(d[c.tag], list):
|
||||
d[c.tag] = [d[c.tag]]
|
||||
d[c.tag].append(cd)
|
||||
else:
|
||||
d[c.tag] = cd
|
||||
return d
|
||||
|
||||
|
||||
def _run(fn):
|
||||
try:
|
||||
print(json.dumps(fn(_cfg(), _inputs())))
|
||||
except urllib.error.HTTPError as e:
|
||||
print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
|
||||
sys.exit(1)
|
||||
except Exception as e:
|
||||
print(json.dumps({"error": str(e)}))
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
def main(cfg, inputs):
|
||||
ip = str(inputs.get("ip") or "").strip()
|
||||
if not ip:
|
||||
raise Exception("ip is required")
|
||||
|
||||
tags = [s.strip() for s in str(inputs.get("tags") or "").split(",") if s.strip()]
|
||||
if not tags:
|
||||
raise Exception("tags is required")
|
||||
|
||||
timeout_attr = ""
|
||||
timeout = inputs.get("timeout")
|
||||
if timeout not in (None, ""):
|
||||
try:
|
||||
t = int(timeout)
|
||||
except (TypeError, ValueError):
|
||||
t = 0
|
||||
if t > 0:
|
||||
timeout_attr = ' timeout="' + str(t) + '"'
|
||||
|
||||
members = "".join(
|
||||
"<member" + timeout_attr + ">" + escape(tag) + "</member>" for tag in tags
|
||||
)
|
||||
|
||||
uid_xml = (
|
||||
"<uid-message><version>1.0</version><type>update</type><payload><register>"
|
||||
"<entry ip=" + quoteattr(ip) + ' persistent="1"><tag>' + members + "</tag>"
|
||||
"</entry></register></payload></uid-message>"
|
||||
)
|
||||
|
||||
api(cfg, {"type": "user-id", "vsys": _vsys(cfg), "cmd": uid_xml})
|
||||
|
||||
return {"ok": True, "ip": ip, "tags": tags}
|
||||
|
||||
|
||||
_run(main)
|
||||
@@ -0,0 +1,92 @@
|
||||
import json, os, sys, urllib.parse, urllib.request, urllib.error, ssl
|
||||
import xml.etree.ElementTree as ET
|
||||
|
||||
|
||||
def _cfg():
|
||||
return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
|
||||
|
||||
|
||||
def _inputs():
|
||||
return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
|
||||
|
||||
|
||||
def _ctx(cfg):
|
||||
if cfg.get("insecure"):
|
||||
c = ssl.create_default_context()
|
||||
c.check_hostname = False
|
||||
c.verify_mode = ssl.CERT_NONE
|
||||
return c
|
||||
return None
|
||||
|
||||
|
||||
def _base(cfg):
|
||||
server = str(cfg.get("server", "")).rstrip("/")
|
||||
port = cfg.get("port") or 443
|
||||
return server + ":" + str(port) + "/api/"
|
||||
|
||||
|
||||
def _vsys(cfg):
|
||||
return cfg.get("vsys") or "vsys1"
|
||||
|
||||
|
||||
def _xpath_addr_prefix(cfg):
|
||||
return ("/config/devices/entry[@name='localhost.localdomain']/vsys/entry[@name='"
|
||||
+ _vsys(cfg) + "']")
|
||||
|
||||
|
||||
def api(cfg, params):
|
||||
p = dict(params)
|
||||
p["key"] = str(cfg.get("api_key", ""))
|
||||
url = _base(cfg) + "?" + urllib.parse.urlencode(p)
|
||||
req = urllib.request.Request(url, method="GET")
|
||||
with urllib.request.urlopen(req, timeout=90, context=_ctx(cfg)) as r:
|
||||
raw = r.read()
|
||||
text = raw.decode("utf-8", "replace")
|
||||
try:
|
||||
root = ET.fromstring(raw)
|
||||
except Exception:
|
||||
raise Exception("Invalid XML response: " + text[:500])
|
||||
if root.attrib.get("status") != "success":
|
||||
raise Exception("PAN-OS error: " + text[:800])
|
||||
return root, text
|
||||
|
||||
|
||||
def _to_dict(elem):
|
||||
# Shallow XML→dict for returning results
|
||||
d = dict(elem.attrib)
|
||||
children = list(elem)
|
||||
if not children:
|
||||
if elem.text and elem.text.strip():
|
||||
d["_text"] = elem.text.strip()
|
||||
return d
|
||||
for c in children:
|
||||
cd = _to_dict(c)
|
||||
if c.tag in d:
|
||||
if not isinstance(d[c.tag], list):
|
||||
d[c.tag] = [d[c.tag]]
|
||||
d[c.tag].append(cd)
|
||||
else:
|
||||
d[c.tag] = cd
|
||||
return d
|
||||
|
||||
|
||||
def _run(fn):
|
||||
try:
|
||||
print(json.dumps(fn(_cfg(), _inputs())))
|
||||
except urllib.error.HTTPError as e:
|
||||
print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
|
||||
sys.exit(1)
|
||||
except Exception as e:
|
||||
print(json.dumps({"error": str(e)}))
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
def main(cfg, inputs):
|
||||
cmd = "<show><system><info></info></system></show>"
|
||||
|
||||
api(cfg, {"type": "op", "cmd": cmd})
|
||||
|
||||
return {"ok": True}
|
||||
|
||||
|
||||
_run(main)
|
||||
@@ -0,0 +1,107 @@
|
||||
import json, os, sys, urllib.parse, urllib.request, urllib.error, ssl
|
||||
import xml.etree.ElementTree as ET
|
||||
from xml.sax.saxutils import escape, quoteattr
|
||||
|
||||
|
||||
def _cfg():
|
||||
return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
|
||||
|
||||
|
||||
def _inputs():
|
||||
return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
|
||||
|
||||
|
||||
def _ctx(cfg):
|
||||
if cfg.get("insecure"):
|
||||
c = ssl.create_default_context()
|
||||
c.check_hostname = False
|
||||
c.verify_mode = ssl.CERT_NONE
|
||||
return c
|
||||
return None
|
||||
|
||||
|
||||
def _base(cfg):
|
||||
server = str(cfg.get("server", "")).rstrip("/")
|
||||
port = cfg.get("port") or 443
|
||||
return server + ":" + str(port) + "/api/"
|
||||
|
||||
|
||||
def _vsys(cfg):
|
||||
return cfg.get("vsys") or "vsys1"
|
||||
|
||||
|
||||
def _xpath_addr_prefix(cfg):
|
||||
return ("/config/devices/entry[@name='localhost.localdomain']/vsys/entry[@name='"
|
||||
+ _vsys(cfg) + "']")
|
||||
|
||||
|
||||
def api(cfg, params):
|
||||
p = dict(params)
|
||||
p["key"] = str(cfg.get("api_key", ""))
|
||||
url = _base(cfg) + "?" + urllib.parse.urlencode(p)
|
||||
req = urllib.request.Request(url, method="GET")
|
||||
with urllib.request.urlopen(req, timeout=90, context=_ctx(cfg)) as r:
|
||||
raw = r.read()
|
||||
text = raw.decode("utf-8", "replace")
|
||||
try:
|
||||
root = ET.fromstring(raw)
|
||||
except Exception:
|
||||
raise Exception("Invalid XML response: " + text[:500])
|
||||
if root.attrib.get("status") != "success":
|
||||
raise Exception("PAN-OS error: " + text[:800])
|
||||
return root, text
|
||||
|
||||
|
||||
def _to_dict(elem):
|
||||
# Shallow XML→dict for returning results
|
||||
d = dict(elem.attrib)
|
||||
children = list(elem)
|
||||
if not children:
|
||||
if elem.text and elem.text.strip():
|
||||
d["_text"] = elem.text.strip()
|
||||
return d
|
||||
for c in children:
|
||||
cd = _to_dict(c)
|
||||
if c.tag in d:
|
||||
if not isinstance(d[c.tag], list):
|
||||
d[c.tag] = [d[c.tag]]
|
||||
d[c.tag].append(cd)
|
||||
else:
|
||||
d[c.tag] = cd
|
||||
return d
|
||||
|
||||
|
||||
def _run(fn):
|
||||
try:
|
||||
print(json.dumps(fn(_cfg(), _inputs())))
|
||||
except urllib.error.HTTPError as e:
|
||||
print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
|
||||
sys.exit(1)
|
||||
except Exception as e:
|
||||
print(json.dumps({"error": str(e)}))
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
def main(cfg, inputs):
|
||||
ip = str(inputs.get("ip") or "").strip()
|
||||
if not ip:
|
||||
raise Exception("ip is required")
|
||||
|
||||
tags = [s.strip() for s in str(inputs.get("tags") or "").split(",") if s.strip()]
|
||||
if not tags:
|
||||
raise Exception("tags is required")
|
||||
|
||||
members = "".join("<member>" + escape(tag) + "</member>" for tag in tags)
|
||||
|
||||
uid_xml = (
|
||||
"<uid-message><version>1.0</version><type>update</type><payload><unregister>"
|
||||
"<entry ip=" + quoteattr(ip) + "><tag>" + members + "</tag>"
|
||||
"</entry></unregister></payload></uid-message>"
|
||||
)
|
||||
|
||||
api(cfg, {"type": "user-id", "vsys": _vsys(cfg), "cmd": uid_xml})
|
||||
|
||||
return {"ok": True, "ip": ip, "tags": tags}
|
||||
|
||||
|
||||
_run(main)
|
||||
Reference in New Issue
Block a user