Export výsledků

Výsledky skenů lze stáhnout přímo z aplikace, exportovat jako CSV nebo získat programově přes REST API.

Stažení z detailu skenu

Každý dokončený sken má tlačítko Stáhnout v hlavičce stránky detailu skenu. Kliknutím stáhnete úplný report daného skenu.

Export CSV ze stránky Skeny

Export CSV pokrývající historii skenů:

1. Přejděte na Skeny v postranním panelu
2. Klikněte na Export CSV v pravém horním rohu hlavičky stránky (viditelné, když máte alespoň jeden dokončený sken)

Soubor CSV obsahuje jeden řádek na kontrolu se sloupci:

Sloupec	Popis
id	Identifikátor kontroly
title	Název kontroly
result	Passed, Failed nebo Skipped
severity	Critical, High, Medium nebo Low
framework	CIS, EIDSCA, CISA nebo jiný
helpUrl	Odkaz na referenci
remediationSteps	Pokyny k nápravě
rawOutput	Nezpracovaná hodnota zjištěná v tenantu

Soubory CSV jsou kódovány jako UTF-8.

Export přes API

Výsledky můžete získat programově pomocí REST API. To umožňuje automatizovaný reporting, integraci s ticketovacími systémy nebo přenos výsledků do SIEM. Přístup k API je dostupný v tarifu Enterprise.

Získání všech výsledků skenu

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

Vrací stránkovaný seznam všech výsledků kontrol. Úplnou dokumentaci viz Results API.

Filtrování podle stavu

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

Filtrování podle závažnosti

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

Příklad v Pythonu: export všech neúspěšných kontrol do 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")

Příklad v PowerShellu: načtení všech kritických selhání

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

Automatizovaný reporting

API můžete kombinovat se stávajícími nástroji pro automatické generování reportů po každém skenu:

• Webhook do skriptu - nakonfigurujte notifikaci Teams nebo e-mailem jako trigger, poté zavolejte API pro nejnovější výsledky skenu
• Plánovaný skript - spouštějte skript podle plánu, který získá nejnovější výsledky a vygeneruje report
• Integrace do CI/CD pipeline - získejte výsledky po skenu jako součást kroku ověření compliance

Viz Integrace pro další příklady.