Sonuçlar API

Hazırlayan: Aether365 Ekibi Hedef Kitle: Geliştiriciler Kapsam: Sonuçlar API endpoint'leri - tarama bulgularını alma

Tarama Sonuçlarını Alma

Tamamlanmış bir taramanın bireysel kontrol sonuçlarını döndürür.

GET /scans/{scanId}/results

Sorgu Parametreleri

Parametre	Tür	Açıklama
page	integer	Sayfa numarası (varsayılan: 1)
limit	integer	Sayfa başına sonuç (varsayılan: 50, maksimum: 200)
result	string	Filtre: passed, failed, skipped
severity	string	Filtre: critical, high, medium, low
framework	string	Framework'e göre filtre: cis, eidsca, cisa, nis2

Örnek İstek

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

Örnek Yanıt

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

---

Tekil Sonuç Alma

Tek bir kontrol sonucunun ayrıntısını döndürür.

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

Örnek İstek

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

Örnek Yanıt

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

Alan Referansı

Alan	Tür	Açıklama
test_id	string	Benzersiz kontrol tanımlayıcısı (ör. CIS.M365.1.1.1)
title	string	Okunabilir kontrol adı
result	string	passed, failed veya skipped
severity	string	critical, high, medium veya low
framework	string	Bu kontrolü tanımlayan framework (cis, eidsca, cisa, nis2)
help_url	string	Resmi dokümantasyon veya benchmark referans bağlantısı
remediation_steps	string	Adım adım düzeltme talimatları
source_tool	string	Tarama motoru türü (compliance veya exposure)
raw_output	object	Ham değerlendirme çıktısı (bazı kontrollerde null olabilir)