Ana içeriğe geç

Air-Gapped Kurulum

Amaç​

Cyprob EE’yi internete doğrudan çıkışı olmayan kısıtlı ağlarda güvenli ve işletilebilir şekilde kurmak ve güncellemek.

Dağıtım Prensipleri​

  • Çalışma anında appliance yalnızca tek bir adrese, updates.cyprob.io'ya bağlanır: motor güncellemeleri, plugin feed ve CVE feed için. Telemetri göndermez.
  • Bu adresin yerine iç ağdaki bir mirror kullanılabilir; böylece appliance’ın doğrudan internet erişimine ihtiyacı olmaz.
  • Tekrar üretilebilir kurulum: OVA kurulumun tamamıdır. Güncelleme ve geri dönüş yerleşik güncelleyici üzerinden yapılır.
  • Her transfer noktasında bütünlük doğrulaması: OVA bir .sha256 dosyası ve GPG .asc imzasıyla gelir, motor güncellemeleri ed25519 ile imzalı bir manifest ve binary’nin SHA-256 özetini kullanır, plugin feed imzalı bir index kullanır.

Kapsam​

Bu rehber şunları kapsar:

  • Appliance hazırlığı ve aktarımı
  • Kurulum ve ilk doğrulama
  • Güncelleme döngüsü
  • Geri dönüş kontrol noktaları

Gerekli Artifact’ler (Açık Ağda Hazırlanır)​

  • Cyprob appliance OVA dosyası (cyprob-appliance-v<version>.ova) ile .sha256 ve .asc dosyaları. Başka manifest gerekmez: OVA kurulumun tamamıdır; veritabanı migration’ları binary’nin içindedir ve servis başlarken çalışır.
  • Cyprob lisans anahtarı. Lisans appliance üzerinde, dışarıya bağlanmadan doğrulanır. Önceden secret hazırlamak gerekmez: appliance ilk açılışta kendi veritabanı parolasını ve şifreleme anahtarını üretir.

Önerilen Air-Gap Akışı​

1. Appliance Hazırlığı (Açık Ağ)​

  • OVA dosyasını, .sha256 ve .asc dosyalarını Cyprob’un gönderdiği bağlantıdan indir.
  • Aktarmadan önce OVA’yı .sha256 (sha256sum -c) ve .asc (gpg --verify) dosyalarıyla doğrula.

2. Kısıtlı Ağa Transfer​

  • Onaylı güvenli medya/süreç ile taşı.
  • Transfer olayını ve operatör bilgisini kaydet.
  • Import öncesi hash doğrulamasını tekrarla.

3. Import ve Kurulum​

  • OVA’yı VMware ESXi veya vSphere üzerine kur (varsayılan 4 vCPU ve 8 GB RAM). Appliance, yerel bir PostgreSQL veritabanıyla Ubuntu 24.04 üzerinde çalışır.
  • Feed ayarlarını iç ağdaki mirror’a yönlendir: updater.manifest_url, updater.plugin_feed_url ve updater.cve_feed_manifest_url. Appliance updates.cyprob.io'ya bir proxy üzerinden erişebiliyorsa varsayılanları bırak. İmza anahtarları üründe sabittir; bu nedenle bir mirror içerik enjekte edemez.
  • VM’i başlat; cyprob-ee@server servisi açılışta çalışır ve konsolu 8080 portundan sunar.
  • Health kontrolü ve baseline smoke test uygula.

4. İlk Çalıştırma Doğrulaması​

Minimum doğrulama:

  • GET http://<appliance>:8080/readyz isteği 200 OK dönüyor (/healthz yalnızca sürecin ayakta olduğunu gösterir).
  • Kurulum sihirbazı tamamlandı, login çalışıyor ve org bağlamı alınabiliyor.
  • Plugin feed updates.cyprob.io veya mirror üzerinden senkronize oldu. Senkronizasyon tamamlanana kadar taramalar PLUGIN_FEED_NOT_READY hatasıyla reddedilir.
  • En az bir scan başlatılıp tamamlanıyor.
  • Bulgular okunabiliyor.
  • En az bir rapor üretilebiliyor/indirilebiliyor.

5. Güncelleme Döngüsü​

Her güncelleme penceresinde:

  • VM snapshot’ı alınır.
  • Güncelleme Sistem Güncelleme sayfasından başlatılır. Yerleşik güncelleyici imzalı manifesti ve binary’yi updates.cyprob.io'dan veya updater.manifest_url ile tanımlanan mirror’dan indirir.
  • Smoke testler tekrar çalıştırılır.
  • Geri dönüş için güncelleyici önceki binary’yi cyprob.old, config’i config.yaml.pre-update olarak saklar; tam geri dönüş için en basit yol VM snapshot’ıdır.

İnternete de mirror’a da erişimi olmayan, tamamen kapalı bir appliance yalnızca yeni bir OVA kurularak güncellenebilir.

Air-Gapped Ortamlar İçin Operasyonel Kontroller​

  • Güncelleme için değişiklik penceresi zorunlu.
  • Güncellemeyi uygulamak için kendi değişiklik sürecinizi kullanın; üründe güncellemeler için çift onay mekanizması yoktur.
  • Admin ve güvenlik işlemleri için denetim kaydı varsayılan olarak açıktır. Platform yöneticileri kayıtları okuyabilir ve CSV olarak dışa aktarabilir. Kayıtlar saklama politikasına göre silinir; değiştirilemez kayıt gerekiyorsa dışa aktarımı tek seferlik yazılabilir (WORM) bir depolamaya kopyalayın.
  • PostgreSQL veritabanının (pg_dump cyprob_ee), /etc/cyprob/ dizininin ve /var/lib/cyprob/secrets.key dosyasının yedeğini alın. Bu anahtar olmadan geri yüklenen veritabanı, saklanan kimlik bilgilerini ve SMTP parolasını çözemez. Üründe yerleşik yedekleme yoktur; tam kopya için en basit yol VM snapshot’ıdır.

Limitler ve Netleştirme​

  • “Air-gapped hazır” ifadesi “bakım gerektirmez” anlamına gelmez; plugin ve CVE içeriği yalnızca updates.cyprob.io veya bir mirror üzerinden feed senkronizasyonuyla gelir. Plugin feed için dosyadan import yoktur; dosyadan yalnızca CVE veritabanı yüklenebilir (cyprob cve import).
  • Yeni kurulan bir appliance, plugin feed senkronize olana kadar ilk taramasını çalıştıramaz.
  • Zaman senkronizasyonu müşteri ortamının sorumluluğundadır.
  • Appliance 8080 portunda düz HTTP sunar; önüne TLS sonlandıran kendi proxy’nizi koyun.
  • SMTP relay, LDAP dizini veya OIDC sağlayıcısı ve iç feed mirror’ı appliance’tan erişilebilir olmalıdır. Denetim verisi appliance’tan yalnızca CSV dışa aktarımıyla çıkar.

Kanıt Checklist'i​

  • Artifact hash doğrulama kayıtları saklandı.
  • Kurulum/güncelleme yürütme logları saklandı.
  • Health + ilk tarama doğrulama kanıtları saklandı.
  • Geri dönüş prosedürü en az bir kez prod dışı ortamda test edildi.

Sonraki Adım​

Kısıtlı dağıtımlarda güven sınırlarını netleştirmek için Güvenlik Modeli sayfasına geç.