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:
- Naviger til Scanninger i sidebjælken
- 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:
| Kolonne | Beskrivelse |
|---|---|
id | Kontrolidentifikator |
title | Kontroltitel |
result | Passed, Failed eller Skipped |
severity | Critical, High, Medium eller Low |
framework | CIS, EIDSCA, CISA eller anden |
helpUrl | Referencelink |
remediationSteps | Udbedringsanvisning |
rawOutput | Rå 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.