API za rezultate

Pridobitev rezultatov skeniranja

Vrne posamezne rezultate preverjanj za zaključeno skeniranje.

GET /scans/{scanId}/results

Poizvedbeni parametri

Parameter	Vrsta	Opis
page	integer	Številka strani (privzeto: 1)
limit	integer	Rezultatov na stran (privzeto: 50, največ: 200)
result	string	Filter: passed, failed, skipped
severity	string	Filter: critical, high, medium, low
framework	string	Filter po okviru: cis, eidsca, cisa, nis2

Primer zahteve

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

Primer odgovora

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

---

Pridobitev posameznega rezultata

Vrne podrobnosti enega posameznega rezultata preverjanja.

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

Primer zahteve

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

Primer odgovora

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

Referenca polj

Polje	Vrsta	Opis
test_id	string	Enolični identifikator preverjanja (npr. CIS.M365.1.1.1)
title	string	Berljivo ime preverjanja
result	string	passed, failed ali skipped
severity	string	critical, high, medium ali low
framework	string	Okvir, ki določa to preverjanje (cis, eidsca, cisa, nis2)
help_url	string	Povezava do uradne dokumentacije ali referenčnega merila
remediation_steps	string	Navodila za odpravo po korakih
source_tool	string	Vrsta mehanizma skeniranja (compliance ali exposure)
raw_output	object	Neobdelani izhod vrednotenja (za nekatera preverjanja je lahko prazen)