feat(feed): add FIRST EPSS feed connector (exploit-prediction scores)

2026-07-13 12:12:35 +02:00
parent 8248c60da8
commit ac2203f9a5
3 changed files with 161 additions and 0 deletions
@@ -0,0 +1,73 @@
+import json, os, sys, ssl, urllib.parse, urllib.request, urllib.error
+
+BASE = "https://api.first.org/data/v1/epss"
+
+
+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 _get(url, cfg):
+    req = urllib.request.Request(
+        url, headers={"User-Agent": "Riposte-SOAR", "Accept": "application/json"}
+    )
+    with urllib.request.urlopen(req, timeout=120, context=_ctx(cfg)) as r:
+        return r.read()
+
+
+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 = int(inputs.get("max_indicators") or 0) or 100
+    limit = max(1, min(limit, 1000))
+    min_epss = inputs.get("min_epss") or cfg.get("min_epss")
+
+    params = {"order": "!epss", "limit": limit}
+    if min_epss not in (None, ""):
+        params["epss-gt"] = str(min_epss)
+
+    url = BASE + "?" + urllib.parse.urlencode(params)
+    raw = _get(url, cfg)
+    data = json.loads(raw) if raw else {}
+
+    out = []
+    for e in data.get("data", []):
+        if not isinstance(e, dict):
+            continue
+        cve = e.get("cve")
+        if not cve:
+            continue
+        out.append({
+            "value": cve,
+            "type": "cve",
+            "epss": e.get("epss"),
+            "percentile": e.get("percentile"),
+            "date": e.get("date"),
+        })
+
+    return {"source": "first:epss", "count": len(out), "indicators": out}
+
+
+_run(main)