Tulokset-API

Ylläpitäjä: Aether365-tiimi Kohderyhmä: Kehittäjät Laajuus: Tulosten API-päätepisteet - skannaushavaintojen hakeminen

Hae skannaustulokset

Palauttaa valmistuneen skannauksen yksittäiset tarkistustulokset.

GET /scans/{scanId}/results

Kyselyparametrit

Parametri	Tyyppi	Kuvaus
page	integer	Sivunumero (oletus: 1)
limit	integer	Tuloksia per sivu (oletus: 50, enintään: 200)
result	string	Suodata: passed, failed, skipped
severity	string	Suodata: critical, high, medium, low
framework	string	Suodata viitekehyksen mukaan: cis, eidsca, cisa, nis2

Esimerkkipyyntö

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

Esimerkkivastaus

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

---

Hae yksittäinen tulos

Palauttaa yhden tarkistustuloksen yksityiskohdat.

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

Esimerkkipyyntö

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

Esimerkkivastaus

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

Kenttäviite

Kenttä	Tyyppi	Kuvaus
test_id	string	Yksilöivä tarkistustunniste (esim. CIS.M365.1.1.1)
title	string	Ihmisluettava tarkistuksen nimi
result	string	passed, failed tai skipped
severity	string	critical, high, medium tai low
framework	string	Tarkistuksen määrittävä viitekehys (cis, eidsca, cisa, nis2)
help_url	string	Linkki viralliseen dokumentaatioon tai benchmark-viitteeseen
remediation_steps	string	Vaiheittaiset korjausohjeet
source_tool	string	Skannausmoottorin tyyppi (compliance tai exposure)
raw_output	object	Raaka-arviointitulos (voi olla null joillakin tarkistuksilla)