Resultaten exporteren

Scanresultaten kunnen direct vanuit de app worden gedownload, als CSV worden geexporteerd of programmatisch via de REST API worden opgehaald.

Downloaden vanuit scandetail

Elke voltooide scan heeft een Download-knop in de header van de scandetailpagina. Klik erop om een volledig rapport van die scan te downloaden.

CSV-export vanuit de Scans-pagina

Om een CSV te exporteren van je scangeschiedenis:

1. Navigeer naar Scans in de zijbalk
2. Klik op CSV exporteren rechtsboven in de paginaheader (zichtbaar wanneer je minimaal een voltooide scan hebt)

Het CSV-bestand bevat een rij per controle met de volgende kolommen:

Kolom	Beschrijving
id	Controle-identificatie
title	Controletitel
result	Passed, Failed of Skipped
severity	Critical, High, Medium of Low
framework	CIS, EIDSCA, CISA of overig
helpUrl	Referentielink
remediationSteps	Hersteladvies
rawOutput	Ruwe waarde gedetecteerd in de tenant

CSV-bestanden zijn gecodeerd als UTF-8.

API-export

Je kunt resultaten programmatisch ophalen via de REST API. Dit maakt geautomatiseerde rapportage mogelijk, integratie met ticketsystemen of het invoeren van resultaten in een SIEM. API-toegang is beschikbaar bij Enterprise-abonnementen.

Alle resultaten voor een scan ophalen

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

Retourneert een gepagineerde lijst van alle controleresultaten. Zie Results API voor volledige documentatie.

Filteren op status

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

Filteren op ernstniveau

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

Python-voorbeeld: alle mislukte controles exporteren naar CSV

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-voorbeeld: alle kritieke fouten ophalen

$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"

Geautomatiseerde rapportage

Je kunt de API combineren met je bestaande tooling om geautomatiseerde rapporten te produceren na elke scan:

• Webhook naar script - configureer een Teams- of e-mailmelding als trigger en roep vervolgens de API aan voor de laatste scanresultaten
• Gepland script - voer een script uit op een schema dat de laatste resultaten ophaalt en een rapport genereert
• CI/CD-pipeline-integratie - haal resultaten op na een scan als onderdeel van een compliance-verificatiestap

Zie Integraties voor meer voorbeelden.