Guillaume BOURGEOIS
1949c98cf7
Sophos Central Endpoint API, 7 commands: list/get endpoints, isolate/de-isolate (containment), scan, list alerts. OAuth2 client-credentials + tenant discovery (whoami), stdlib-only. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
86 lines
3.0 KiB
Python
86 lines
3.0 KiB
Python
import json, os, sys, 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 _token(cfg):
|
|
form = urllib.parse.urlencode({
|
|
"grant_type": "client_credentials",
|
|
"client_id": str(cfg.get("client_id", "")),
|
|
"client_secret": str(cfg.get("client_secret", "")),
|
|
"scope": "token",
|
|
}).encode("utf-8")
|
|
req = urllib.request.Request("https://id.sophos.com/api/v2/oauth2/token", data=form,
|
|
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 _whoami(token):
|
|
req = urllib.request.Request("https://api.central.sophos.com/whoami/v1",
|
|
headers={"Authorization": "Bearer " + token, "Accept": "application/json"}, method="GET")
|
|
with urllib.request.urlopen(req, timeout=60) as r:
|
|
wi = json.loads(r.read())
|
|
tenant = wi.get("id")
|
|
region = (wi.get("apiHosts") or {}).get("dataRegion")
|
|
if not tenant or not region:
|
|
raise Exception("whoami failed: " + json.dumps(wi))
|
|
return tenant, region.rstrip("/")
|
|
|
|
|
|
def _ctx_auth(cfg):
|
|
token = _token(cfg)
|
|
tenant, region = _whoami(token)
|
|
return token, tenant, region
|
|
|
|
|
|
def request(method, path, token, tenant, region, body=None, params=None):
|
|
url = region + path
|
|
if params:
|
|
clean = {k: v for k, v in params.items() if v not in (None, "")}
|
|
if clean:
|
|
url += "?" + urllib.parse.urlencode(clean)
|
|
data = json.dumps(body).encode("utf-8") if body is not None else None
|
|
headers = {"Authorization": "Bearer " + token, "X-Tenant-ID": tenant, "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=90) as r:
|
|
raw = r.read()
|
|
return json.loads(raw) if raw else {}
|
|
|
|
|
|
def _run(fn):
|
|
try:
|
|
cfg = _cfg()
|
|
inputs = _inputs()
|
|
token, tenant, region = _ctx_auth(cfg)
|
|
print(json.dumps(fn(token, tenant, region, 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(token, tenant, region, inputs):
|
|
endpoint_id = inputs.get("endpoint_id")
|
|
if not endpoint_id:
|
|
raise Exception("endpoint_id is required")
|
|
q = lambda v: urllib.parse.quote(str(v), safe="")
|
|
return request("GET", "/endpoint/v1/endpoints/" + q(endpoint_id), token, tenant, region)
|
|
|
|
|
|
_run(main)
|