API výsledků

API výsledků slouží k načítání nálezů ze skenů.

Získání výsledků skenu

Vrací jednotlivé výsledky kontrol pro dokončený sken.

GET /scans/{scanId}/results

Parametry dotazu

Parametr	Typ	Popis
page	integer	Číslo stránky (výchozí: 1)
limit	integer	Počet výsledků na stránku (výchozí: 50, max: 200)
result	string	Filtr: passed, failed, skipped
severity	string	Filtr: critical, high, medium, low
framework	string	Filtr podle frameworku: cis, eidsca, cisa, nis2

Příklad požadavku

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

Příklad odpovědi

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

---

Získání jednoho výsledku

Vrací detail jednoho jednotlivého výsledku kontroly.

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

Příklad požadavku

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

Příklad odpovědi

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

Reference polí

Pole	Typ	Popis
test_id	string	Jedinečný identifikátor kontroly (např. CIS.M365.1.1.1)
title	string	Srozumitelný název kontroly
result	string	passed, failed nebo skipped
severity	string	critical, high, medium nebo low
framework	string	Framework definující kontrolu (cis, eidsca, cisa, nis2)
help_url	string	Odkaz na oficiální dokumentaci nebo referenci benchmarku
remediation_steps	string	Podrobné pokyny k nápravě
source_tool	string	Typ skenovacího nástroje (compliance nebo exposure)
raw_output	object	Surový výstup vyhodnocení (u některých kontrol může být null)