feat(microsoft-sentinel): new Microsoft Sentinel integration

19 commands (Azure Resource Manager API): incident ingestion + CRUD, comments, related alerts/entities/relations, watchlists, and threat indicators. Azure AD OAuth 2.0 client-credentials, stdlib-only. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-11 22:22:46 +02:00
parent 811a85424b
commit 334ecac83e
22 changed files with 1781 additions and 0 deletions
@@ -0,0 +1,102 @@
+import json, os, sys, urllib.parse, urllib.request, urllib.error
+
+API_VERSION = "2023-11-01"
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _token():
+    cfg = _cfg()
+    data = urllib.parse.urlencode({
+        "grant_type": "client_credentials",
+        "client_id": str(cfg.get("client_id") or ""),
+        "client_secret": str(cfg.get("client_secret") or ""),
+        "scope": "https://management.azure.com/.default",
+    }).encode("utf-8")
+    url = "https://login.microsoftonline.com/" + str(cfg.get("tenant_id") or "") + "/oauth2/v2.0/token"
+    req = urllib.request.Request(url, data=data,
+                                 headers={"Content-Type": "application/x-www-form-urlencoded", "Accept": "application/json"},
+                                 method="POST")
+    with urllib.request.urlopen(req, timeout=60) as r:
+        tok = json.loads(r.read())
+    if not tok.get("access_token"):
+        raise Exception("Token request failed: " + json.dumps(tok))
+    return tok["access_token"]
+
+
+def _si_base():
+    cfg = _cfg()
+    for key in ("subscription_id", "resource_group", "workspace_name"):
+        if not str(cfg.get(key) or ""):
+            raise Exception(key + " is not set")
+    return ("https://management.azure.com/subscriptions/" + str(cfg["subscription_id"])
+            + "/resourceGroups/" + str(cfg["resource_group"])
+            + "/providers/Microsoft.OperationalInsights/workspaces/" + str(cfg["workspace_name"])
+            + "/providers/Microsoft.SecurityInsights")
+
+
+def request(method, path, params=None, body=None, token=None):
+    url = _si_base() + path
+    q = {k: str(x) for k, x in (params or {}).items() if x not in (None, "")}
+    q["api-version"] = API_VERSION
+    url += ("&" if "?" in url else "?") + urllib.parse.urlencode(q)
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Accept": "application/json", "Authorization": "Bearer " + (token or _token())}
+    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) as r:
+        raw = r.read()
+        return json.loads(raw) if raw else {}
+
+
+def main():
+    inputs = json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+    value = inputs.get("value")
+    pattern_type = inputs.get("pattern_type")
+    if not value:
+        raise Exception("value is required")
+    if not pattern_type:
+        raise Exception("pattern_type is required")
+
+    display_name = inputs.get("display_name") or value
+    threat_types_raw = inputs.get("threat_types")
+    if threat_types_raw:
+        threat_types = [t.strip() for t in str(threat_types_raw).split(",") if t.strip()]
+    else:
+        threat_types = ["malicious-activity"]
+    confidence = inputs.get("confidence")
+    valid_until = inputs.get("valid_until")
+
+    if str(pattern_type).startswith("file"):
+        pattern = "[" + str(pattern_type) + " = '" + str(value) + "']"
+    else:
+        pattern = "[" + str(pattern_type) + ":value = '" + str(value) + "']"
+
+    props = {
+        "pattern": pattern,
+        "patternType": pattern_type,
+        "displayName": display_name,
+        "threatTypes": threat_types,
+        "source": "Riposte",
+    }
+    if confidence is not None and confidence != "":
+        props["confidence"] = int(confidence)
+    if valid_until:
+        props["validUntil"] = valid_until
+
+    body = {"kind": "indicator", "properties": props}
+    res = request("POST", "/threatIntelligence/main/createIndicator", body=body)
+    print(json.dumps(res))
+
+
+try:
+    main()
+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)