Exportera resultat
Skanningsresultat kan laddas ner direkt från appen, exporteras som CSV eller hämtas programmatiskt via REST API.
Ladda ner från skanningsdetaljer
Varje slutförd skanning har en Ladda ner-knapp i sidhuvudet på skanningsdetaljsidan. Klicka på den för att ladda ner en fullständig rapport av den skanningen.
CSV-export från Skanningssidan
För att exportera en CSV som täcker din skanningshistorik:
- Navigera till Skanningar i sidomenyn
- Klicka på Exportera CSV uppe till höger i sidans sidhuvud (synlig när du har minst en slutförd skanning)
CSV-filen innehåller en rad per kontroll med kolumner:
| Kolumn | Beskrivning |
|---|---|
id | Kontrollidentifierare |
title | Kontrolltitel |
result | Passed, Failed eller Skipped |
severity | Critical, High, Medium eller Low |
framework | CIS, EIDSCA, CISA eller other |
helpUrl | Referenslänk |
remediationSteps | Åtgärdsvägledning |
rawOutput | Råvärde som detekterades i tenanten |
CSV-filer kodas som UTF-8.
API-export
Du kan hämta resultat programmatiskt med REST API. Detta möjliggör automatiserad rapportering, integration med ärendehanteringssystem eller matning av resultat till en SIEM. API-åtkomst finns tillgänglig på Enterprise-planer.
Hämta alla resultat för en skanning
bash
curl https://api.aether365.io/scans/{scanId}/results \
-H "Authorization: Bearer <api-key>"Returnerar en paginerad lista med alla kontrollresultat. Se Results API för fullständig dokumentation.
Filtrera efter status
bash
curl "https://api.aether365.io/scans/{scanId}/results?result=Failed" \
-H "Authorization: Bearer <api-key>"Filtrera efter allvarlighet
bash
curl "https://api.aether365.io/scans/{scanId}/results?severity=Critical" \
-H "Authorization: Bearer <api-key>"Python-exempel: exportera alla underkända kontroller till 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-exempel: hämta alla kritiska underkända
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"Automatiserad rapportering
Du kan kombinera API:et med dina befintliga verktyg för att producera automatiserade rapporter efter varje skanning:
- Webhook till skript - konfigurera en Teams- eller e-postavisering som trigger, anropa sedan API:et för senaste skanningsresultat
- Schemalagt skript - kör ett skript enligt schema som hämtar senaste resultaten och genererar en rapport
- CI/CD-pipelineintegration - hämta resultat efter en skanning som del av ett compliance-verifieringssteg
Se Integrationer för fler exempel.