Eredmények exportálása

A vizsgálati eredmények közvetlenül letölthetők az alkalmazásból, exportálhatók CSV-be, vagy programozottan lekérdezhetők a REST API-n keresztül.

Letöltés a vizsgálat részletoldalról

Minden befejezett vizsgálatnál található egy Letöltés gomb a vizsgálat részletoldal fejlécében. Kattints rá a vizsgálat teljes jelentésének letöltéséhez.

CSV export a Vizsgálatok oldalról

CSV export a vizsgálati előzményeidről:

1. Navigálj a Vizsgálatok menüpontra az oldalsávban
2. Kattints az Export CSV gombra az oldalfejléc jobb felső sarkában (látható, ha legalább egy befejezett vizsgálatod van)

A CSV fájl soronként tartalmaz egy ellenőrzést a következő oszlopokkal:

Oszlop	Leírás
id	Ellenőrzés azonosító
title	Ellenőrzés címe
result	Sikeres, Sikertelen vagy Kihagyott
severity	Kritikus, Magas, Közepes vagy Alacsony
framework	CIS, EIDSCA, CISA vagy egyéb
helpUrl	Hivatkozási hivatkozás
remediationSteps	Javítási útmutatás
rawOutput	A bérlőben észlelt nyers érték

A CSV fájlok UTF-8 kódolásúak.

API export

Az eredmények programozottan is lekérdezhetők a REST API-n keresztül. Ez lehetővé teszi az automatikus jelentéskészítést, integrációt jegykezelő rendszerekkel vagy az eredmények SIEM-be való betáplálását. Az API hozzáférés az Enterprise csomagban érhető el.

Összes eredmény lekérdezés egy vizsgálathoz

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

Lapozható listát ad vissza az összes ellenőrzési eredménnyel. A teljes dokumentáció: Results API.

Szűrés állapot szerint

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

Szűrés súlyosság szerint

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

Python példa: összes sikertelen ellenőrzés exportálása CSV-be

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 példa: összes kritikus sikertelen elem lekérdezése

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

Automatikus jelentéskészítés

Az API-t kombinálhatod a meglévő eszközeidel automatikus jelentések készítéséhez minden vizsgálat után:

• Webhook szkriptbe - állíts be Teams vagy e-mail értesítést indítóként, majd hívd meg az API-t a legutóbbi vizsgálati eredményekért
• Ütemezett szkript - futtass egy szkriptet ütemezve, amely lekérdezi a legutóbbi eredményeket és jelentést készít
• CI/CD pipeline integráció - kérdezd le az eredményeket egy vizsgálat után egy megfelelőség-ellenőrzési lépés részeként

Lásd: Integrációk további példákért.