Exportación de resultados

Los resultados de los análisis se pueden descargar directamente desde la aplicación, exportar como CSV o recuperar programaticamente mediante la API REST.

Descarga desde el detalle del análisis

Cada análisis completado tiene un botón Download en la cabecera de la página de detalle del análisis. Haz clic en el para descargar un informe completo de ese análisis.

Exportación CSV desde la página Scans

Para exportar un CSV con tu historial de análisis:

1. Navega a Scans en la barra lateral
2. Haz clic en Export CSV en la esquina superior derecha de la cabecera de la página (visible cuando tienes al menos un análisis completado)

El archivo CSV contiene una fila por comprobación con las siguientes columnas:

Columna	Descripción
id	Identificador de la comprobación
title	Título de la comprobación
result	Passed, Failed o Skipped
severity	Critical, High, Medium o Low
framework	CIS, EIDSCA, CISA u otro
helpUrl	Enlace de referencia
remediationSteps	Orientación de corrección
rawOutput	Valor en bruto detectado en el tenant

Los archivos CSV están codificados en UTF-8.

Exportación mediante la API

Puedes recuperar los resultados programaticamente usando la API REST. Esto permite generar informes automatizados, integrar con sistemas de tickets o alimentar un SIEM con los resultados. El acceso a la API está disponible en los planes Enterprise.

Obtener todos los resultados de un análisis

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

Devuelve una lista paginada de todos los resultados de comprobaciones. Consulta la API de Results para la documentación completa.

Filtrar por estado

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

Filtrar por severidad

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

Ejemplo en Python: exportar todas las comprobaciones fallidas a 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")

Ejemplo en PowerShell: obtener todos los fallos críticos

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

Informes automatizados

Puedes combinar la API con tus herramientas existentes para generar informes automatizados después de cada análisis:

• Webhook a script - configura una notificación de Teams o correo electrónico como disparador, y luego llama a la API para obtener los últimos resultados del análisis
• Script programado - ejecuta un script de forma periódica que recupere los últimos resultados y genere un informe
• Integración con pipelines CI/CD - recupera los resultados después de un análisis como parte de un paso de verificación de compliance

Consulta Integraciones para más ejemplos.