feat(threatconnect): new ThreatConnect threat-intel integration

ThreatConnect API v3, 9 commands: list/get/create/delete indicators, list/get/
create groups, add indicator tag. HMAC-SHA256 signed auth, stdlib-only.

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

integrations/threatconnect/scripts/add_indicator_tag.py

@@ -0,0 +1,56 @@
+import json, os, sys, time, hmac, hashlib, base64
+import 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 request(method, api_path, cfg, body=None):
+    # api_path MUST include the leading /api/v3/... and any ?query string.
+    base = str(cfg.get("base_url", "")).rstrip("/")
+    url = base + api_path
+    timestamp = str(int(time.time()))
+    to_sign = api_path + ":" + method.upper() + ":" + timestamp
+    secret = str(cfg.get("api_secret_key", "")).encode("utf-8")
+    signature = base64.b64encode(hmac.new(secret, to_sign.encode("utf-8"), hashlib.sha256).digest()).decode("utf-8")
+    authorization = "TC " + str(cfg.get("access_id", "")) + ":" + signature
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": authorization, "Timestamp": timestamp, "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):
+    indicator_id = inputs.get("indicator_id")
+    tag = inputs.get("tag")
+    if not indicator_id:
+        raise Exception("indicator_id is required")
+    if not tag:
+        raise Exception("tag is required")
+    q = lambda v: urllib.parse.quote(str(v), safe="")
+    path = "/api/v3/indicators/" + q(indicator_id)
+    body = {"tags": {"data": [{"name": tag}], "mode": "append"}}
+    return request("PUT", path, cfg, body)
+
+
+_run(main)

integrations/threatconnect/scripts/create_group.py

@@ -0,0 +1,57 @@
+import json, os, sys, time, hmac, hashlib, base64
+import 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 request(method, api_path, cfg, body=None):
+    # api_path MUST include the leading /api/v3/... and any ?query string.
+    base = str(cfg.get("base_url", "")).rstrip("/")
+    url = base + api_path
+    timestamp = str(int(time.time()))
+    to_sign = api_path + ":" + method.upper() + ":" + timestamp
+    secret = str(cfg.get("api_secret_key", "")).encode("utf-8")
+    signature = base64.b64encode(hmac.new(secret, to_sign.encode("utf-8"), hashlib.sha256).digest()).decode("utf-8")
+    authorization = "TC " + str(cfg.get("access_id", "")) + ":" + signature
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": authorization, "Timestamp": timestamp, "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):
+    type_ = inputs.get("type")
+    name = inputs.get("name")
+    if not type_:
+        raise Exception("type is required")
+    if not name:
+        raise Exception("name is required")
+    owner_name = inputs.get("owner_name")
+    body = {"type": type_, "name": name}
+    if owner_name:
+        body["ownerName"] = owner_name
+    return request("POST", "/api/v3/groups", cfg, body)
+
+
+_run(main)

integrations/threatconnect/scripts/create_indicator.py

@@ -0,0 +1,63 @@
+import json, os, sys, time, hmac, hashlib, base64
+import 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 request(method, api_path, cfg, body=None):
+    # api_path MUST include the leading /api/v3/... and any ?query string.
+    base = str(cfg.get("base_url", "")).rstrip("/")
+    url = base + api_path
+    timestamp = str(int(time.time()))
+    to_sign = api_path + ":" + method.upper() + ":" + timestamp
+    secret = str(cfg.get("api_secret_key", "")).encode("utf-8")
+    signature = base64.b64encode(hmac.new(secret, to_sign.encode("utf-8"), hashlib.sha256).digest()).decode("utf-8")
+    authorization = "TC " + str(cfg.get("access_id", "")) + ":" + signature
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": authorization, "Timestamp": timestamp, "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):
+    type_ = inputs.get("type")
+    summary = inputs.get("summary")
+    if not type_:
+        raise Exception("type is required")
+    if not summary:
+        raise Exception("summary is required")
+    owner_name = inputs.get("owner_name")
+    rating = inputs.get("rating")
+    confidence = inputs.get("confidence")
+    body = {"type": type_, "summary": summary}
+    if owner_name:
+        body["ownerName"] = owner_name
+    if rating not in (None, ""):
+        body["rating"] = int(rating)
+    if confidence not in (None, ""):
+        body["confidence"] = int(confidence)
+    return request("POST", "/api/v3/indicators", cfg, body)
+
+
+_run(main)

integrations/threatconnect/scripts/delete_indicator.py

@@ -0,0 +1,55 @@
+import json, os, sys, time, hmac, hashlib, base64
+import 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 request(method, api_path, cfg, body=None):
+    # api_path MUST include the leading /api/v3/... and any ?query string.
+    base = str(cfg.get("base_url", "")).rstrip("/")
+    url = base + api_path
+    timestamp = str(int(time.time()))
+    to_sign = api_path + ":" + method.upper() + ":" + timestamp
+    secret = str(cfg.get("api_secret_key", "")).encode("utf-8")
+    signature = base64.b64encode(hmac.new(secret, to_sign.encode("utf-8"), hashlib.sha256).digest()).decode("utf-8")
+    authorization = "TC " + str(cfg.get("access_id", "")) + ":" + signature
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": authorization, "Timestamp": timestamp, "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):
+    indicator_id = inputs.get("indicator_id")
+    if not indicator_id:
+        raise Exception("indicator_id is required")
+    q = lambda v: urllib.parse.quote(str(v), safe="")
+    path = "/api/v3/indicators/" + q(indicator_id)
+    result = request("DELETE", path, cfg)
+    if not result:
+        return {"ok": True, "deleted": indicator_id}
+    return result
+
+
+_run(main)

integrations/threatconnect/scripts/get_group.py

@@ -0,0 +1,52 @@
+import json, os, sys, time, hmac, hashlib, base64
+import 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 request(method, api_path, cfg, body=None):
+    # api_path MUST include the leading /api/v3/... and any ?query string.
+    base = str(cfg.get("base_url", "")).rstrip("/")
+    url = base + api_path
+    timestamp = str(int(time.time()))
+    to_sign = api_path + ":" + method.upper() + ":" + timestamp
+    secret = str(cfg.get("api_secret_key", "")).encode("utf-8")
+    signature = base64.b64encode(hmac.new(secret, to_sign.encode("utf-8"), hashlib.sha256).digest()).decode("utf-8")
+    authorization = "TC " + str(cfg.get("access_id", "")) + ":" + signature
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": authorization, "Timestamp": timestamp, "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):
+    group_id = inputs.get("group_id")
+    if not group_id:
+        raise Exception("group_id is required")
+    q = lambda v: urllib.parse.quote(str(v), safe="")
+    path = "/api/v3/groups/" + q(group_id)
+    return request("GET", path, cfg)
+
+
+_run(main)

integrations/threatconnect/scripts/get_indicator.py

@@ -0,0 +1,52 @@
+import json, os, sys, time, hmac, hashlib, base64
+import 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 request(method, api_path, cfg, body=None):
+    # api_path MUST include the leading /api/v3/... and any ?query string.
+    base = str(cfg.get("base_url", "")).rstrip("/")
+    url = base + api_path
+    timestamp = str(int(time.time()))
+    to_sign = api_path + ":" + method.upper() + ":" + timestamp
+    secret = str(cfg.get("api_secret_key", "")).encode("utf-8")
+    signature = base64.b64encode(hmac.new(secret, to_sign.encode("utf-8"), hashlib.sha256).digest()).decode("utf-8")
+    authorization = "TC " + str(cfg.get("access_id", "")) + ":" + signature
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": authorization, "Timestamp": timestamp, "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):
+    indicator_id = inputs.get("indicator_id")
+    if not indicator_id:
+        raise Exception("indicator_id is required")
+    q = lambda v: urllib.parse.quote(str(v), safe="")
+    path = "/api/v3/indicators/" + q(indicator_id)
+    return request("GET", path, cfg)
+
+
+_run(main)

integrations/threatconnect/scripts/list_groups.py

@@ -0,0 +1,53 @@
+import json, os, sys, time, hmac, hashlib, base64
+import 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 request(method, api_path, cfg, body=None):
+    # api_path MUST include the leading /api/v3/... and any ?query string.
+    base = str(cfg.get("base_url", "")).rstrip("/")
+    url = base + api_path
+    timestamp = str(int(time.time()))
+    to_sign = api_path + ":" + method.upper() + ":" + timestamp
+    secret = str(cfg.get("api_secret_key", "")).encode("utf-8")
+    signature = base64.b64encode(hmac.new(secret, to_sign.encode("utf-8"), hashlib.sha256).digest()).decode("utf-8")
+    authorization = "TC " + str(cfg.get("access_id", "")) + ":" + signature
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": authorization, "Timestamp": timestamp, "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):
+    tql = inputs.get("tql")
+    limit = inputs.get("limit")
+    params = {"resultLimit": int(limit or 50)}
+    if tql:
+        params["tql"] = tql
+    path = "/api/v3/groups?" + urllib.parse.urlencode(params)
+    return request("GET", path, cfg)
+
+
+_run(main)

integrations/threatconnect/scripts/list_indicators.py

@@ -0,0 +1,53 @@
+import json, os, sys, time, hmac, hashlib, base64
+import 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 request(method, api_path, cfg, body=None):
+    # api_path MUST include the leading /api/v3/... and any ?query string.
+    base = str(cfg.get("base_url", "")).rstrip("/")
+    url = base + api_path
+    timestamp = str(int(time.time()))
+    to_sign = api_path + ":" + method.upper() + ":" + timestamp
+    secret = str(cfg.get("api_secret_key", "")).encode("utf-8")
+    signature = base64.b64encode(hmac.new(secret, to_sign.encode("utf-8"), hashlib.sha256).digest()).decode("utf-8")
+    authorization = "TC " + str(cfg.get("access_id", "")) + ":" + signature
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": authorization, "Timestamp": timestamp, "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):
+    tql = inputs.get("tql")
+    limit = inputs.get("limit")
+    params = {"resultLimit": int(limit or 50)}
+    if tql:
+        params["tql"] = tql
+    path = "/api/v3/indicators?" + urllib.parse.urlencode(params)
+    return request("GET", path, cfg)
+
+
+_run(main)

integrations/threatconnect/scripts/test_connection.py

@@ -0,0 +1,49 @@
+import json, os, sys, time, hmac, hashlib, base64
+import 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 request(method, api_path, cfg, body=None):
+    # api_path MUST include the leading /api/v3/... and any ?query string.
+    base = str(cfg.get("base_url", "")).rstrip("/")
+    url = base + api_path
+    timestamp = str(int(time.time()))
+    to_sign = api_path + ":" + method.upper() + ":" + timestamp
+    secret = str(cfg.get("api_secret_key", "")).encode("utf-8")
+    signature = base64.b64encode(hmac.new(secret, to_sign.encode("utf-8"), hashlib.sha256).digest()).decode("utf-8")
+    authorization = "TC " + str(cfg.get("access_id", "")) + ":" + signature
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Authorization": authorization, "Timestamp": timestamp, "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):
+    path = "/api/v3/indicators?" + urllib.parse.urlencode({"resultLimit": 1})
+    request("GET", path, cfg)
+    return {"ok": True}
+
+
+_run(main)