feat(cisco-fmc): new Cisco Firepower Management Center integration

FMC REST API, 7 commands: list/create/delete host objects, list access
policies/rules, create block access rule. Token auth (generatetoken, token +
domain UUID from response headers), stdlib-only.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

integrations/checkpoint/manifest.yaml

@@ -0,0 +1,101 @@
+id: checkpoint
+name: Check Point
+version: 1.0.0
+description: "Check Point Management (Web API) — firewall containment: list and add host objects, view the access rulebase, add a drop rule (block), publish changes, and install policy. Session (login) authentication; stdlib-only, no extra Python dependencies."
+changelog: "1.0.0 — Initial release: show/add hosts, show access rulebase, add access rule (drop), publish, install policy."
+category: network
+
+# Per-instance configuration. Each command logs in to the Management API
+# (returns a session id used as the X-chkp-sid header), performs the action,
+# then logs out. Publishing/installing is explicit (separate commands).
+config_schema:
+  properties:
+    server_url:
+      type: string
+      description: "Management server URL (e.g. https://mgmt.example.com)"
+    username:
+      type: string
+      description: "Management API username"
+    password:
+      type: string
+      description: "Management API password"
+      x-soar-sensitive: true
+    domain:
+      type: string
+      description: "Domain (for Multi-Domain Management; leave empty otherwise)"
+    insecure:
+      type: boolean
+      description: "Trust any TLS certificate (not secure)"
+      default: false
+  required:
+    - server_url
+    - username
+    - password
+
+commands:
+  - id: show_hosts
+    name: checkpoint-show-hosts
+    description: "List host objects."
+    risk: read
+    inputs_schema:
+      properties:
+        limit: { type: number, description: "Max hosts (default 50)" }
+      required: []
+    outputs_schema: { properties: {} }
+  - id: add_host
+    name: checkpoint-add-host
+    description: "Create a host object."
+    inputs_schema:
+      properties:
+        name: { type: string, description: "Host object name" }
+        ip_address: { type: string, description: "Host IP address" }
+      required: [name, ip_address]
+    outputs_schema: { properties: {} }
+  - id: show_access_rulebase
+    name: checkpoint-show-access-rulebase
+    description: "Show the access rulebase of a policy layer."
+    risk: read
+    inputs_schema:
+      properties:
+        layer: { type: string, description: "Access layer name (e.g. Network)" }
+        limit: { type: number, description: "Max rules (default 50)" }
+      required: [layer]
+    outputs_schema: { properties: {} }
+  - id: add_access_rule
+    name: checkpoint-add-access-rule
+    description: "Add an access rule to a layer (e.g. a Drop rule to block a source)."
+    inputs_schema:
+      properties:
+        layer: { type: string, description: "Access layer name" }
+        name: { type: string, description: "Rule name" }
+        position: { type: string, description: "Position (e.g. top, bottom, or a number; default top)" }
+        source: { type: string, description: "Source object name (e.g. a host)" }
+        destination: { type: string, description: "Destination object name (default Any)" }
+        action: { type: string, description: "Accept, Drop, or Reject (default Drop)" }
+      required: [layer, name]
+    outputs_schema: { properties: {} }
+  - id: publish
+    name: checkpoint-publish
+    description: "Publish the current session's changes."
+    inputs_schema:
+      properties: {}
+      required: []
+    outputs_schema: { properties: {} }
+  - id: install_policy
+    name: checkpoint-install-policy
+    description: "Install a policy package on gateway targets."
+    inputs_schema:
+      properties:
+        policy_package: { type: string, description: "Policy package name" }
+        targets: { type: string, description: "Comma-separated gateway target names" }
+      required: [policy_package, targets]
+    outputs_schema: { properties: {} }
+
+  - id: test_connection
+    name: checkpoint-test-connection
+    description: "Verify connectivity and credentials by logging in (used by the Test button)."
+    risk: read
+    inputs_schema:
+      properties: {}
+      required: []
+    outputs_schema: { properties: {} }

integrations/checkpoint/scripts/add_access_rule.py

@@ -0,0 +1,104 @@
+import json, os, sys, ssl, urllib.request, urllib.error
+
+
+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
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("server_url", "")).rstrip("/") + "/web_api"
+        self.ctx = _ctx(cfg)
+        self.sid = None
+
+    def _post(self, command, body, sid=None):
+        url = self.base + "/" + command
+        data = json.dumps(body if body is not None else {}).encode("utf-8")
+        headers = {"Content-Type": "application/json", "Accept": "application/json"}
+        if sid:
+            headers["X-chkp-sid"] = sid
+        req = urllib.request.Request(url, data=data, headers=headers, method="POST")
+        with urllib.request.urlopen(req, timeout=90, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+    def login(self):
+        body = {"user": self.cfg.get("username", ""), "password": self.cfg.get("password", "")}
+        if self.cfg.get("domain"):
+            body["domain"] = self.cfg["domain"]
+        resp = self._post("login", body)
+        self.sid = resp.get("sid")
+        if not self.sid:
+            raise Exception("Login failed: " + json.dumps(resp))
+        return resp
+
+    def call(self, command, body=None):
+        return self._post(command, body, sid=self.sid)
+
+    def logout(self):
+        try:
+            self.call("logout", {})
+        except Exception:
+            pass
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.login()
+        try:
+            result = fn(client, inputs)
+        finally:
+            client.logout()
+        print(json.dumps(result))
+    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(client, inputs):
+    layer = inputs.get("layer")
+    if not layer:
+        raise Exception("layer is required")
+    name = inputs.get("name")
+    if not name:
+        raise Exception("name is required")
+    position = inputs.get("position")
+    action = inputs.get("action")
+    source = inputs.get("source")
+    destination = inputs.get("destination")
+
+    body = {
+        "layer": layer,
+        "name": name,
+        "position": (position or "top"),
+        "action": (action or "Drop"),
+    }
+    if source:
+        body["source"] = source
+    if destination:
+        body["destination"] = destination
+
+    return client.call("add-access-rule", body)
+
+
+_run(main)

integrations/checkpoint/scripts/add_host.py

@@ -0,0 +1,88 @@
+import json, os, sys, ssl, urllib.request, urllib.error
+
+
+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
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("server_url", "")).rstrip("/") + "/web_api"
+        self.ctx = _ctx(cfg)
+        self.sid = None
+
+    def _post(self, command, body, sid=None):
+        url = self.base + "/" + command
+        data = json.dumps(body if body is not None else {}).encode("utf-8")
+        headers = {"Content-Type": "application/json", "Accept": "application/json"}
+        if sid:
+            headers["X-chkp-sid"] = sid
+        req = urllib.request.Request(url, data=data, headers=headers, method="POST")
+        with urllib.request.urlopen(req, timeout=90, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+    def login(self):
+        body = {"user": self.cfg.get("username", ""), "password": self.cfg.get("password", "")}
+        if self.cfg.get("domain"):
+            body["domain"] = self.cfg["domain"]
+        resp = self._post("login", body)
+        self.sid = resp.get("sid")
+        if not self.sid:
+            raise Exception("Login failed: " + json.dumps(resp))
+        return resp
+
+    def call(self, command, body=None):
+        return self._post(command, body, sid=self.sid)
+
+    def logout(self):
+        try:
+            self.call("logout", {})
+        except Exception:
+            pass
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.login()
+        try:
+            result = fn(client, inputs)
+        finally:
+            client.logout()
+        print(json.dumps(result))
+    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(client, inputs):
+    name = inputs.get("name")
+    if not name:
+        raise Exception("name is required")
+    ip_address = inputs.get("ip_address")
+    if not ip_address:
+        raise Exception("ip_address is required")
+    return client.call("add-host", {"name": name, "ip-address": ip_address})
+
+
+_run(main)

integrations/checkpoint/scripts/install_policy.py

@@ -0,0 +1,92 @@
+import json, os, sys, ssl, urllib.request, urllib.error
+
+
+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
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("server_url", "")).rstrip("/") + "/web_api"
+        self.ctx = _ctx(cfg)
+        self.sid = None
+
+    def _post(self, command, body, sid=None):
+        url = self.base + "/" + command
+        data = json.dumps(body if body is not None else {}).encode("utf-8")
+        headers = {"Content-Type": "application/json", "Accept": "application/json"}
+        if sid:
+            headers["X-chkp-sid"] = sid
+        req = urllib.request.Request(url, data=data, headers=headers, method="POST")
+        with urllib.request.urlopen(req, timeout=90, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+    def login(self):
+        body = {"user": self.cfg.get("username", ""), "password": self.cfg.get("password", "")}
+        if self.cfg.get("domain"):
+            body["domain"] = self.cfg["domain"]
+        resp = self._post("login", body)
+        self.sid = resp.get("sid")
+        if not self.sid:
+            raise Exception("Login failed: " + json.dumps(resp))
+        return resp
+
+    def call(self, command, body=None):
+        return self._post(command, body, sid=self.sid)
+
+    def logout(self):
+        try:
+            self.call("logout", {})
+        except Exception:
+            pass
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.login()
+        try:
+            result = fn(client, inputs)
+        finally:
+            client.logout()
+        print(json.dumps(result))
+    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(client, inputs):
+    policy_package = inputs.get("policy_package")
+    if not policy_package:
+        raise Exception("policy_package is required")
+    targets = inputs.get("targets")
+    if not targets:
+        raise Exception("targets is required")
+    targets_list = [s.strip() for s in str(targets).split(",") if s.strip()]
+    if not targets_list:
+        raise Exception("targets is required")
+
+    return client.call("install-policy", {"policy-package": policy_package, "targets": targets_list})
+
+
+_run(main)

integrations/checkpoint/scripts/publish.py

@@ -0,0 +1,82 @@
+import json, os, sys, ssl, urllib.request, urllib.error
+
+
+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
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("server_url", "")).rstrip("/") + "/web_api"
+        self.ctx = _ctx(cfg)
+        self.sid = None
+
+    def _post(self, command, body, sid=None):
+        url = self.base + "/" + command
+        data = json.dumps(body if body is not None else {}).encode("utf-8")
+        headers = {"Content-Type": "application/json", "Accept": "application/json"}
+        if sid:
+            headers["X-chkp-sid"] = sid
+        req = urllib.request.Request(url, data=data, headers=headers, method="POST")
+        with urllib.request.urlopen(req, timeout=90, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+    def login(self):
+        body = {"user": self.cfg.get("username", ""), "password": self.cfg.get("password", "")}
+        if self.cfg.get("domain"):
+            body["domain"] = self.cfg["domain"]
+        resp = self._post("login", body)
+        self.sid = resp.get("sid")
+        if not self.sid:
+            raise Exception("Login failed: " + json.dumps(resp))
+        return resp
+
+    def call(self, command, body=None):
+        return self._post(command, body, sid=self.sid)
+
+    def logout(self):
+        try:
+            self.call("logout", {})
+        except Exception:
+            pass
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.login()
+        try:
+            result = fn(client, inputs)
+        finally:
+            client.logout()
+        print(json.dumps(result))
+    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(client, inputs):
+    return client.call("publish", {})
+
+
+_run(main)

integrations/checkpoint/scripts/show_access_rulebase.py

@@ -0,0 +1,86 @@
+import json, os, sys, ssl, urllib.request, urllib.error
+
+
+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
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("server_url", "")).rstrip("/") + "/web_api"
+        self.ctx = _ctx(cfg)
+        self.sid = None
+
+    def _post(self, command, body, sid=None):
+        url = self.base + "/" + command
+        data = json.dumps(body if body is not None else {}).encode("utf-8")
+        headers = {"Content-Type": "application/json", "Accept": "application/json"}
+        if sid:
+            headers["X-chkp-sid"] = sid
+        req = urllib.request.Request(url, data=data, headers=headers, method="POST")
+        with urllib.request.urlopen(req, timeout=90, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+    def login(self):
+        body = {"user": self.cfg.get("username", ""), "password": self.cfg.get("password", "")}
+        if self.cfg.get("domain"):
+            body["domain"] = self.cfg["domain"]
+        resp = self._post("login", body)
+        self.sid = resp.get("sid")
+        if not self.sid:
+            raise Exception("Login failed: " + json.dumps(resp))
+        return resp
+
+    def call(self, command, body=None):
+        return self._post(command, body, sid=self.sid)
+
+    def logout(self):
+        try:
+            self.call("logout", {})
+        except Exception:
+            pass
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.login()
+        try:
+            result = fn(client, inputs)
+        finally:
+            client.logout()
+        print(json.dumps(result))
+    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(client, inputs):
+    layer = inputs.get("layer")
+    if not layer:
+        raise Exception("layer is required")
+    limit = inputs.get("limit")
+    return client.call("show-access-rulebase", {"name": layer, "limit": int(limit or 50)})
+
+
+_run(main)

integrations/checkpoint/scripts/show_hosts.py

@@ -0,0 +1,83 @@
+import json, os, sys, ssl, urllib.request, urllib.error
+
+
+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
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("server_url", "")).rstrip("/") + "/web_api"
+        self.ctx = _ctx(cfg)
+        self.sid = None
+
+    def _post(self, command, body, sid=None):
+        url = self.base + "/" + command
+        data = json.dumps(body if body is not None else {}).encode("utf-8")
+        headers = {"Content-Type": "application/json", "Accept": "application/json"}
+        if sid:
+            headers["X-chkp-sid"] = sid
+        req = urllib.request.Request(url, data=data, headers=headers, method="POST")
+        with urllib.request.urlopen(req, timeout=90, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+    def login(self):
+        body = {"user": self.cfg.get("username", ""), "password": self.cfg.get("password", "")}
+        if self.cfg.get("domain"):
+            body["domain"] = self.cfg["domain"]
+        resp = self._post("login", body)
+        self.sid = resp.get("sid")
+        if not self.sid:
+            raise Exception("Login failed: " + json.dumps(resp))
+        return resp
+
+    def call(self, command, body=None):
+        return self._post(command, body, sid=self.sid)
+
+    def logout(self):
+        try:
+            self.call("logout", {})
+        except Exception:
+            pass
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.login()
+        try:
+            result = fn(client, inputs)
+        finally:
+            client.logout()
+        print(json.dumps(result))
+    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(client, inputs):
+    limit = inputs.get("limit")
+    return client.call("show-hosts", {"limit": int(limit or 50)})
+
+
+_run(main)

integrations/checkpoint/scripts/test_connection.py

@@ -0,0 +1,83 @@
+import json, os, sys, ssl, urllib.request, urllib.error
+
+
+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
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("server_url", "")).rstrip("/") + "/web_api"
+        self.ctx = _ctx(cfg)
+        self.sid = None
+
+    def _post(self, command, body, sid=None):
+        url = self.base + "/" + command
+        data = json.dumps(body if body is not None else {}).encode("utf-8")
+        headers = {"Content-Type": "application/json", "Accept": "application/json"}
+        if sid:
+            headers["X-chkp-sid"] = sid
+        req = urllib.request.Request(url, data=data, headers=headers, method="POST")
+        with urllib.request.urlopen(req, timeout=90, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+    def login(self):
+        body = {"user": self.cfg.get("username", ""), "password": self.cfg.get("password", "")}
+        if self.cfg.get("domain"):
+            body["domain"] = self.cfg["domain"]
+        resp = self._post("login", body)
+        self.sid = resp.get("sid")
+        if not self.sid:
+            raise Exception("Login failed: " + json.dumps(resp))
+        return resp
+
+    def call(self, command, body=None):
+        return self._post(command, body, sid=self.sid)
+
+    def logout(self):
+        try:
+            self.call("logout", {})
+        except Exception:
+            pass
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.login()
+        try:
+            result = fn(client, inputs)
+        finally:
+            client.logout()
+        print(json.dumps(result))
+    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(client, inputs):
+    client.call("show-hosts", {"limit": 1})
+    return {"ok": True}
+
+
+_run(main)

integrations/cisco-fmc/manifest.yaml

@@ -0,0 +1,99 @@
+id: cisco_fmc
+name: Cisco Firepower Management Center
+version: 1.0.0
+description: "Cisco Secure Firewall Management Center (FMC REST API) — firewall containment: list and create/delete network host objects, list access policies and rules, and add a block access rule. Token authentication (generatetoken); stdlib-only, no extra Python dependencies."
+changelog: "1.0.0 — Initial release: list/create/delete host objects, list access policies/rules, create block access rule."
+category: network
+
+# Per-instance configuration. Auth calls generatetoken with HTTP Basic and reuses
+# the returned X-auth-access-token and DOMAIN_UUID (default domain).
+config_schema:
+  properties:
+    base_url:
+      type: string
+      description: "FMC base URL (e.g. https://fmc.example.com)"
+    username:
+      type: string
+      description: "FMC username"
+    password:
+      type: string
+      description: "FMC password"
+      x-soar-sensitive: true
+    insecure:
+      type: boolean
+      description: "Trust any TLS certificate (not secure)"
+      default: false
+  required:
+    - base_url
+    - username
+    - password
+
+commands:
+  - id: list_host_objects
+    name: fmc-list-host-objects
+    description: "List network host objects."
+    risk: read
+    inputs_schema:
+      properties:
+        limit: { type: number, description: "Max objects (default 50)" }
+      required: []
+    outputs_schema: { properties: {} }
+  - id: create_host_object
+    name: fmc-create-host-object
+    description: "Create a network host object."
+    inputs_schema:
+      properties:
+        name: { type: string, description: "Object name" }
+        value: { type: string, description: "Host IP address" }
+        description: { type: string, description: "Optional description" }
+      required: [name, value]
+    outputs_schema: { properties: {} }
+  - id: delete_host_object
+    name: fmc-delete-host-object
+    description: "Delete a network host object by ID."
+    inputs_schema:
+      properties:
+        object_id: { type: string, description: "Host object ID" }
+      required: [object_id]
+    outputs_schema: { properties: {} }
+  - id: list_access_policies
+    name: fmc-list-access-policies
+    description: "List access control policies."
+    risk: read
+    inputs_schema:
+      properties:
+        limit: { type: number, description: "Max policies (default 50)" }
+      required: []
+    outputs_schema: { properties: {} }
+  - id: list_access_rules
+    name: fmc-list-access-rules
+    description: "List the access rules of an access control policy."
+    risk: read
+    inputs_schema:
+      properties:
+        policy_id: { type: string, description: "Access control policy ID" }
+        limit: { type: number, description: "Max rules (default 50)" }
+      required: [policy_id]
+    outputs_schema: { properties: {} }
+  - id: create_access_rule
+    name: fmc-create-access-rule
+    description: "Add an access rule to a policy (e.g. a BLOCK rule for source/destination network objects)."
+    inputs_schema:
+      properties:
+        policy_id: { type: string, description: "Access control policy ID" }
+        name: { type: string, description: "Rule name" }
+        action: { type: string, description: "ALLOW, TRUST, or BLOCK (default BLOCK)" }
+        source_object_ids: { type: string, description: "Comma-separated source network object IDs (optional)" }
+        destination_object_ids: { type: string, description: "Comma-separated destination network object IDs (optional)" }
+        enabled: { type: boolean, description: "Enable the rule (default true)" }
+      required: [policy_id, name]
+    outputs_schema: { properties: {} }
+
+  - id: test_connection
+    name: fmc-test-connection
+    description: "Verify connectivity and credentials via generatetoken (used by the Test button)."
+    risk: read
+    inputs_schema:
+      properties: {}
+      required: []
+    outputs_schema: { properties: {} }

integrations/cisco-fmc/scripts/create_access_rule.py

@@ -0,0 +1,115 @@
+import json, os, sys, base64, ssl, urllib.parse, urllib.request, urllib.error
+
+
+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
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("base_url", "")).rstrip("/")
+        self.ctx = _ctx(cfg)
+        self.token = None
+        self.domain_uuid = None
+
+    def authenticate(self):
+        creds = str(self.cfg.get("username", "")) + ":" + str(self.cfg.get("password", ""))
+        basic = base64.b64encode(creds.encode("utf-8")).decode("utf-8")
+        req = urllib.request.Request(self.base + "/api/fmc_platform/v1/auth/generatetoken",
+                                     data=b"", headers={"Authorization": "Basic " + basic}, method="POST")
+        with urllib.request.urlopen(req, timeout=60, context=self.ctx) as r:
+            r.read()
+            self.token = r.headers.get("X-auth-access-token")
+            self.domain_uuid = r.headers.get("DOMAIN_UUID")
+        if not self.token or not self.domain_uuid:
+            raise Exception("Authentication failed: missing token or domain UUID")
+
+    def _cfg_base(self):
+        return self.base + "/api/fmc_config/v1/domain/" + self.domain_uuid
+
+    def call(self, method, path, body=None, params=None):
+        # path is relative to the domain config base, e.g. /object/hosts
+        url = self._cfg_base() + path
+        if params:
+            clean = {k: v for k, v in params.items() if v not in (None, "")}
+            if clean:
+                url += "?" + urllib.parse.urlencode(clean)
+        data = json.dumps(body).encode("utf-8") if body is not None else None
+        headers = {"X-auth-access-token": self.token, "Accept": "application/json"}
+        if data is not None:
+            headers["Content-Type"] = "application/json"
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+        with urllib.request.urlopen(req, timeout=90, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.authenticate()
+        print(json.dumps(fn(client, 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)
+
+
+q = lambda v: urllib.parse.quote(str(v), safe="")
+
+
+def _csv(v):
+    return [s.strip() for s in str(v).split(",") if s.strip()]
+
+
+def main(client, inputs):
+    policy_id = inputs.get("policy_id")
+    name = inputs.get("name")
+    action = inputs.get("action")
+    source_object_ids = inputs.get("source_object_ids")
+    destination_object_ids = inputs.get("destination_object_ids")
+    enabled = inputs.get("enabled")
+    if not policy_id:
+        raise Exception("policy_id is required")
+    if not name:
+        raise Exception("name is required")
+
+    body = {
+        "name": name,
+        "action": (action or "BLOCK"),
+        "enabled": (enabled if enabled is not None else True),
+        "type": "AccessRule",
+    }
+
+    if source_object_ids:
+        source_ids_list = _csv(source_object_ids)
+        if source_ids_list:
+            body["sourceNetworks"] = {"objects": [{"id": oid, "type": "Host"} for oid in source_ids_list]}
+
+    if destination_object_ids:
+        dest_ids_list = _csv(destination_object_ids)
+        if dest_ids_list:
+            body["destinationNetworks"] = {"objects": [{"id": oid, "type": "Host"} for oid in dest_ids_list]}
+
+    return client.call("POST", "/policy/accesspolicies/" + q(policy_id) + "/accessrules", body=body)
+
+
+_run(main)

integrations/cisco-fmc/scripts/create_host_object.py

@@ -0,0 +1,90 @@
+import json, os, sys, base64, ssl, urllib.parse, urllib.request, urllib.error
+
+
+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
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("base_url", "")).rstrip("/")
+        self.ctx = _ctx(cfg)
+        self.token = None
+        self.domain_uuid = None
+
+    def authenticate(self):
+        creds = str(self.cfg.get("username", "")) + ":" + str(self.cfg.get("password", ""))
+        basic = base64.b64encode(creds.encode("utf-8")).decode("utf-8")
+        req = urllib.request.Request(self.base + "/api/fmc_platform/v1/auth/generatetoken",
+                                     data=b"", headers={"Authorization": "Basic " + basic}, method="POST")
+        with urllib.request.urlopen(req, timeout=60, context=self.ctx) as r:
+            r.read()
+            self.token = r.headers.get("X-auth-access-token")
+            self.domain_uuid = r.headers.get("DOMAIN_UUID")
+        if not self.token or not self.domain_uuid:
+            raise Exception("Authentication failed: missing token or domain UUID")
+
+    def _cfg_base(self):
+        return self.base + "/api/fmc_config/v1/domain/" + self.domain_uuid
+
+    def call(self, method, path, body=None, params=None):
+        # path is relative to the domain config base, e.g. /object/hosts
+        url = self._cfg_base() + path
+        if params:
+            clean = {k: v for k, v in params.items() if v not in (None, "")}
+            if clean:
+                url += "?" + urllib.parse.urlencode(clean)
+        data = json.dumps(body).encode("utf-8") if body is not None else None
+        headers = {"X-auth-access-token": self.token, "Accept": "application/json"}
+        if data is not None:
+            headers["Content-Type"] = "application/json"
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+        with urllib.request.urlopen(req, timeout=90, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.authenticate()
+        print(json.dumps(fn(client, 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(client, inputs):
+    name = inputs.get("name")
+    value = inputs.get("value")
+    description = inputs.get("description")
+    if not name:
+        raise Exception("name is required")
+    if not value:
+        raise Exception("value is required")
+    body = {"name": name, "type": "Host", "value": value}
+    if description:
+        body["description"] = description
+    return client.call("POST", "/object/hosts", body=body)
+
+
+_run(main)

integrations/cisco-fmc/scripts/delete_host_object.py

@@ -0,0 +1,86 @@
+import json, os, sys, base64, ssl, urllib.parse, urllib.request, urllib.error
+
+
+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
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("base_url", "")).rstrip("/")
+        self.ctx = _ctx(cfg)
+        self.token = None
+        self.domain_uuid = None
+
+    def authenticate(self):
+        creds = str(self.cfg.get("username", "")) + ":" + str(self.cfg.get("password", ""))
+        basic = base64.b64encode(creds.encode("utf-8")).decode("utf-8")
+        req = urllib.request.Request(self.base + "/api/fmc_platform/v1/auth/generatetoken",
+                                     data=b"", headers={"Authorization": "Basic " + basic}, method="POST")
+        with urllib.request.urlopen(req, timeout=60, context=self.ctx) as r:
+            r.read()
+            self.token = r.headers.get("X-auth-access-token")
+            self.domain_uuid = r.headers.get("DOMAIN_UUID")
+        if not self.token or not self.domain_uuid:
+            raise Exception("Authentication failed: missing token or domain UUID")
+
+    def _cfg_base(self):
+        return self.base + "/api/fmc_config/v1/domain/" + self.domain_uuid
+
+    def call(self, method, path, body=None, params=None):
+        # path is relative to the domain config base, e.g. /object/hosts
+        url = self._cfg_base() + path
+        if params:
+            clean = {k: v for k, v in params.items() if v not in (None, "")}
+            if clean:
+                url += "?" + urllib.parse.urlencode(clean)
+        data = json.dumps(body).encode("utf-8") if body is not None else None
+        headers = {"X-auth-access-token": self.token, "Accept": "application/json"}
+        if data is not None:
+            headers["Content-Type"] = "application/json"
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+        with urllib.request.urlopen(req, timeout=90, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.authenticate()
+        print(json.dumps(fn(client, 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)
+
+
+q = lambda v: urllib.parse.quote(str(v), safe="")
+
+
+def main(client, inputs):
+    object_id = inputs.get("object_id")
+    if not object_id:
+        raise Exception("object_id is required")
+    return client.call("DELETE", "/object/hosts/" + q(object_id))
+
+
+_run(main)

integrations/cisco-fmc/scripts/list_access_policies.py

@@ -0,0 +1,81 @@
+import json, os, sys, base64, ssl, urllib.parse, urllib.request, urllib.error
+
+
+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
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("base_url", "")).rstrip("/")
+        self.ctx = _ctx(cfg)
+        self.token = None
+        self.domain_uuid = None
+
+    def authenticate(self):
+        creds = str(self.cfg.get("username", "")) + ":" + str(self.cfg.get("password", ""))
+        basic = base64.b64encode(creds.encode("utf-8")).decode("utf-8")
+        req = urllib.request.Request(self.base + "/api/fmc_platform/v1/auth/generatetoken",
+                                     data=b"", headers={"Authorization": "Basic " + basic}, method="POST")
+        with urllib.request.urlopen(req, timeout=60, context=self.ctx) as r:
+            r.read()
+            self.token = r.headers.get("X-auth-access-token")
+            self.domain_uuid = r.headers.get("DOMAIN_UUID")
+        if not self.token or not self.domain_uuid:
+            raise Exception("Authentication failed: missing token or domain UUID")
+
+    def _cfg_base(self):
+        return self.base + "/api/fmc_config/v1/domain/" + self.domain_uuid
+
+    def call(self, method, path, body=None, params=None):
+        # path is relative to the domain config base, e.g. /object/hosts
+        url = self._cfg_base() + path
+        if params:
+            clean = {k: v for k, v in params.items() if v not in (None, "")}
+            if clean:
+                url += "?" + urllib.parse.urlencode(clean)
+        data = json.dumps(body).encode("utf-8") if body is not None else None
+        headers = {"X-auth-access-token": self.token, "Accept": "application/json"}
+        if data is not None:
+            headers["Content-Type"] = "application/json"
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+        with urllib.request.urlopen(req, timeout=90, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.authenticate()
+        print(json.dumps(fn(client, 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(client, inputs):
+    limit = inputs.get("limit")
+    return client.call("GET", "/policy/accesspolicies", params={"limit": int(limit or 50)})
+
+
+_run(main)

integrations/cisco-fmc/scripts/list_access_rules.py

@@ -0,0 +1,88 @@
+import json, os, sys, base64, ssl, urllib.parse, urllib.request, urllib.error
+
+
+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
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("base_url", "")).rstrip("/")
+        self.ctx = _ctx(cfg)
+        self.token = None
+        self.domain_uuid = None
+
+    def authenticate(self):
+        creds = str(self.cfg.get("username", "")) + ":" + str(self.cfg.get("password", ""))
+        basic = base64.b64encode(creds.encode("utf-8")).decode("utf-8")
+        req = urllib.request.Request(self.base + "/api/fmc_platform/v1/auth/generatetoken",
+                                     data=b"", headers={"Authorization": "Basic " + basic}, method="POST")
+        with urllib.request.urlopen(req, timeout=60, context=self.ctx) as r:
+            r.read()
+            self.token = r.headers.get("X-auth-access-token")
+            self.domain_uuid = r.headers.get("DOMAIN_UUID")
+        if not self.token or not self.domain_uuid:
+            raise Exception("Authentication failed: missing token or domain UUID")
+
+    def _cfg_base(self):
+        return self.base + "/api/fmc_config/v1/domain/" + self.domain_uuid
+
+    def call(self, method, path, body=None, params=None):
+        # path is relative to the domain config base, e.g. /object/hosts
+        url = self._cfg_base() + path
+        if params:
+            clean = {k: v for k, v in params.items() if v not in (None, "")}
+            if clean:
+                url += "?" + urllib.parse.urlencode(clean)
+        data = json.dumps(body).encode("utf-8") if body is not None else None
+        headers = {"X-auth-access-token": self.token, "Accept": "application/json"}
+        if data is not None:
+            headers["Content-Type"] = "application/json"
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+        with urllib.request.urlopen(req, timeout=90, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.authenticate()
+        print(json.dumps(fn(client, 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)
+
+
+q = lambda v: urllib.parse.quote(str(v), safe="")
+
+
+def main(client, inputs):
+    policy_id = inputs.get("policy_id")
+    limit = inputs.get("limit")
+    if not policy_id:
+        raise Exception("policy_id is required")
+    return client.call("GET", "/policy/accesspolicies/" + q(policy_id) + "/accessrules",
+                        params={"limit": int(limit or 50), "expanded": "true"})
+
+
+_run(main)

integrations/cisco-fmc/scripts/list_host_objects.py

@@ -0,0 +1,81 @@
+import json, os, sys, base64, ssl, urllib.parse, urllib.request, urllib.error
+
+
+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
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("base_url", "")).rstrip("/")
+        self.ctx = _ctx(cfg)
+        self.token = None
+        self.domain_uuid = None
+
+    def authenticate(self):
+        creds = str(self.cfg.get("username", "")) + ":" + str(self.cfg.get("password", ""))
+        basic = base64.b64encode(creds.encode("utf-8")).decode("utf-8")
+        req = urllib.request.Request(self.base + "/api/fmc_platform/v1/auth/generatetoken",
+                                     data=b"", headers={"Authorization": "Basic " + basic}, method="POST")
+        with urllib.request.urlopen(req, timeout=60, context=self.ctx) as r:
+            r.read()
+            self.token = r.headers.get("X-auth-access-token")
+            self.domain_uuid = r.headers.get("DOMAIN_UUID")
+        if not self.token or not self.domain_uuid:
+            raise Exception("Authentication failed: missing token or domain UUID")
+
+    def _cfg_base(self):
+        return self.base + "/api/fmc_config/v1/domain/" + self.domain_uuid
+
+    def call(self, method, path, body=None, params=None):
+        # path is relative to the domain config base, e.g. /object/hosts
+        url = self._cfg_base() + path
+        if params:
+            clean = {k: v for k, v in params.items() if v not in (None, "")}
+            if clean:
+                url += "?" + urllib.parse.urlencode(clean)
+        data = json.dumps(body).encode("utf-8") if body is not None else None
+        headers = {"X-auth-access-token": self.token, "Accept": "application/json"}
+        if data is not None:
+            headers["Content-Type"] = "application/json"
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+        with urllib.request.urlopen(req, timeout=90, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.authenticate()
+        print(json.dumps(fn(client, 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(client, inputs):
+    limit = inputs.get("limit")
+    return client.call("GET", "/object/hosts", params={"limit": int(limit or 50), "expanded": "true"})
+
+
+_run(main)

integrations/cisco-fmc/scripts/test_connection.py

@@ -0,0 +1,81 @@
+import json, os, sys, base64, ssl, urllib.parse, urllib.request, urllib.error
+
+
+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
+
+
+class Client:
+    def __init__(self, cfg):
+        self.cfg = cfg
+        self.base = str(cfg.get("base_url", "")).rstrip("/")
+        self.ctx = _ctx(cfg)
+        self.token = None
+        self.domain_uuid = None
+
+    def authenticate(self):
+        creds = str(self.cfg.get("username", "")) + ":" + str(self.cfg.get("password", ""))
+        basic = base64.b64encode(creds.encode("utf-8")).decode("utf-8")
+        req = urllib.request.Request(self.base + "/api/fmc_platform/v1/auth/generatetoken",
+                                     data=b"", headers={"Authorization": "Basic " + basic}, method="POST")
+        with urllib.request.urlopen(req, timeout=60, context=self.ctx) as r:
+            r.read()
+            self.token = r.headers.get("X-auth-access-token")
+            self.domain_uuid = r.headers.get("DOMAIN_UUID")
+        if not self.token or not self.domain_uuid:
+            raise Exception("Authentication failed: missing token or domain UUID")
+
+    def _cfg_base(self):
+        return self.base + "/api/fmc_config/v1/domain/" + self.domain_uuid
+
+    def call(self, method, path, body=None, params=None):
+        # path is relative to the domain config base, e.g. /object/hosts
+        url = self._cfg_base() + path
+        if params:
+            clean = {k: v for k, v in params.items() if v not in (None, "")}
+            if clean:
+                url += "?" + urllib.parse.urlencode(clean)
+        data = json.dumps(body).encode("utf-8") if body is not None else None
+        headers = {"X-auth-access-token": self.token, "Accept": "application/json"}
+        if data is not None:
+            headers["Content-Type"] = "application/json"
+        req = urllib.request.Request(url, data=data, headers=headers, method=method)
+        with urllib.request.urlopen(req, timeout=90, context=self.ctx) as r:
+            raw = r.read()
+            return json.loads(raw) if raw else {}
+
+
+def _run(fn):
+    try:
+        cfg = _cfg()
+        inputs = _inputs()
+        client = Client(cfg)
+        client.authenticate()
+        print(json.dumps(fn(client, 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(client, inputs):
+    client.call("GET", "/object/hosts", params={"limit": 1})
+    return {"ok": True, "domain_uuid": client.domain_uuid}
+
+
+_run(main)

integrations/cloudflare/manifest.yaml

@@ -0,0 +1,108 @@
+id: cloudflare
+name: Cloudflare
+version: 1.0.0
+description: "Cloudflare (client API v4) — network containment at the edge: list zones, block/unblock IPs (firewall access rules), list access rules, and manage DNS records (list/create/delete). API-token (Bearer) authentication; stdlib-only, no extra Python dependencies."
+changelog: "1.0.0 — Initial release: list/get zones, block IP, list/delete access rules, list/create/delete DNS records."
+category: network
+
+# Per-instance configuration. The API token is sent as 'Authorization: Bearer <api_token>'.
+config_schema:
+  properties:
+    api_token:
+      type: string
+      description: "Cloudflare API token (scoped to the needed zones/permissions)"
+      x-soar-sensitive: true
+  required:
+    - api_token
+
+commands:
+  - id: list_zones
+    name: cloudflare-list-zones
+    description: "List zones (domains) in the account."
+    risk: read
+    inputs_schema:
+      properties:
+        name: { type: string, description: "Optional zone name filter" }
+      required: []
+    outputs_schema: { properties: {} }
+  - id: get_zone
+    name: cloudflare-get-zone
+    description: "Get a single zone by ID."
+    risk: read
+    inputs_schema:
+      properties:
+        zone_id: { type: string, description: "Zone ID" }
+      required: [zone_id]
+    outputs_schema: { properties: {} }
+  - id: block_ip
+    name: cloudflare-block-ip
+    description: "Create a firewall access rule to block (or challenge) an IP, range, ASN, or country."
+    inputs_schema:
+      properties:
+        zone_id: { type: string, description: "Zone ID" }
+        value: { type: string, description: "IP, CIDR, ASN (AS####), or 2-letter country code" }
+        target: { type: string, description: "ip, ip_range, asn, or country (default ip)" }
+        mode: { type: string, description: "block, challenge, js_challenge, or whitelist (default block)" }
+        notes: { type: string, description: "Optional note" }
+      required: [zone_id, value]
+    outputs_schema: { properties: {} }
+  - id: list_access_rules
+    name: cloudflare-list-access-rules
+    description: "List firewall access rules for a zone."
+    risk: read
+    inputs_schema:
+      properties:
+        zone_id: { type: string, description: "Zone ID" }
+      required: [zone_id]
+    outputs_schema: { properties: {} }
+  - id: delete_access_rule
+    name: cloudflare-delete-access-rule
+    description: "Delete a firewall access rule (unblock)."
+    inputs_schema:
+      properties:
+        zone_id: { type: string, description: "Zone ID" }
+        rule_id: { type: string, description: "Access rule ID" }
+      required: [zone_id, rule_id]
+    outputs_schema: { properties: {} }
+  - id: list_dns_records
+    name: cloudflare-list-dns-records
+    description: "List DNS records for a zone."
+    risk: read
+    inputs_schema:
+      properties:
+        zone_id: { type: string, description: "Zone ID" }
+        record_type: { type: string, description: "Optional record type filter (A, AAAA, CNAME, TXT, ...)" }
+        name: { type: string, description: "Optional record name filter" }
+      required: [zone_id]
+    outputs_schema: { properties: {} }
+  - id: create_dns_record
+    name: cloudflare-create-dns-record
+    description: "Create a DNS record (e.g. sinkhole a malicious host)."
+    inputs_schema:
+      properties:
+        zone_id: { type: string, description: "Zone ID" }
+        record_type: { type: string, description: "Record type (A, AAAA, CNAME, TXT, ...)" }
+        name: { type: string, description: "Record name" }
+        content: { type: string, description: "Record content (IP or target)" }
+        ttl: { type: number, description: "TTL seconds (1 = automatic, default 1)" }
+        proxied: { type: boolean, description: "Proxy through Cloudflare (default false)" }
+      required: [zone_id, record_type, name, content]
+    outputs_schema: { properties: {} }
+  - id: delete_dns_record
+    name: cloudflare-delete-dns-record
+    description: "Delete a DNS record."
+    inputs_schema:
+      properties:
+        zone_id: { type: string, description: "Zone ID" }
+        record_id: { type: string, description: "DNS record ID" }
+      required: [zone_id, record_id]
+    outputs_schema: { properties: {} }
+
+  - id: test_connection
+    name: cloudflare-test-connection
+    description: "Verify the API token (used by the Test button)."
+    risk: read
+    inputs_schema:
+      properties: {}
+      required: []
+    outputs_schema: { properties: {} }

integrations/cloudflare/scripts/block_ip.py

@@ -0,0 +1,60 @@
+import json, os, sys, urllib.parse, urllib.request, urllib.error
+
+BASE = "https://api.cloudflare.com/client/v4"
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def request(method, path, cfg, body=None, params=None):
+    url = BASE + path
+    if params:
+        clean = {k: v for k, v in params.items() if v not in (None, "")}
+        if clean:
+            url += "?" + urllib.parse.urlencode(clean)
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": "Bearer " + str(cfg.get("api_token", "")), "Accept": "application/json"}
+    if data is not None:
+        headers["Content-Type"] = "application/json"
+    req = urllib.request.Request(url, data=data, headers=headers, method=method)
+    with urllib.request.urlopen(req, timeout=60) as r:
+        raw = r.read()
+        return json.loads(raw) if raw else {}
+
+
+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)
+
+
+q = lambda v: urllib.parse.quote(str(v), safe="")
+
+
+def main(cfg, inputs):
+    zone_id = inputs.get("zone_id")
+    if not zone_id:
+        raise Exception("zone_id is required")
+    value = inputs.get("value")
+    if not value:
+        raise Exception("value is required")
+    target = inputs.get("target") or "ip"
+    mode = inputs.get("mode") or "block"
+    notes = inputs.get("notes")
+    body = {"mode": mode, "configuration": {"target": target, "value": value}}
+    if notes:
+        body["notes"] = notes
+    return request("POST", "/zones/" + q(zone_id) + "/firewall/access_rules/rules", cfg, body=body)
+
+
+_run(main)

integrations/cloudflare/scripts/create_dns_record.py

@@ -0,0 +1,69 @@
+import json, os, sys, urllib.parse, urllib.request, urllib.error
+
+BASE = "https://api.cloudflare.com/client/v4"
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def request(method, path, cfg, body=None, params=None):
+    url = BASE + path
+    if params:
+        clean = {k: v for k, v in params.items() if v not in (None, "")}
+        if clean:
+            url += "?" + urllib.parse.urlencode(clean)
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": "Bearer " + str(cfg.get("api_token", "")), "Accept": "application/json"}
+    if data is not None:
+        headers["Content-Type"] = "application/json"
+    req = urllib.request.Request(url, data=data, headers=headers, method=method)
+    with urllib.request.urlopen(req, timeout=60) as r:
+        raw = r.read()
+        return json.loads(raw) if raw else {}
+
+
+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)
+
+
+q = lambda v: urllib.parse.quote(str(v), safe="")
+
+
+def main(cfg, inputs):
+    zone_id = inputs.get("zone_id")
+    if not zone_id:
+        raise Exception("zone_id is required")
+    record_type = inputs.get("record_type")
+    if not record_type:
+        raise Exception("record_type is required")
+    name = inputs.get("name")
+    if not name:
+        raise Exception("name is required")
+    content = inputs.get("content")
+    if not content:
+        raise Exception("content is required")
+    ttl = inputs.get("ttl")
+    proxied = inputs.get("proxied")
+    body = {
+        "type": record_type,
+        "name": name,
+        "content": content,
+        "ttl": int(ttl or 1),
+        "proxied": bool(proxied),
+    }
+    return request("POST", "/zones/" + q(zone_id) + "/dns_records", cfg, body=body)
+
+
+_run(main)

integrations/cloudflare/scripts/delete_access_rule.py

@@ -0,0 +1,54 @@
+import json, os, sys, urllib.parse, urllib.request, urllib.error
+
+BASE = "https://api.cloudflare.com/client/v4"
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def request(method, path, cfg, body=None, params=None):
+    url = BASE + path
+    if params:
+        clean = {k: v for k, v in params.items() if v not in (None, "")}
+        if clean:
+            url += "?" + urllib.parse.urlencode(clean)
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": "Bearer " + str(cfg.get("api_token", "")), "Accept": "application/json"}
+    if data is not None:
+        headers["Content-Type"] = "application/json"
+    req = urllib.request.Request(url, data=data, headers=headers, method=method)
+    with urllib.request.urlopen(req, timeout=60) as r:
+        raw = r.read()
+        return json.loads(raw) if raw else {}
+
+
+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)
+
+
+q = lambda v: urllib.parse.quote(str(v), safe="")
+
+
+def main(cfg, inputs):
+    zone_id = inputs.get("zone_id")
+    if not zone_id:
+        raise Exception("zone_id is required")
+    rule_id = inputs.get("rule_id")
+    if not rule_id:
+        raise Exception("rule_id is required")
+    return request("DELETE", "/zones/" + q(zone_id) + "/firewall/access_rules/rules/" + q(rule_id), cfg)
+
+
+_run(main)

integrations/cloudflare/scripts/delete_dns_record.py

@@ -0,0 +1,54 @@
+import json, os, sys, urllib.parse, urllib.request, urllib.error
+
+BASE = "https://api.cloudflare.com/client/v4"
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def request(method, path, cfg, body=None, params=None):
+    url = BASE + path
+    if params:
+        clean = {k: v for k, v in params.items() if v not in (None, "")}
+        if clean:
+            url += "?" + urllib.parse.urlencode(clean)
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": "Bearer " + str(cfg.get("api_token", "")), "Accept": "application/json"}
+    if data is not None:
+        headers["Content-Type"] = "application/json"
+    req = urllib.request.Request(url, data=data, headers=headers, method=method)
+    with urllib.request.urlopen(req, timeout=60) as r:
+        raw = r.read()
+        return json.loads(raw) if raw else {}
+
+
+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)
+
+
+q = lambda v: urllib.parse.quote(str(v), safe="")
+
+
+def main(cfg, inputs):
+    zone_id = inputs.get("zone_id")
+    if not zone_id:
+        raise Exception("zone_id is required")
+    record_id = inputs.get("record_id")
+    if not record_id:
+        raise Exception("record_id is required")
+    return request("DELETE", "/zones/" + q(zone_id) + "/dns_records/" + q(record_id), cfg)
+
+
+_run(main)

integrations/cloudflare/scripts/get_zone.py

@@ -0,0 +1,51 @@
+import json, os, sys, urllib.parse, urllib.request, urllib.error
+
+BASE = "https://api.cloudflare.com/client/v4"
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def request(method, path, cfg, body=None, params=None):
+    url = BASE + path
+    if params:
+        clean = {k: v for k, v in params.items() if v not in (None, "")}
+        if clean:
+            url += "?" + urllib.parse.urlencode(clean)
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": "Bearer " + str(cfg.get("api_token", "")), "Accept": "application/json"}
+    if data is not None:
+        headers["Content-Type"] = "application/json"
+    req = urllib.request.Request(url, data=data, headers=headers, method=method)
+    with urllib.request.urlopen(req, timeout=60) as r:
+        raw = r.read()
+        return json.loads(raw) if raw else {}
+
+
+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)
+
+
+q = lambda v: urllib.parse.quote(str(v), safe="")
+
+
+def main(cfg, inputs):
+    zone_id = inputs.get("zone_id")
+    if not zone_id:
+        raise Exception("zone_id is required")
+    return request("GET", "/zones/" + q(zone_id), cfg)
+
+
+_run(main)

integrations/cloudflare/scripts/list_access_rules.py

@@ -0,0 +1,51 @@
+import json, os, sys, urllib.parse, urllib.request, urllib.error
+
+BASE = "https://api.cloudflare.com/client/v4"
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def request(method, path, cfg, body=None, params=None):
+    url = BASE + path
+    if params:
+        clean = {k: v for k, v in params.items() if v not in (None, "")}
+        if clean:
+            url += "?" + urllib.parse.urlencode(clean)
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": "Bearer " + str(cfg.get("api_token", "")), "Accept": "application/json"}
+    if data is not None:
+        headers["Content-Type"] = "application/json"
+    req = urllib.request.Request(url, data=data, headers=headers, method=method)
+    with urllib.request.urlopen(req, timeout=60) as r:
+        raw = r.read()
+        return json.loads(raw) if raw else {}
+
+
+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)
+
+
+q = lambda v: urllib.parse.quote(str(v), safe="")
+
+
+def main(cfg, inputs):
+    zone_id = inputs.get("zone_id")
+    if not zone_id:
+        raise Exception("zone_id is required")
+    return request("GET", "/zones/" + q(zone_id) + "/firewall/access_rules/rules", cfg, params={"per_page": 50})
+
+
+_run(main)

integrations/cloudflare/scripts/list_dns_records.py

@@ -0,0 +1,58 @@
+import json, os, sys, urllib.parse, urllib.request, urllib.error
+
+BASE = "https://api.cloudflare.com/client/v4"
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def request(method, path, cfg, body=None, params=None):
+    url = BASE + path
+    if params:
+        clean = {k: v for k, v in params.items() if v not in (None, "")}
+        if clean:
+            url += "?" + urllib.parse.urlencode(clean)
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": "Bearer " + str(cfg.get("api_token", "")), "Accept": "application/json"}
+    if data is not None:
+        headers["Content-Type"] = "application/json"
+    req = urllib.request.Request(url, data=data, headers=headers, method=method)
+    with urllib.request.urlopen(req, timeout=60) as r:
+        raw = r.read()
+        return json.loads(raw) if raw else {}
+
+
+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)
+
+
+q = lambda v: urllib.parse.quote(str(v), safe="")
+
+
+def main(cfg, inputs):
+    zone_id = inputs.get("zone_id")
+    if not zone_id:
+        raise Exception("zone_id is required")
+    record_type = inputs.get("record_type")
+    name = inputs.get("name")
+    return request(
+        "GET",
+        "/zones/" + q(zone_id) + "/dns_records",
+        cfg,
+        params={"type": record_type, "name": name, "per_page": 100},
+    )
+
+
+_run(main)

integrations/cloudflare/scripts/list_zones.py

@@ -0,0 +1,46 @@
+import json, os, sys, urllib.parse, urllib.request, urllib.error
+
+BASE = "https://api.cloudflare.com/client/v4"
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def request(method, path, cfg, body=None, params=None):
+    url = BASE + path
+    if params:
+        clean = {k: v for k, v in params.items() if v not in (None, "")}
+        if clean:
+            url += "?" + urllib.parse.urlencode(clean)
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": "Bearer " + str(cfg.get("api_token", "")), "Accept": "application/json"}
+    if data is not None:
+        headers["Content-Type"] = "application/json"
+    req = urllib.request.Request(url, data=data, headers=headers, method=method)
+    with urllib.request.urlopen(req, timeout=60) as r:
+        raw = r.read()
+        return json.loads(raw) if raw else {}
+
+
+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 = inputs.get("name")
+    return request("GET", "/zones", cfg, params={"name": name, "per_page": 50})
+
+
+_run(main)

integrations/cloudflare/scripts/test_connection.py

@@ -0,0 +1,46 @@
+import json, os, sys, urllib.parse, urllib.request, urllib.error
+
+BASE = "https://api.cloudflare.com/client/v4"
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _inputs():
+    return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+
+
+def request(method, path, cfg, body=None, params=None):
+    url = BASE + path
+    if params:
+        clean = {k: v for k, v in params.items() if v not in (None, "")}
+        if clean:
+            url += "?" + urllib.parse.urlencode(clean)
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": "Bearer " + str(cfg.get("api_token", "")), "Accept": "application/json"}
+    if data is not None:
+        headers["Content-Type"] = "application/json"
+    req = urllib.request.Request(url, data=data, headers=headers, method=method)
+    with urllib.request.urlopen(req, timeout=60) as r:
+        raw = r.read()
+        return json.loads(raw) if raw else {}
+
+
+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):
+    request("GET", "/user/tokens/verify", cfg)
+    return {"ok": True}
+
+
+_run(main)