Rezultatų eksportavimas

Nuskaitymo rezultatus galima atsisiųsti tiesiogiai iš programos, eksportuoti kaip CSV arba gauti programiškai per REST API.

Atsisiuntimas iš nuskaitymo detalių

Kiekvienas užbaigtas nuskaitymas turi Atsisiųsti mygtuką nuskaitymo detalių puslapio antraštėje. Spustelėkite jį, kad atsisiųstumėte pilną to nuskaitymo ataskaitą.

CSV eksportas iš Nuskaitymų puslapio

Norėdami eksportuoti CSV su nuskaitymų istorija:

1. Pereikite į Nuskaitymai šoninėje juostoje
2. Spustelėkite Eksportuoti CSV puslapio antraštės viršutiniame dešiniajame kampe (matoma, kai turite bent vieną užbaigtą nuskaitymą)

CSV failas turi vieną eilutę kiekvienam patikrinimui su stulpeliais:

Stulpelis	Aprašymas
id	Patikrinimo identifikatorius
title	Patikrinimo pavadinimas
result	Passed, Failed arba Skipped
severity	Critical, High, Medium arba Low
framework	CIS, EIDSCA, CISA arba kita
helpUrl	Nuorodos nuoroda
remediationSteps	Ištaisymo nurodymai
rawOutput	Neapdorota reikšmė, aptikta organizacijoje

CSV failai koduojami UTF-8.

API eksportas

Rezultatus galite gauti programiškai naudodami REST API. Tai įgalina automatizuotą ataskaitų teikimą, integraciją su bilietų sistemomis arba rezultatų tiekimą į SIEM. API prieiga prieinama Enterprise planuose.

Visų nuskaitymo rezultatų gavimas

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

Grąžina puslapiais pateikiamą visų patikrinimų rezultatų sąrašą. Žr. Rezultatų API pilnai dokumentacijai.

Filtravimas pagal būseną

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

Filtravimas pagal rimtumą

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

Python pavyzdys: visų neįveiktų patikrinimų eksportas į 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")

PowerShell pavyzdys: visų kritinių nesėkmių gavimas

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

Automatizuotas ataskaitų teikimas

Galite derinti API su savo esamais įrankiais automatizuotoms ataskaitoms po kiekvieno nuskaitymo:

• Webhook prie scenarijaus - sukonfigūruokite Teams ar el. pašto pranešimą kaip paleidiklį, tada iškvieskite API naujausiems nuskaitymo rezultatams
• Suplanuotas scenarijus - vykdykite scenarijų pagal grafiką, kuris gauna naujausius rezultatus ir generuoja ataskaitą
• CI/CD vamzdyno integracija - gaukite rezultatus po nuskaitymo kaip atitikties tikrinimo žingsnio dalį

Žr. Integracijos daugiau pavyzdžių.