Tulosten vieminen

Skannaustulokset voidaan ladata suoraan sovelluksesta, vieda CSV-muodossa tai hakea ohjelmallisesti REST API:n kautta.

Lataus skannaustietosivulta

Jokaisessa valmistuneessa skannauksessa on Lataa-painike skannaustietosivun ylatunnisteessa. Napsauta sitä ladataksesi skannauksen tayden raportin.

CSV-vienti Skannaukset-sivulta

CSV-viedaksesi skannaushistoriasi:

1. Siirry Skannaukset-sivulle sivupalkista
2. Napsauta Vie CSV sivun ylatunnisteen oikeassa reunassa (nakyy kun sinulla on vahintaan yksi valmistunut skannaus)

CSV-tiedosto sisaltaa yhden rivin per tarkistus seuraavilla sarakkeilla:

Sarake	Kuvaus
id	Tarkistuksen tunniste
title	Tarkistuksen otsikko
result	Passed, Failed tai Skipped
severity	Critical, High, Medium tai Low
framework	CIS, EIDSCA, CISA tai muu
helpUrl	Viitelinkki
remediationSteps	Korjausohjeet
rawOutput	Vuokralaisesta havaittu raaka-arvo

CSV-tiedostot ovat UTF-8-koodattuja.

API-vienti

Voit hakea tuloksia ohjelmallisesti REST API:n kautta. Tama mahdollistaa automatisoidun raportoinnin, integraation tikettijärjestelmiin tai tulosten syottamisen SIEM-jarjestelmaan. API-kayttooikeus on saatavilla Enterprise-suunnitelmissa.

Hae kaikki skannauksen tulokset

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

Palauttaa sivutetun luettelon kaikista tarkistustuloksista. Katso Tulokset-API taytta dokumentaatiota varten.

Suodata tilan mukaan

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

Suodata vakavuuden mukaan

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

Python-esimerkki: vie kaikki hylatyt tarkistukset CSV:ksi

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-esimerkki: hae kaikki kriittiset hylkaykset

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

Automatisoitu raportointi

Voit yhdistaa API:n olemassa oleviin tyokaluihisi automatisoidun raportoinnin tuottamiseksi jokaisen skannauksen jalkeen:

• Webhook komentosarjaan - maaritä Teams- tai sahkoposti-ilmoitus laukaisimeksi, kutsu sitten API viimeisimpia skannaustuloksia varten
• Ajoitettu komentosarja - suorita komentosarja aikataulun mukaan, joka hakee viimeisimmat tulokset ja tuottaa raportin
• CI/CD-putkiston integraatio - hae tulokset skannauksen jalkeen osana vaatimustenmukaisuuden tarkistusvaihetta

Katso Integraatiot lisaa esimerkkeja varten.