Exportar Resultados

Os resultados de análise podem ser transferidos diretamente a partir da aplicação, exportados como CSV ou obtidos programaticamente através da API REST.

Transferir a partir do detalhe da análise

Cada análise concluída tem um botão Transferir no cabecalho da página de detalhe da análise. Clique nele para transferir um relatório completo dessa análise.

Exportação CSV a partir da página de Análises

Para exportar um CSV abrangendo o seu histórico de análises:

1. Navegue até Análises na barra lateral
2. Clique em Exportar CSV no canto superior direito do cabecalho da página (visível quando tem pelo menos uma análise concluída)

O ficheiro CSV contem uma linha por verificação com as colunas:

Coluna	Descrição
id	Identificador da verificação
title	Título da verificação
result	Passed, Failed ou Skipped
severity	Critical, High, Medium ou Low
framework	CIS, EIDSCA, CISA ou other
helpUrl	Ligação de referência
remediationSteps	Orientações de remediação
rawOutput	Valor bruto detetado no tenant

Os ficheiros CSV estão codificados em UTF-8.

Exportação via API

Pode obter resultados programaticamente utilizando a API REST. Isto permite relatórios automatizados, integração com sistemas de tickets ou alimentar resultados num SIEM. O acesso via API está disponível nos planos Enterprise.

Obter todos os resultados de uma análise

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

Devolve uma lista paginada de todos os resultados de verificação. Consulte a API de Resultados para documentação completa.

Filtrar por estado

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

Filtrar por gravidade

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

Exemplo Python: exportar todas as verificações reprovadas para 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")

Exemplo PowerShell: obter todas as falhas críticas

$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 "crítical_failures.csv" -NoTypeInformation
Write-Host "Exported $($results.Count) crítical failures"

Relatórios automatizados

Pode combinar a API com as suas ferramentas existentes para produzir relatórios automatizados após cada análise:

• Webhook para script - configure uma notificação do Teams ou email como acionador, depois chame a API para obter os resultados da análise mais recente
• Script agendado - execute um script num agendamento que obtem os resultados mais recentes e gera um relatório
• Integração com pipeline CI/CD - obtenha resultados após uma análise como parte de um passo de verificação de conformidade

Consulte Integrações para mais exemplos.