Resultater-API

Vedlikeholdt av: Aether365 Team Malgruppe: Utviklere Omfang: Resultater-API-endepunkter - hente skannefunn

Hent skanneresultater

Returnerer de individuelle kontrollresultatene for en fullfort skanning.

GET /scans/{scanId}/results

Sporreparametere

Parameter	Type	Beskrivelse
page	integer	Sidenummer (standard: 1)
limit	integer	Resultater per side (standard: 50, maks: 200)
result	string	Filtrer: passed, failed, skipped
severity	string	Filtrer: critical, high, medium, low
framework	string	Filtrer etter rammeverk: cis, eidsca, cisa, nis2

Eksempelforespørsel

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

Eksempelrespons

{
  "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
  }
}

---

Hent enkeltresultat

Returnerer detaljen for ett individuelt kontrollresultat.

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

Eksempelforespørsel

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

Eksempelrespons

{
  "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"
  }
}

Feltreferanse

Felt	Type	Beskrivelse
test_id	string	Unik kontrollidentifikator (f.eks. CIS.M365.1.1.1)
title	string	Lesbart kontrollnavn
result	string	passed, failed eller skipped
severity	string	critical, high, medium eller low
framework	string	Rammeverk som definerer denne kontrollen (cis, eidsca, cisa, nis2)
help_url	string	Lenke til offisiell dokumentasjon eller standardreferanse
remediation_steps	string	Trinnvise instruksjoner for a fikse
source_tool	string	Skannemotor-type (compliance eller exposure)
raw_output	object	Ra evalueringsutdata (kan vaere null for noen kontroller)