Експортиране на резултати

Резултатите от сканирания могат да бъдат изтеглени директно от приложението, експортирани като CSV или извлечени програмно чрез REST API.

Изтегляне от детайлите на сканирането

Всяко завършено сканиране има бутон Download в заглавната част на страницата с детайли. Натиснете го, за да изтеглите пълен отчет от това сканиране.

CSV експорт от страницата Scans

За експорт на CSV, обхващащ историята на сканиранията ви:

1. Навигирайте до Scans в страничната лента
2. Натиснете Export CSV в горния десен ъгъл на заглавната част (видим при поне едно завършено сканиране)

CSV файлът съдържа по един ред за всяка проверка с колони:

Колона	Описание
id	Идентификатор на проверката
title	Заглавие на проверката
result	Passed, Failed или Skipped
severity	Critical, High, Medium или Low
framework	CIS, EIDSCA, CISA или друга
helpUrl	Референтен линк
remediationSteps	Насоки за коригиране
rawOutput	Необработена стойност от tenant-а

CSV файловете са кодирани в UTF-8.

Експорт чрез API

Можете да извличате резултати програмно чрез REST API. Това позволява автоматизирано отчитане, интеграция с тикет системи или подаване на резултати към SIEM. Достъпът до API е наличен в плановете Enterprise.

Извличане на всички резултати за сканиране

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

Връща странициран списък с всички резултати от проверки. Вижте API за резултати за пълна документация.

Филтриране по статус

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

Филтриране по критичност

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

Python пример: експорт на всички неуспешни проверки в 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 пример: извличане на всички критични неуспехи

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

Автоматизирано отчитане

Можете да комбинирате API с вашите съществуващи инструменти за създаване на автоматизирани отчети след всяко сканиране:

• Webhook към скрипт - конфигурирайте Teams или имейл известие като тригер, след което извикайте API за последните резултати от сканиране
• Планиран скрипт - изпълнявайте скрипт по график, който извлича последните резултати и генерира отчет
• Интеграция с CI/CD - извличайте резултати след сканиране като част от стъпка за проверка на compliance

Вижте Интеграции за повече примери.