Eredmények API

Vizsgálati eredmények lekérdezés

Egy befejezett vizsgálat egyedi ellenőrzési eredményeit adja vissza.

GET /scans/{scanId}/results

Lekérdezési paraméterek

Paraméter	Típus	Leírás
page	integer	Oldal száma (alapértelmezett: 1)
limit	integer	Eredmények oldalanként (alapértelmezett: 50, max: 200)
result	string	Szűrés: passed, failed, skipped
severity	string	Szűrés: critical, high, medium, low
framework	string	Szűrés keretrendszer szerint: cis, eidsca, cisa, nis2

Példa kérés

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

Példa válasz

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

---

Egyetlen eredmény lekérdezés

Egyetlen ellenőrzés eredményének részleteit adja vissza.

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

Példa kérés

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

Példa válasz

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

Mező hivatkozás

Mező	Típus	Leírás
test_id	string	Egyedi ellenőrzés-azonosító (pl. CIS.M365.1.1.1)
title	string	Ember által olvasható ellenőrzésnév
result	string	passed, failed vagy skipped
severity	string	critical, high, medium vagy low
framework	string	Az ellenőrzést meghatározó keretrendszer (cis, eidsca, cisa, nis2)
help_url	string	Hivatkozás a hivatalos dokumentációra vagy referenciához
remediation_steps	string	Lépésről lépésre haladó javítási útmutatás
source_tool	string	Vizsgáló motor típusa (compliance vagy exposure)
raw_output	object	Nyers kiértékelési eredmény (egyes ellenőrzéseknél null lehet)