Tulemuste API

Skaneerimise tulemuste kättesaamine

Tagastab lõpetatud skaneerimise üksikud kontrollitulemused.

GET /scans/{scanId}/results

Päringuparameetrid

Parameeter	Tüüp	Kirjeldus
page	integer	Lehekülje number (vaikimisi: 1)
limit	integer	Tulemusi lehekülje kohta (vaikimisi: 50, maks: 200)
result	string	Filter: passed, failed, skipped
severity	string	Filter: critical, high, medium, low
framework	string	Filtreeri raamistiku järgi: cis, eidsca, cisa, nis2

Näidispäring

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

Näidisvastus

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

---

Üksiku tulemuse kättesaamine

Tagastab ühe kontrollitulemuse üksikasjad.

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

Näidispäring

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

Näidisvastus

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

Väljade viide

Väli	Tüüp	Kirjeldus
test_id	string	Unikaalne kontrolli identifikaator (nt CIS.M365.1.1.1)
title	string	Inimloetav kontrolli nimi
result	string	passed, failed või skipped
severity	string	critical, high, medium või low
framework	string	Kontrolliti määrav raamistik (cis, eidsca, cisa, nis2)
help_url	string	Link ametlikule dokumentatsioonile või võrdlusnäitaja viitele
remediation_steps	string	Samm-sammult parandusjuhised
source_tool	string	Skaneerimismootori tüüp (compliance või exposure)
raw_output	object	Toore hindamisväljund (mõne kontrolli puhul võib olla null)