Tulemuste eksportimine

Skaneerimistulemusi saab alla laadida otse rakendusest, eksportida CSV-na või programmiliselt kätte saada REST API kaudu.

Allalaadimine skaneerimise üksikasjade lehelt

Igal lõppenud skaneerimise üksikasjade lehel on päises nupp Laadi alla. Klõpsake seda selle skaneerimise täisaruande allalaadimiseks.

CSV eksport lehelt Skaneerimised

Skaneerimiste ajaloo katva CSV eksportimiseks:

1. Navigeerige külgribal jaotisesse Skaneerimised
2. Klõpsake lehe päise paremas ülanurgas Ekspordi CSV (nähtav, kui teil on vähemalt üks lõppenud skaneerimine)

CSV fail sisaldab ühte rida kontrolli kohta järgmiste veergudega:

Veerg	Kirjeldus
id	Kontrolli identifikaator
title	Kontrolli pealkiri
result	Passed, Failed või Skipped
severity	Critical, High, Medium või Low
framework	CIS, EIDSCA, CISA või muu
helpUrl	Viitelink
remediationSteps	Parandusjuhised
rawOutput	Halduskeskkonnas tuvastatud tööväärtus

CSV failid on kodeeritud UTF-8-na.

API eksport

Tulemusi saab programmiliselt kätte saada REST API kaudu. See võimaldab automaatset aruandlust, integreerimist piletisüsteemidega või tulemuste suunamist SIEM-i. API juurdepääs on saadaval Enterprise plaanidel.

Kõigi skaneerimistulemuste kättesaamine

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

Tagastab lehekülgedeks jaotatud loetelu kõigist kontrollitulemustest. Vaadake Tulemuste API täieliku dokumentatsiooni jaoks.

Filtreerimine oleku järgi

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

Filtreerimine tõsiduse järgi

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

Python näide: kõigi ebaõnnestunud kontrollide eksportimine CSV-sse

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 näide: kõigi kriitiliste ebaõnnestumiste kättesaamine

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

Automaatne aruandlus

Saate kombineerida API-t oma olemasoleva tööriistaga automaatsete aruannete koostamiseks pärast iga skaneerimist:

• Webhookist skripti - seadistage Teams või e-posti teavitus käivitajana, seejärel pöörduge API poole viimaste skaneerimistulemuste saamiseks
• Ajastatud skript - käivitage skript ajakava alusel, mis saab viimased tulemused ja koostab aruande
• CI/CD pipeline integratsioon - saage tulemused pärast skaneerimist vastavuse kontrollimise sammuna

Vaadake Integratsioonid rohkemate näidete jaoks.