Export výsledkov

Výsledky skenov je možné stiahnuť priamo z aplikácie, exportovať ako CSV alebo programovo získať cez REST API.

Stiahnutie z detailu skenu

Každý dokončený sken má tlačidlo Download v hlavičke stránky s detailom skenu. Kliknutím stiahnete úplnú správu tohto skenu.

CSV export zo stránky Scans

Pre export CSV pokrývajúceho vašu históriu skenov:

1. Prejdite na Scans v bočnom paneli
2. Kliknite na Export CSV v pravom hornom rohu hlavičky stránky (viditeľné, keď máte aspoň jeden dokončený sken)

CSV súbor obsahuje jeden riadok na kontrolu so stĺpcami:

Stĺpec	Popis
id	Identifikátor kontroly
title	Názov kontroly
result	Passed, Failed alebo Skipped
severity	Critical, High, Medium alebo Low
framework	CIS, EIDSCA, CISA alebo iný
helpUrl	Referenčný odkaz
remediationSteps	Pokyny na nápravu
rawOutput	Surová hodnota detegovaná v tenante

CSV súbory sú kódované ako UTF-8.

Export cez API

Výsledky môžete programovo získavať pomocou REST API. To umožňuje automatizovaný reporting, integráciu s ticketovými systémami alebo posielanie výsledkov do SIEM. Prístup cez API je dostupný na plánoch Enterprise.

Získanie všetkých výsledkov pre sken

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

Vracia stránkovaný zoznam všetkých výsledkov kontrol. Pozrite Results API pre úplnú dokumentáciu.

Filtrovanie podľa stavu

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

Filtrovanie podľa závažnosti

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

Príklad v Pythone: export všetkých neúspeš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")

Príklad v PowerShell: získanie všetkých kritických zlyhaní

$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 kombinovať s vašimi existujúcimi nástrojmi na tvorbu automatizovaných správ po každom skene:

• Webhook k skriptu - nakonfigurujte Teams alebo e-mailovú notifikáciu ako spúšťač, potom zavolajte API pre najnovšie výsledky skenu
• Plánovaný skript - spúšťajte skript podľa harmonogramu, ktorý získava najnovšie výsledky a generuje správu
• Integrácia do CI/CD pipeline - získajte výsledky po skene ako súčasť kroku overenia compliance

Pozrite Integrácie pre ďalšie príklady.