From 1292a8c798fefe8d34710aed181cad8c1736d608 Mon Sep 17 00:00:00 2001 From: Guillaume BOURGEOIS Date: Sun, 12 Jul 2026 00:42:01 +0200 Subject: [PATCH] feat(cape): new CAPE Sandbox integration CAPE APIv2, 6 commands: submit file (multipart) / URL, get task, get report, list tasks. Token auth, stdlib-only. Co-Authored-By: Claude Opus 4.8 (1M context) --- integrations/cape/manifest.yaml | 79 +++++++++++++++++ integrations/cape/scripts/get_report.py | 83 ++++++++++++++++++ integrations/cape/scripts/get_task.py | 83 ++++++++++++++++++ integrations/cape/scripts/list_tasks.py | 80 +++++++++++++++++ integrations/cape/scripts/submit_file.py | 92 ++++++++++++++++++++ integrations/cape/scripts/submit_url.py | 82 +++++++++++++++++ integrations/cape/scripts/test_connection.py | 80 +++++++++++++++++ 7 files changed, 579 insertions(+) create mode 100644 integrations/cape/manifest.yaml create mode 100644 integrations/cape/scripts/get_report.py create mode 100644 integrations/cape/scripts/get_task.py create mode 100644 integrations/cape/scripts/list_tasks.py create mode 100644 integrations/cape/scripts/submit_file.py create mode 100644 integrations/cape/scripts/submit_url.py create mode 100644 integrations/cape/scripts/test_connection.py diff --git a/integrations/cape/manifest.yaml b/integrations/cape/manifest.yaml new file mode 100644 index 0000000..4e00f36 --- /dev/null +++ b/integrations/cape/manifest.yaml @@ -0,0 +1,79 @@ +id: cape +name: CAPE Sandbox +version: 1.0.0 +description: "CAPE Sandbox (APIv2) — dynamic malware analysis and config extraction: submit files and URLs, read task status and reports, and list tasks. Token authentication; stdlib-only, no extra Python dependencies." +changelog: "1.0.0 — Initial release: submit file/URL, get task, get report, list tasks." +category: enrichment + +# Per-instance configuration. The token is sent as 'Authorization: Token '. +config_schema: + properties: + base_url: + type: string + description: "CAPE URL (e.g. https://cape.example.com)" + api_token: + type: string + description: "CAPE API token" + x-soar-sensitive: true + insecure: + type: boolean + description: "Trust any TLS certificate (not secure)" + default: false + required: + - base_url + - api_token + +commands: + - id: submit_file + name: cape-submit-file + description: "Submit a file (base64) for analysis." + inputs_schema: + properties: + file_name: { type: string, description: "File name" } + content_base64: { type: string, description: "File content, base64-encoded" } + required: [file_name, content_base64] + outputs_schema: { properties: {} } + - id: submit_url + name: cape-submit-url + description: "Submit a URL for analysis." + inputs_schema: + properties: + url: { type: string, description: "URL to detonate" } + required: [url] + outputs_schema: { properties: {} } + - id: get_task + name: cape-get-task + description: "Get a task's status and metadata." + risk: read + inputs_schema: + properties: + task_id: { type: string, description: "Task ID" } + required: [task_id] + outputs_schema: { properties: {} } + - id: get_report + name: cape-get-report + description: "Get a task's full analysis report (JSON)." + risk: read + inputs_schema: + properties: + task_id: { type: string, description: "Task ID" } + required: [task_id] + outputs_schema: { properties: {} } + - id: list_tasks + name: cape-list-tasks + description: "List recent tasks." + risk: read + inputs_schema: + properties: + limit: { type: number, description: "Max tasks (default 50)" } + required: [] + outputs_schema: { properties: {} } + + - id: test_connection + name: cape-test-connection + description: "Verify connectivity and the token (used by the Test button)." + risk: read + inputs_schema: + properties: {} + required: [] + outputs_schema: { properties: {} } diff --git a/integrations/cape/scripts/get_report.py b/integrations/cape/scripts/get_report.py new file mode 100644 index 0000000..dc4910c --- /dev/null +++ b/integrations/cape/scripts/get_report.py @@ -0,0 +1,83 @@ +import json, os, sys, base64, ssl, uuid, 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 + + +def _headers(cfg, extra=None): + h = {"Accept": "application/json", "Authorization": "Token " + str(cfg.get("api_token", ""))} + if extra: + h.update(extra) + return h + + +def request(method, path, cfg, form=None): + url = str(cfg.get("base_url", "")).rstrip("/") + path + data = None + extra = {} + if form is not None: + data = urllib.parse.urlencode(form).encode("utf-8") + extra["Content-Type"] = "application/x-www-form-urlencoded" + req = urllib.request.Request(url, data=data, headers=_headers(cfg, extra), method=method) + with urllib.request.urlopen(req, timeout=120, context=_ctx(cfg)) as r: + raw = r.read() + return json.loads(raw) if raw else {} + + +def multipart(fields, file_field, file_name, file_bytes): + boundary = "----riposte" + uuid.uuid4().hex + parts = [] + for k, v in (fields or {}).items(): + parts.append(("--" + boundary + "\r\n" + 'Content-Disposition: form-data; name="' + k + '"\r\n\r\n' + str(v) + "\r\n").encode("utf-8")) + parts.append(("--" + boundary + "\r\n" + 'Content-Disposition: form-data; name="' + file_field + '"; filename="' + file_name + '"\r\n' + "Content-Type: application/octet-stream\r\n\r\n").encode("utf-8")) + parts.append(file_bytes) + parts.append(("\r\n--" + boundary + "--\r\n").encode("utf-8")) + return b"".join(parts), "multipart/form-data; boundary=" + boundary + + +def request_multipart(path, cfg, fields, file_field, file_name, file_bytes): + url = str(cfg.get("base_url", "")).rstrip("/") + path + data, content_type = multipart(fields, file_field, file_name, file_bytes) + req = urllib.request.Request(url, data=data, headers=_headers(cfg, {"Content-Type": content_type}), method="POST") + with urllib.request.urlopen(req, timeout=180, context=_ctx(cfg)) 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): + task_id = inputs.get("task_id") + if not task_id: + raise Exception("task_id is required") + q = lambda v: urllib.parse.quote(str(v), safe="") + return request("GET", "/apiv2/tasks/get/report/" + q(task_id) + "/", cfg) + + +_run(main) diff --git a/integrations/cape/scripts/get_task.py b/integrations/cape/scripts/get_task.py new file mode 100644 index 0000000..51c5142 --- /dev/null +++ b/integrations/cape/scripts/get_task.py @@ -0,0 +1,83 @@ +import json, os, sys, base64, ssl, uuid, 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 + + +def _headers(cfg, extra=None): + h = {"Accept": "application/json", "Authorization": "Token " + str(cfg.get("api_token", ""))} + if extra: + h.update(extra) + return h + + +def request(method, path, cfg, form=None): + url = str(cfg.get("base_url", "")).rstrip("/") + path + data = None + extra = {} + if form is not None: + data = urllib.parse.urlencode(form).encode("utf-8") + extra["Content-Type"] = "application/x-www-form-urlencoded" + req = urllib.request.Request(url, data=data, headers=_headers(cfg, extra), method=method) + with urllib.request.urlopen(req, timeout=120, context=_ctx(cfg)) as r: + raw = r.read() + return json.loads(raw) if raw else {} + + +def multipart(fields, file_field, file_name, file_bytes): + boundary = "----riposte" + uuid.uuid4().hex + parts = [] + for k, v in (fields or {}).items(): + parts.append(("--" + boundary + "\r\n" + 'Content-Disposition: form-data; name="' + k + '"\r\n\r\n' + str(v) + "\r\n").encode("utf-8")) + parts.append(("--" + boundary + "\r\n" + 'Content-Disposition: form-data; name="' + file_field + '"; filename="' + file_name + '"\r\n' + "Content-Type: application/octet-stream\r\n\r\n").encode("utf-8")) + parts.append(file_bytes) + parts.append(("\r\n--" + boundary + "--\r\n").encode("utf-8")) + return b"".join(parts), "multipart/form-data; boundary=" + boundary + + +def request_multipart(path, cfg, fields, file_field, file_name, file_bytes): + url = str(cfg.get("base_url", "")).rstrip("/") + path + data, content_type = multipart(fields, file_field, file_name, file_bytes) + req = urllib.request.Request(url, data=data, headers=_headers(cfg, {"Content-Type": content_type}), method="POST") + with urllib.request.urlopen(req, timeout=180, context=_ctx(cfg)) 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): + task_id = inputs.get("task_id") + if not task_id: + raise Exception("task_id is required") + q = lambda v: urllib.parse.quote(str(v), safe="") + return request("GET", "/apiv2/tasks/view/" + q(task_id) + "/", cfg) + + +_run(main) diff --git a/integrations/cape/scripts/list_tasks.py b/integrations/cape/scripts/list_tasks.py new file mode 100644 index 0000000..d49a464 --- /dev/null +++ b/integrations/cape/scripts/list_tasks.py @@ -0,0 +1,80 @@ +import json, os, sys, base64, ssl, uuid, 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 + + +def _headers(cfg, extra=None): + h = {"Accept": "application/json", "Authorization": "Token " + str(cfg.get("api_token", ""))} + if extra: + h.update(extra) + return h + + +def request(method, path, cfg, form=None): + url = str(cfg.get("base_url", "")).rstrip("/") + path + data = None + extra = {} + if form is not None: + data = urllib.parse.urlencode(form).encode("utf-8") + extra["Content-Type"] = "application/x-www-form-urlencoded" + req = urllib.request.Request(url, data=data, headers=_headers(cfg, extra), method=method) + with urllib.request.urlopen(req, timeout=120, context=_ctx(cfg)) as r: + raw = r.read() + return json.loads(raw) if raw else {} + + +def multipart(fields, file_field, file_name, file_bytes): + boundary = "----riposte" + uuid.uuid4().hex + parts = [] + for k, v in (fields or {}).items(): + parts.append(("--" + boundary + "\r\n" + 'Content-Disposition: form-data; name="' + k + '"\r\n\r\n' + str(v) + "\r\n").encode("utf-8")) + parts.append(("--" + boundary + "\r\n" + 'Content-Disposition: form-data; name="' + file_field + '"; filename="' + file_name + '"\r\n' + "Content-Type: application/octet-stream\r\n\r\n").encode("utf-8")) + parts.append(file_bytes) + parts.append(("\r\n--" + boundary + "--\r\n").encode("utf-8")) + return b"".join(parts), "multipart/form-data; boundary=" + boundary + + +def request_multipart(path, cfg, fields, file_field, file_name, file_bytes): + url = str(cfg.get("base_url", "")).rstrip("/") + path + data, content_type = multipart(fields, file_field, file_name, file_bytes) + req = urllib.request.Request(url, data=data, headers=_headers(cfg, {"Content-Type": content_type}), method="POST") + with urllib.request.urlopen(req, timeout=180, context=_ctx(cfg)) 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): + limit = inputs.get("limit") + return request("GET", "/apiv2/tasks/list/" + str(int(limit or 50)) + "/", cfg) + + +_run(main) diff --git a/integrations/cape/scripts/submit_file.py b/integrations/cape/scripts/submit_file.py new file mode 100644 index 0000000..9878d06 --- /dev/null +++ b/integrations/cape/scripts/submit_file.py @@ -0,0 +1,92 @@ +import json, os, sys, base64, ssl, uuid, 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 + + +def _headers(cfg, extra=None): + h = {"Accept": "application/json", "Authorization": "Token " + str(cfg.get("api_token", ""))} + if extra: + h.update(extra) + return h + + +def request(method, path, cfg, form=None): + url = str(cfg.get("base_url", "")).rstrip("/") + path + data = None + extra = {} + if form is not None: + data = urllib.parse.urlencode(form).encode("utf-8") + extra["Content-Type"] = "application/x-www-form-urlencoded" + req = urllib.request.Request(url, data=data, headers=_headers(cfg, extra), method=method) + with urllib.request.urlopen(req, timeout=120, context=_ctx(cfg)) as r: + raw = r.read() + return json.loads(raw) if raw else {} + + +def multipart(fields, file_field, file_name, file_bytes): + boundary = "----riposte" + uuid.uuid4().hex + parts = [] + for k, v in (fields or {}).items(): + parts.append(("--" + boundary + "\r\n" + 'Content-Disposition: form-data; name="' + k + '"\r\n\r\n' + str(v) + "\r\n").encode("utf-8")) + parts.append(("--" + boundary + "\r\n" + 'Content-Disposition: form-data; name="' + file_field + '"; filename="' + file_name + '"\r\n' + "Content-Type: application/octet-stream\r\n\r\n").encode("utf-8")) + parts.append(file_bytes) + parts.append(("\r\n--" + boundary + "--\r\n").encode("utf-8")) + return b"".join(parts), "multipart/form-data; boundary=" + boundary + + +def request_multipart(path, cfg, fields, file_field, file_name, file_bytes): + url = str(cfg.get("base_url", "")).rstrip("/") + path + data, content_type = multipart(fields, file_field, file_name, file_bytes) + req = urllib.request.Request(url, data=data, headers=_headers(cfg, {"Content-Type": content_type}), method="POST") + with urllib.request.urlopen(req, timeout=180, context=_ctx(cfg)) 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): + file_name = inputs.get("file_name") + content_base64 = inputs.get("content_base64") + if not file_name: + raise Exception("file_name is required") + if not content_base64: + raise Exception("content_base64 is required") + return request_multipart( + "/apiv2/tasks/create/file/", + cfg, + {}, + "file", + file_name, + base64.b64decode(content_base64), + ) + + +_run(main) diff --git a/integrations/cape/scripts/submit_url.py b/integrations/cape/scripts/submit_url.py new file mode 100644 index 0000000..f0e76a7 --- /dev/null +++ b/integrations/cape/scripts/submit_url.py @@ -0,0 +1,82 @@ +import json, os, sys, base64, ssl, uuid, 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 + + +def _headers(cfg, extra=None): + h = {"Accept": "application/json", "Authorization": "Token " + str(cfg.get("api_token", ""))} + if extra: + h.update(extra) + return h + + +def request(method, path, cfg, form=None): + url = str(cfg.get("base_url", "")).rstrip("/") + path + data = None + extra = {} + if form is not None: + data = urllib.parse.urlencode(form).encode("utf-8") + extra["Content-Type"] = "application/x-www-form-urlencoded" + req = urllib.request.Request(url, data=data, headers=_headers(cfg, extra), method=method) + with urllib.request.urlopen(req, timeout=120, context=_ctx(cfg)) as r: + raw = r.read() + return json.loads(raw) if raw else {} + + +def multipart(fields, file_field, file_name, file_bytes): + boundary = "----riposte" + uuid.uuid4().hex + parts = [] + for k, v in (fields or {}).items(): + parts.append(("--" + boundary + "\r\n" + 'Content-Disposition: form-data; name="' + k + '"\r\n\r\n' + str(v) + "\r\n").encode("utf-8")) + parts.append(("--" + boundary + "\r\n" + 'Content-Disposition: form-data; name="' + file_field + '"; filename="' + file_name + '"\r\n' + "Content-Type: application/octet-stream\r\n\r\n").encode("utf-8")) + parts.append(file_bytes) + parts.append(("\r\n--" + boundary + "--\r\n").encode("utf-8")) + return b"".join(parts), "multipart/form-data; boundary=" + boundary + + +def request_multipart(path, cfg, fields, file_field, file_name, file_bytes): + url = str(cfg.get("base_url", "")).rstrip("/") + path + data, content_type = multipart(fields, file_field, file_name, file_bytes) + req = urllib.request.Request(url, data=data, headers=_headers(cfg, {"Content-Type": content_type}), method="POST") + with urllib.request.urlopen(req, timeout=180, context=_ctx(cfg)) 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): + url = inputs.get("url") + if not url: + raise Exception("url is required") + return request("POST", "/apiv2/tasks/create/url/", cfg, form={"url": url}) + + +_run(main) diff --git a/integrations/cape/scripts/test_connection.py b/integrations/cape/scripts/test_connection.py new file mode 100644 index 0000000..741240c --- /dev/null +++ b/integrations/cape/scripts/test_connection.py @@ -0,0 +1,80 @@ +import json, os, sys, base64, ssl, uuid, 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 + + +def _headers(cfg, extra=None): + h = {"Accept": "application/json", "Authorization": "Token " + str(cfg.get("api_token", ""))} + if extra: + h.update(extra) + return h + + +def request(method, path, cfg, form=None): + url = str(cfg.get("base_url", "")).rstrip("/") + path + data = None + extra = {} + if form is not None: + data = urllib.parse.urlencode(form).encode("utf-8") + extra["Content-Type"] = "application/x-www-form-urlencoded" + req = urllib.request.Request(url, data=data, headers=_headers(cfg, extra), method=method) + with urllib.request.urlopen(req, timeout=120, context=_ctx(cfg)) as r: + raw = r.read() + return json.loads(raw) if raw else {} + + +def multipart(fields, file_field, file_name, file_bytes): + boundary = "----riposte" + uuid.uuid4().hex + parts = [] + for k, v in (fields or {}).items(): + parts.append(("--" + boundary + "\r\n" + 'Content-Disposition: form-data; name="' + k + '"\r\n\r\n' + str(v) + "\r\n").encode("utf-8")) + parts.append(("--" + boundary + "\r\n" + 'Content-Disposition: form-data; name="' + file_field + '"; filename="' + file_name + '"\r\n' + "Content-Type: application/octet-stream\r\n\r\n").encode("utf-8")) + parts.append(file_bytes) + parts.append(("\r\n--" + boundary + "--\r\n").encode("utf-8")) + return b"".join(parts), "multipart/form-data; boundary=" + boundary + + +def request_multipart(path, cfg, fields, file_field, file_name, file_bytes): + url = str(cfg.get("base_url", "")).rstrip("/") + path + data, content_type = multipart(fields, file_field, file_name, file_bytes) + req = urllib.request.Request(url, data=data, headers=_headers(cfg, {"Content-Type": content_type}), method="POST") + with urllib.request.urlopen(req, timeout=180, context=_ctx(cfg)) 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", "/apiv2/cuckoo/status/", cfg) + return {"ok": True} + + +_run(main)