Ergebnisse exportieren

Scan-Ergebnisse können direkt aus der App heruntergeladen, als CSV exportiert oder programmgesteuert über die REST API abgerufen werden.

Download von der Scan-Detailseite

Jeder abgeschlossene Scan hat eine Download-Schaltfläche in der Kopfzeile der Scan-Detailseite. Klicken Sie darauf, um einen vollständigen Bericht dieses Scans herunterzuladen.

CSV-Export von der Scans-Seite

Um eine CSV-Datei Ihres Scan-Verlaufs zu exportieren:

1. Navigieren Sie zu Scans in der Seitenleiste
2. Klicken Sie auf CSV exportieren oben rechts in der Seitenkopfzeile (sichtbar, wenn Sie mindestens einen abgeschlossenen Scan haben)

Die CSV-Datei enthält eine Zeile pro Prüfung mit folgenden Spalten:

Spalte	Beschreibung
id	Prüfungskennung
title	Prüfungstitel
result	Bestanden, Fehlgeschlagen oder Übersprungen
severity	Kritisch, Hoch, Mittel oder Niedrig
framework	CIS, EIDSCA, CISA oder Andere
helpUrl	Referenzlink
remediationSteps	Behebungsanleitung
rawOutput	Im Tenant erkannter Rohwert

CSV-Dateien sind UTF-8-kodiert.

API-Export

Sie können Ergebnisse programmgesteuert über die REST API abrufen. Dies ermöglicht automatisierte Berichterstellung, Integration mit Ticketsystemen oder Einspeisung von Ergebnissen in ein SIEM. API-Zugriff ist in Enterprise-Plänen verfügbar.

Alle Ergebnisse eines Scans abrufen

curl https://api.aether365.io/scans/{scanId}/results \
  -H "Authorization: Bearer <api-key>"

Gibt eine paginierte Liste aller Prüfungsergebnisse zurück. Siehe Results API für die vollständige Dokumentation.

Nach Status filtern

curl "https://api.aether365.io/scans/{scanId}/results?result=Failed" \
  -H "Authorization: Bearer <api-key>"

Nach Schweregrad filtern

curl "https://api.aether365.io/scans/{scanId}/results?severity=Critical" \
  -H "Authorization: Bearer <api-key>"

Python-Beispiel: Alle fehlgeschlagenen Prüfungen als CSV exportieren

import requests
import csv

API_KEY = "your-api-key"
SCAN_ID = "your-scan-id"

headers = {"Authorization": f"Bearer {API_KEY}"}
results = []
page = 1

while True:
    resp = requests.get(
        f"https://api.aether365.io/scans/{SCAN_ID}/results",
        params={"result": "Failed", "page": page, "limit": 100},
        headers=headers,
    )
    data = resp.json()
    results.extend(data["data"])
    if page >= data["meta"]["totalPages"]:
        break
    page += 1

with open("failed_checks.csv", "w", newline="") as f:
    writer = csv.DictWriter(
        f, fieldnames=["id", "title", "severity", "framework", "remediationSteps"]
    )
    writer.writeheader()
    writer.writerows(results)

print(f"Exported {len(results)} failed checks")

PowerShell-Beispiel: Alle kritischen Fehler abrufen

$headers = @{ Authorization = "Bearer $env:AETHER365_API_KEY" }
$scanId = "your-scan-id"
$page = 1
$results = @()

do {
    $response = Invoke-RestMethod `
        -Uri "https://api.aether365.io/scans/$scanId/results?result=Failed&severity=Critical&page=$page&limit=100" `
        -Headers $headers
    $results += $response.data
    $page++
} while ($page -le $response.meta.totalPages)

$results | Export-Csv -Path "critical_failures.csv" -NoTypeInformation
Write-Host "Exported $($results.Count) critical failures"

Automatisierte Berichterstellung

Sie können die API mit Ihren vorhandenen Tools kombinieren, um nach jedem Scan automatisierte Berichte zu erstellen:

• Webhook zu Skript - konfigurieren Sie eine Teams- oder E-Mail-Benachrichtigung als Auslöser und rufen Sie dann die API für die neuesten Scan-Ergebnisse auf
• Geplantes Skript - führen Sie ein Skript nach Zeitplan aus, das die neuesten Ergebnisse abruft und einen Bericht erstellt
• CI/CD-Pipeline-Integration - rufen Sie Ergebnisse nach einem Scan als Teil eines Compliance-Überprüfungsschritts ab

Siehe Integrationen für weitere Beispiele.