Sicherheitsscans

Sicherheitsübersicht abrufen

GET/v1/organization/security/overview

Ruft Scannerstatus und Befundübersicht für die gescannten IP-Adressen der Organisation ab.

curl --request GET \
  --url https://api.serverside.com/v1/organization/security/overview \
  --header 'Authorization: Bearer <api-key>'

{
  "success": true,
  "data": {
    "status": {
      "status": "UNKNOWN",
      "lastScan": "2026-01-15T09:30:00Z",
      "nextScan": "2026-01-15T09:30:00Z",
      "isScanRunning": true,
      "intervalSeconds": 123
    },
    "metadata": {
      "scanStarted": "2026-01-15T09:30:00Z",
      "scanFinished": "2026-01-15T09:30:00Z",
      "durationSeconds": 123
    },
    "summary": {
      "targetsWithFindings": 123,
      "totalFindings": 123,
      "openPorts": 123,
      "vulnerable": 123,
      "severityCounts": {
        "critical": 123,
        "high": 123,
        "medium": 123,
        "low": 123,
        "info": 123,
        "unknown": 123
      }
    },
    "targetCount": 123
  }
}

Autorisierung

Authorizationstringheadererforderlich
Organisations-API-Schlüssel (org_...), in der Cloud-Konsole unter https://cloud.serverside.com erstellt und einmal angezeigt, gesendet als Authorization: Bearer <key>. Authentifiziert als Organisation.

Erforderliche Berechtigung: organization.networking.read

Antwort

200 · application/json

OK

successbooleanerforderlich
Zulässige Werte:true
dataobject | nullerforderlich