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
.sha256dosyası ve GPG.ascimzası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.sha256ve.ascdosyaları. 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ı,
.sha256ve.ascdosyaları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_urlveupdater.cve_feed_manifest_url. Applianceupdates.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@serverservisi 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/readyzisteği200 OKdönüyor (/healthzyalnızca sürecin ayakta olduğunu gösterir).- Kurulum sihirbazı tamamlandı, login çalışıyor ve org bağlamı alınabiliyor.
- Plugin feed
updates.cyprob.ioveya mirror üzerinden senkronize oldu. Senkronizasyon tamamlanana kadar taramalarPLUGIN_FEED_NOT_READYhatası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 veyaupdater.manifest_urlile 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’iconfig.yaml.pre-updateolarak 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.keydosyası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.ioveya 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ç.