Resultat-API

Underhålls av: Aether365 Team Målgrupp: Utvecklare Omfattning: Resultat-API-endpoints - hämta skanningsfynd

Hämta skanningsresultat

Returnerar individuella kontrollresultat för en slutförd skanning.

GET /scans/{scanId}/results

Frågeparametrar

Parameter	Typ	Beskrivning
page	integer	Sidnummer (standard: 1)
limit	integer	Resultat per sida (standard: 50, max: 200)
result	string	Filter: passed, failed, skipped
severity	string	Filter: critical, high, medium, low
framework	string	Filtrera efter ramverk: cis, eidsca, cisa, nis2

Exempelbegäran

curl "https://api.aether365.io/scans/scan_abc123/results?result=failed&severity=critical" \
  -H "Authorization: Bearer <token>"

Exempelsvar

{
  "success": true,
  "data": [
    {
      "id": "result_001",
      "scan_id": "scan_abc123",
      "test_id": "CIS.M365.1.1.1",
      "title": "Ensure multifactor authentication is enabled for all users in administrative roles",
      "result": "failed",
      "severity": "critical",
      "framework": "cis",
      "help_url": "https://www.cisecurity.org/benchmark/microsoft_365",
      "remediation_steps": "1. Sign in to the Azure portal...",
      "source_tool": "compliance"
    }
  ],
  "meta": {
    "total": 12,
    "page": 1,
    "limit": 50
  }
}

---

Hämta enskilt resultat

Returnerar detaljer för ett individuellt kontrollresultat.

GET /scans/{scanId}/results/{testId}

Exempelbegäran

curl https://api.aether365.io/scans/scan_abc123/results/CIS.M365.1.1.1 \
  -H "Authorization: Bearer <token>"

Exempelsvar

{
  "success": true,
  "data": {
    "id": "result_001",
    "scan_id": "scan_abc123",
    "test_id": "CIS.M365.1.1.1",
    "title": "Ensure multifactor authentication is enabled for all users in administrative roles",
    "result": "failed",
    "severity": "critical",
    "framework": "cis",
    "help_url": "https://www.cisecurity.org/benchmark/microsoft_365",
    "remediation_steps": "1. Sign in to the Azure portal as a Global Administrator.\n2. Navigate to Microsoft Entra ID > Security > Conditional Access.\n3. Create or update a policy requiring MFA for all administrator roles.",
    "raw_output": {},
    "source_tool": "compliance"
  }
}

Fältreferens

Fält	Typ	Beskrivning
test_id	string	Unik kontrollidentifierare (t.ex. CIS.M365.1.1.1)
title	string	Läsbart kontrollnamn
result	string	passed, failed eller skipped
severity	string	critical, high, medium eller low
framework	string	Ramverk som definierar kontrollen (cis, eidsca, cisa, nis2)
help_url	string	Länk till officiell dokumentation eller standardreferens
remediation_steps	string	Steg-för-steg-instruktioner för åtgärd
source_tool	string	Skanningsmaskintyp (compliance eller exposure)
raw_output	object	Rå utvärderingsdata (kan vara null för vissa kontroller)