Exporter les résultats

Les résultats d'analyse peuvent être téléchargés directement depuis l'application, exportés en CSV ou récupérés par programmation via l'API REST.

Téléchargement depuis la page de détail

Chaque analyse terminée dispose d'un bouton Télécharger dans l'en-tête de la page de détail. Cliquez dessus pour télécharger un rapport complet de cette analyse.

Export CSV depuis la page Analyses

Pour exporter un CSV couvrant votre historique d'analyses :

1. Accédez à Analyses dans la barre latérale
2. Cliquez sur Exporter en CSV en haut à droite de l'en-tête de la page (visible lorsque vous avez au moins une analyse terminée)

Le fichier CSV contient une ligne par contrôle avec les colonnes :

Colonne	Description
id	Identifiant du contrôle
title	Titre du contrôle
result	Réussi, Échoué ou Ignoré
severity	Critique, Élevé, Moyen ou Faible
framework	CIS, EIDSCA, CISA ou autre
helpUrl	Lien de référence
remediationSteps	Instructions de remédiation
rawOutput	Valeur brute détectée dans le tenant

Les fichiers CSV sont encodés en UTF-8.

Export via l'API

Vous pouvez récupérer les résultats par programmation via l'API REST. Cela permet la génération automatisée de rapports, l'intégration avec des systèmes de tickets ou l'alimentation d'un SIEM. L'accès API est disponible avec les abonnements Enterprise.

Obtenir tous les résultats d'une analyse

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

Renvoie une liste paginée de tous les résultats de contrôles. Consultez API Résultats pour la documentation complète.

Filtrer par statut

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

Filtrer par sévérité

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

Exemple Python : exporter tous les contrôles échoués en 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")

Exemple PowerShell : récupérer toutes les défaillances critiques

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

Rapports automatisés

Vous pouvez combiner l'API avec vos outils existants pour produire des rapports automatisés après chaque analyse :

• Webhook vers script - configurez une notification Teams ou par e-mail comme déclencheur, puis appelez l'API pour les derniers résultats d'analyse
• Script programmé - exécutez un script selon un calendrier qui récupère les derniers résultats et génère un rapport
• Intégration dans un pipeline CI/CD - récupérez les résultats après une analyse dans le cadre d'une étape de vérification de conformité

Consultez Intégrations pour plus d'exemples.