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>

integrations/panos/scripts/commit.py

@@ -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)

integrations/panos/scripts/create_address.py

@@ -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)

integrations/panos/scripts/create_custom_url_category.py

@@ -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)

integrations/panos/scripts/delete_address.py

@@ -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)

integrations/panos/scripts/edit_custom_url_category.py

@@ -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)

integrations/panos/scripts/list_edl.py

@@ -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)

integrations/panos/scripts/refresh_edl.py

@@ -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)

integrations/panos/scripts/register_ip_tag.py

@@ -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)

integrations/panos/scripts/test_connection.py

@@ -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)

integrations/panos/scripts/unregister_ip_tag.py

@@ -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)