Exportarea rezultatelor

Rezultatele scanărilor pot fi descărcate direct din aplicație, exportate ca CSV sau preluate programatic prin API-ul REST.

Descărcare din detaliile scanării

Fiecare scanare finalizată are un buton Download în antetul paginii de detalii a scanării. Faceți clic pe el pentru a descărca un raport complet al acelei scanări.

Export CSV din pagina Scans

Pentru a exporta un CSV acoperind istoricul scanărilor:

1. Navigați la Scans în bara laterală
2. Faceți clic pe Export CSV în colțul din dreapta sus al antetului paginii (vizibil când aveți cel puțin o scanare finalizată)

Fișierul CSV conține un rând per verificare cu coloanele:

Coloană	Descriere
id	Identificatorul verificării
title	Titlul verificării
result	Passed, Failed sau Skipped
severity	Critical, High, Medium sau Low
framework	CIS, EIDSCA, CISA sau alt framework
helpUrl	Link de referință
remediationSteps	Ghidaj de remediere
rawOutput	Valoarea brută detectată în tenant

Fișierele CSV sunt codificate în UTF-8.

Export prin API

Puteți prelua rezultatele programatic folosind API-ul REST. Aceasta permite raportare automatizată, integrare cu sisteme de ticketing sau alimentarea rezultatelor într-un SIEM. Accesul API este disponibil pe planurile Enterprise.

Obținerea tuturor rezultatelor unei scanări

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

Returnează o listă paginată a tuturor rezultatelor verificărilor. Consultați API Rezultate pentru documentația completă.

Filtrare pe status

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

Filtrare pe severitate

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

Exemplu Python: export verificări eșuate în 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")

Exemplu PowerShell: obținerea tuturor eșecurilor critice

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

Raportare automatizată

Puteți combina API-ul cu instrumentele existente pentru a produce rapoarte automate după fiecare scanare:

• Webhook la script - configurați o notificare Teams sau email ca declanșator, apoi apelați API-ul pentru cele mai recente rezultate de scanare
• Script programat - rulați un script pe un program care preia cele mai recente rezultate și generează un raport
• Integrare pipeline CI/CD - preluați rezultatele după o scanare ca parte a unui pas de verificare a conformității

Consultați Integrări pentru mai multe exemple.