Files
riposte-marketplace/integrations/sentinelone-sdl/scripts/add_note.py
T
Guillaume BOURGEOIS 70dffb3b0a feat: SentinelOne SDL + VirusTotal Hunting integrations
SentinelOne SDL (endpoint): Unified Alerts via the GraphQL API. Alert ingestion
(get_alerts) with rich filtering and an exhaustive OCSF mapper + 'SentinelOne SDL
Alert' default type, full alert details, update (status/verdict/assignee), add
note and trigger mitigation action. ApiToken auth; watermark converted to epoch
ms for the detectedAt filter; alert edges flattened to nodes for ingestion.

VirusTotal Hunting (enrichment, Premium): Livehunt notification-file ingestion
(livehunt_files) with an OCSF mapper + 'VirusTotal Hunting File' default type
(severity bucketed from malicious AV detections), Livehunt notifications listing,
and Retrohunt job + matching-file listing.

The core VT v3 reputation already ships as 'virustotal'; the XSOAR-feed and
Premium file-download/zip/pcap commands were intentionally left out.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-27 15:34:42 +02:00

51 lines
1.6 KiB
Python

import json, os, sys, urllib.request, urllib.parse, urllib.error
GRAPHQL = "/web/api/v2.1/unifiedalerts/graphql"
MUTATION = """
mutation AddNote($alertId: ID!, $text: String!) {
addAlertNote(alertId: $alertId, text: $text) {
data { id text createdAt author { userId fullName } }
}
}
"""
def _cfg():
s = json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
base = str(s.get("url") or "").rstrip("/")
headers = {"Authorization": "ApiToken " + s.get("api_token", ""), "Content-Type": "application/json", "Accept": "application/json"}
return base, headers
def _inputs():
return json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
def _graphql(query, variables):
base, headers = _cfg()
data = json.dumps({"query": query, "variables": variables}).encode("utf-8")
req = urllib.request.Request(base + GRAPHQL, data=data, headers=headers, method="POST")
with urllib.request.urlopen(req, timeout=90) as r:
raw = r.read()
resp = json.loads(raw) if raw else {}
if resp.get("errors"):
raise RuntimeError("GraphQL: " + "; ".join(e.get("message", str(e)) for e in resp["errors"]))
return resp
def run():
inp = _inputs()
resp = _graphql(MUTATION, {"alertId": inp.get("alert_id", ""), "text": inp.get("note_text", "")})
print(json.dumps(resp.get("data", {}).get("addAlertNote", {})))
try:
run()
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)