Skip to content

Eksporter resultater

Scanningsresultater kan downloades direkte fra appen, eksporteres som CSV eller hentes programmatisk via REST API'et.

Download fra scanningsdetaljer

Hver færdig scanning har en Download-knap i overskriften på scanningsdetaljesiden. Klik for at downloade en komplet rapport for den scanning.

CSV-eksport fra Scanningssiden

Sådan eksporterer du en CSV, der dækker din scanningshistorik:

  1. Naviger til Scanninger i sidebjælken
  2. Klik på Eksporter CSV øverst til højre i sideoverskriften (synlig, når du har mindst en færdig scanning)

CSV-filen indeholder en række per kontrol med kolonner:

KolonneBeskrivelse
idKontrolidentifikator
titleKontroltitel
resultPassed, Failed eller Skipped
severityCritical, High, Medium eller Low
frameworkCIS, EIDSCA, CISA eller anden
helpUrlReferencelink
remediationStepsUdbedringsanvisning
rawOutputRå værdi fundet i tenanten

CSV-filer er kodet som UTF-8.

API-eksport

Du kan hente resultater programmatisk ved hjælp af REST API'et. Dette muliggør automatiseret rapportering, integration med ticket-systemer eller indføring af resultater i en SIEM. API-adgang er tilgængelig på Enterprise-planer.

Hent alle resultater for en scanning

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

Returnerer en pagineret liste over alle kontrolresultater. Se Resultater API for fuld dokumentation.

Filtrer efter status

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

Filtrer efter alvorlighed

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

Python-eksempel: eksporter alle fejlede kontroller til CSV

python
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-eksempel: hent alle kritiske fejl

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

Automatiseret rapportering

Du kan kombinere API'et med dit eksisterende værktøj til at producere automatiserede rapporter efter hver scanning:

  • Webhook til script - konfigurer en Teams- eller e-mailnotifikation som trigger, og kald derefter API'et for de seneste scanningsresultater
  • Planlagt script - kør et script efter en tidsplan, der henter de seneste resultater og genererer en rapport
  • CI/CD-pipeline-integration - hent resultater efter en scanning som del af et compliance-verifikationstrin

Se Integrationer for flere eksempler.

Var denne side nyttig?