Izvoz rezultatov

Rezultate skeniranja lahko prenesete neposredno iz aplikacije, izvozite kot CSV ali programsko pridobite prek REST API.

Prenos s strani podrobnosti skeniranja

Vsako zaključeno skeniranje ima gumb Prenos v glavi strani s podrobnostmi skeniranja. Kliknite ga za prenos celotnega poročila o tem skeniranju.

Izvoz CSV s strani Skeniranja

Za izvoz CSV s celotno zgodovino skeniranja:

1. Pomaknite se do Skeniranja v stranski vrstici
2. Kliknite Izvozi CSV v zgornjem desnem kotu glave strani (vidno, ko imate vsaj eno zaključeno skeniranje)

Datoteka CSV vsebuje eno vrstico na preverjanje s stolpci:

Stolpec	Opis
id	Identifikator preverjanja
title	Naslov preverjanja
result	Passed, Failed ali Skipped
severity	Critical, High, Medium ali Low
framework	CIS, EIDSCA, CISA ali drugo
helpUrl	Referenčna povezava
remediationSteps	Navodila za odpravljanje
rawOutput	Surova vrednost, zaznana v najemniku

Datoteke CSV so kodirane kot UTF-8.

Izvoz prek API

Rezultate lahko programsko pridobite prek REST API. To omogoča avtomatizirano poročanje, integracijo s sistemi za upravljanje zahtevkov ali posredovanje rezultatov v SIEM. Dostop do API je na voljo pri naročniških paketih Enterprise.

Pridobitev vseh rezultatov za skeniranje

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

Vrne paginiran seznam vseh rezultatov preverjanj. Glejte API za rezultate za celotno dokumentacijo.

Filtriranje po statusu

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

Filtriranje po resnosti

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

Primer v Python: izvoz vseh neuspešnih preverjanj v 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")

Primer v PowerShell: pridobitev vseh kritičnih neuspehov

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

Avtomatizirano poročanje

API lahko kombinirate z obstoječimi orodji za izdelavo avtomatiziranih poročil po vsakem skeniranju:

• Webhook v skript - konfigurirajte Teams ali e-poštno obvestilo kot sprožilec, nato pokličite API za najnovejše rezultate skeniranja
• Načrtovan skript - zaženite skript po urniku, ki pridobi najnovejše rezultate in ustvari poročilo
• Integracija v CI/CD cevovod - pridobite rezultate po skeniranju kot del koraka preverjanja skladnosti

Glejte Integracije za več primerov.