Results API

Betreut von: Aether365 Team Zielgruppe: Entwickler Umfang: Results API-Endpunkte - Scan-Befunde abrufen

Scan-Ergebnisse abrufen

Gibt die einzelnen Prüfungsergebnisse für einen abgeschlossenen Scan zurück.

GET /scans/{scanId}/results

Abfrageparameter

Parameter	Typ	Beschreibung
page	integer	Seitennummer (Standard: 1)
limit	integer	Ergebnisse pro Seite (Standard: 50, Maximum: 200)
result	string	Filter: passed, failed, skipped
severity	string	Filter: critical, high, medium, low
framework	string	Nach Framework filtern: cis, eidsca, cisa, nis2

Beispielanfrage

curl "https://api.aether365.io/scans/scan_abc123/results?result=failed&severity=critical" \
  -H "Authorization: Bearer <token>"

Beispielantwort

{
  "success": true,
  "data": [
    {
      "id": "result_001",
      "scan_id": "scan_abc123",
      "test_id": "CIS.M365.1.1.1",
      "title": "Ensure multifactor authentication is enabled for all users in administrative roles",
      "result": "failed",
      "severity": "critical",
      "framework": "cis",
      "help_url": "https://www.cisecurity.org/benchmark/microsoft_365",
      "remediation_steps": "1. Sign in to the Azure portal...",
      "source_tool": "compliance"
    }
  ],
  "meta": {
    "total": 12,
    "page": 1,
    "limit": 50
  }
}

---

Einzelnes Ergebnis abrufen

Gibt das Detail eines einzelnen Prüfungsergebnisses zurück.

GET /scans/{scanId}/results/{testId}

Beispielanfrage

curl https://api.aether365.io/scans/scan_abc123/results/CIS.M365.1.1.1 \
  -H "Authorization: Bearer <token>"

Beispielantwort

{
  "success": true,
  "data": {
    "id": "result_001",
    "scan_id": "scan_abc123",
    "test_id": "CIS.M365.1.1.1",
    "title": "Ensure multifactor authentication is enabled for all users in administrative roles",
    "result": "failed",
    "severity": "critical",
    "framework": "cis",
    "help_url": "https://www.cisecurity.org/benchmark/microsoft_365",
    "remediation_steps": "1. Sign in to the Azure portal as a Global Administrator.\n2. Navigate to Microsoft Entra ID > Security > Conditional Access.\n3. Create or update a policy requiring MFA for all administrator roles.",
    "raw_output": {},
    "source_tool": "compliance"
  }
}

Feldreferenz

Feld	Typ	Beschreibung
test_id	string	Eindeutige Prüfungskennung (z.B. CIS.M365.1.1.1)
title	string	Menschenlesbarer Prüfungsname
result	string	passed, failed oder skipped
severity	string	critical, high, medium oder low
framework	string	Framework, das diese Prüfung definiert (cis, eidsca, cisa, nis2)
help_url	string	Link zur offiziellen Dokumentation oder Benchmark-Referenz
remediation_steps	string	Schritt-für-Schritt-Korrekturanweisungen
source_tool	string	Scan-Engine-Typ (compliance oder exposure)
raw_output	object	Rohe Bewertungsausgabe (kann bei einigen Prüfungen null sein)