Ana içeriğe geç

Hızlı Başlangıç (İlk Doğrulama Koşusu)

Hedef​

Tek bir uçtan uca doğrulama döngüsünü tamamlamak:

  1. Platform sağlıklı.
  2. İlk tarama oluşturuldu.
  3. Bulgular görüntülenebiliyor.
  4. İlk rapor üretildi.

Ön Koşullar​

  • OVA'dan kurulmuş, ilk açılış Kurulum Sihirbazı tamamlanmış ve lisansı etkinleştirilmiş bir Cyprob appliance.
  • API/UI erişimi.
  • Geçerli kullanıcı bilgileri.
  • Güvenli test hedefi (lab ağı veya onaylı iç ağ aralığı).

Adım 1: Platform Sağlığını Doğrula​

Login’den önce temel servis erişimini kontrol et.

curl -sS http://<CYPROB_HOST>:8080/readyz

Beklenen sonuç: HTTP 200 ile OK gövdesi. Sunucu trafik almaya hazır olana kadar /readyz, HTTP 503 ile NOT READY döner. Yalnızca canlılık kontrolü için /healthz kullanılır; o da OK döner.

Adım 2: Login ve Organizasyon Bağlamı​

Token ve organizasyon bilgisi al.

curl -sS -X POST http://<CYPROB_HOST>:8080/api/v1/auth/login \
-H 'Content-Type: application/json' \
-d '{"email":"<USER_EMAIL>","password":"<USER_PASSWORD>"}'

Yanıttan şunları al:

  • token
  • user.memberships[*].org_id

Kurulum Sihirbazı'nda oluşturduğun yönetici hesabıyla giriş yap.

Adım 3: İlk Taramayı Başlat​

API üzerinden scan oluştur.

curl -sS -X POST http://<CYPROB_HOST>:8080/api/v1/orgs/<ORG_ID>/scans \
-H "Authorization: Bearer <TOKEN>" \
-H 'Content-Type: application/json' \
-d '{"target":"<TARGET>","scan_type":"vulnerability"}'

Örnek hedefler:

  • 192.168.56.0/24
  • 10.10.10.12

Adım 4: Tarama İlerlemesini İzle​

UI’dan veya API ile listeyi takip et.

curl -sS -H "Authorization: Bearer <TOKEN>" \
http://<CYPROB_HOST>:8080/api/v1/orgs/<ORG_ID>/scans

Doğrulama:

  • Tarama bir son duruma ulaşıyor: completed, partial, failed veya canceled. partial, taramanın bittiğini ancak bazı hedeflerin taranamadığını gösterir; bulunan bulgular geçerlidir.
  • Asset/service veya finding çıktısı oluşuyor.

Adım 5: Bulguları Doğrula​

Tamamlanan taramadan bulguları çek.

curl -sS -H "Authorization: Bearer <TOKEN>" \
http://<CYPROB_HOST>:8080/api/v1/orgs/<ORG_ID>/scans/<SCAN_ID>/findings

En az şu kontrol edilmeli:

  • Önem derecesi dağılımı: GET /api/v1/orgs/<ORG_ID>/scans/<SCAN_ID>/stats → severity_distribution (critical/high/medium/low/info).
  • Aksiyon alınabilir kayıtlar için kanıt/bağlam alanları dolu.

Adım 6: İlk Raporu Üret​

Aynı organizasyon kapsamında rapor oluştur.

curl -sS -X POST http://<CYPROB_HOST>:8080/api/v1/orgs/<ORG_ID>/reports \
-H "Authorization: Bearer <TOKEN>" \
-H 'Content-Type: application/json' \
-d '{"name":"first-validation-report","template_type":"executive_summary","format":"pdf","scope":{}}'

İndirmeden önce status değeri completed olana kadar GET /api/v1/orgs/<ORG_ID>/reports/<REPORT_ID> ile durumu sorgula.

İndirme seçenekleri:

  • Download URL alma: GET /api/v1/orgs/<ORG_ID>/reports/<REPORT_ID>/download
  • Doğrudan stream: GET /api/v1/orgs/<ORG_ID>/reports/<REPORT_ID>/stream

Kanıt Checklist'i (Hızlı Başlangıç Tamam)​

  • Hazırlık (readiness) endpoint'i OK dönüyor.
  • Auth token üretiliyor.
  • Bir scan oluşturulup tamamlanıyor.
  • Bulgular okunabiliyor.
  • Bir rapor oluşturulup indirilebiliyor.

Sonraki Adım​

Toplantı odaklı tekrar üretilebilir akış için POC Playbook sayfasına geç.