API за резултати

Получаване на резултати от сканиране

Връща отделните резултати от проверки за завършено сканиране.

GET /scans/{scanId}/results

Параметри на заявката

Параметър	Тип	Описание
page	integer	Номер на страница (по подразбиране: 1)
limit	integer	Резултати на страница (по подразбиране: 50, максимум: 200)
result	string	Филтър: passed, failed, skipped
severity	string	Филтър: critical, high, medium, low
framework	string	Филтър по рамка: cis, eidsca, cisa, nis2

Примерна заявка

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

Примерен отговор

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

---

Получаване на единичен резултат

Връща детайлите за един отделен резултат от проверка.

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

Примерна заявка

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

Примерен отговор

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

Справка за полетата

Поле	Тип	Описание
test_id	string	Уникален идентификатор на проверката (напр. CIS.M365.1.1.1)
title	string	Име на проверката на разбираем език
result	string	passed, failed или skipped
severity	string	critical, high, medium или low
framework	string	Рамката, която дефинира тази проверка (cis, eidsca, cisa, nis2)
help_url	string	Линк към официална документация или справка за стандарта
remediation_steps	string	Инструкции за коригиране стъпка по стъпка
source_tool	string	Тип на механизма за сканиране (compliance или exposure)
raw_output	object	Необработен изходен резултат от оценяването (може да е null за някои проверки)