Bir host group'un kural setini JSON olarak dışa aktarıp başka bir ortama taşıyabilir miyim; hangi ayarlar bu dosyaya girmez?

Kısa cevap

Evet. Page Types ekranındaki Export, host grubunun bütün sayfa tiplerini (Any Paths ve her kuralın Check Fields denetimleri dahil) onay sormadan tek bir JSON dosyası olarak indirir; hedef vService'te istenen host grubunun Page types ekranındaki Import ile yüklenir ve o grubun bütün kural setinin yerine geçer. Dosyaya yalnızca kural listesi girer; host grubunun adı, host desenleri ve WAF Mode, vService'in WAF ayarları (OWASP Protection Level, Checks, Request Body Limits, Blocking Page, Whitelist & Blacklist, Learning Methods, Log Settings, Notifications, Periodic Reporting, SIEM & Attack Details), vService'in ve cihazın OWASP Rules değişiklikleri ile özel imzaları, analizler ve öğrenme verisi dosyada yoktur; bunlar hedefte ayrıca ayarlanır. OWASP Exclusions imza kimliğiyle taşınır. Aynı ekrandaki Export (OpenAPI) kural setini OpenAPI belgesi olarak indirir. WEB-CLI'da dışa ve içe aktarma komutu yoktur.

Sorun: Kural Seti Başka Ortama Taşınacak

Test ortamında ya da başka bir cihazda öğrenilmiş sayfa tipleri canlıya ya da başka bir host grubuna taşınmak isteniyor. Dosyanın neyi taşıyıp neyi taşımadığı bilinmezse hedefte koruma düzeyi, Checks anahtarları ya da imza değişiklikleri kaynakla aynı olmaz ve aynı kurallar farklı sonuç verir.

Çözüm: İki Yöntem

Durumunuz	Uygun yöntem
Kural setini TR7'ye birebir taşımak ya da yedeklemek	Yöntem 1: Export ve Import
Kural setini OpenAPI belgesi olarak paylaşmak ya da başka bir TR7'ye birleştirerek yüklemek	Yöntem 2: Export (OpenAPI)

Yöntem 1: Export ve Import Önerilen

• Nasıl çalışır Kaynak grubun kural listesi dosyaya alınır; hedef grupta Import, grubun bütün kurallarını dosyadakilerle değiştirir.
• Nerede açılır Left Monitor Panel → WAF-Protected vServices → vService → WAF Management → host grubunun mod kartı → N page types → Export · Import
• Gereksinim Kaynak ve hedef vService'te WAF koruması etkin; hedef host grubu tanımlı
• vService tipi WAF koruması etkin HTTP vService

Adım adım yapılandırma

1

Adım 1 Kaynak grubun Page types sekmesini aç

Kaynak vService'te Left Monitor Panel'de WAF-Protected vServices sekmesinde vService'e tıklanır, WAF Management sekmesi açılır ve taşınacak host grubunun mod kartı altındaki N page types satırına tıklanır (ekrana erişim).

2

Adım 2 Dışa aktar

Araç çubuğundaki Export tıklanır; satır seçimi gerekmez, onay sorulmaz. Tarayıcı, vService ve host grubu adından ve tarih-saat damgasından oluşan .json dosyasını indirir (dışa aktarma adımları).

3

Adım 3 Hedefi hazırla

Hedef vService'te WAF koruması açık değilse açılır (Bir vService'te WAF korumasını nasıl etkinleştiririm?); hedef host grubu yoksa eklenir (Host Group nasıl eklenir; Virtual Host Patterns alanına ne yazılır?). Hedef grubun mevcut kuralları korunacaksa önce onun da Export dosyası alınır.

4

Adım 4 Hedef grubun Page types sekmesini aç

Hedef vService'in WAF Management sekmesinde hedef host grubunun N page types satırına tıklanır. Dosya hangi gruptan alındığı bilgisini taşımadığından doğru grubun açık olduğu sekme başlığından kontrol edilir.

5

Adım 5 Dosyayı seç

Araç çubuğundaki Import tıklanır ve dosya seçiciden 2. adımda indirilen dosya seçilir (içe aktarma adımları).

6

Adım 6 Onayla

Are you sure? sorusunda Yes tıklanır. Grubun bütün kuralları dosyadakilerle değişir; başarı bildirimi gösterilmez, liste ve N page types sayısı güncellenir. Dosyada Any paths yoksa işlem sonunda varsayılan yapılandırmasıyla kurulur (Import yaptığımda mevcut kurallar ne olur (tam değiştirme)?). Değişiklik ayrı bir dağıtım adımı olmadan uygulanır; cluster kurulumunda varsayılan auto-sync ile eş cihaza da gönderilir, Manual Sync Mode açıksa Synchronize ile elle gönderilir.

Dosyaya girmeyen ayarlar

Hedef vService'te WAF Management'taki kartlardan ayrıca ayarlanır: OWASP Protection Level, Checks (Structure checks, Argument checks, Max. Allowed Arguments, URL decoding), Request Body Limits, Blocking Page, Whitelist & Blacklist, Learning Methods, Log Settings, Notifications, Periodic Reporting ve SIEM & Attack Details. Host grubunun modu ve host desenleri Virtual Host Groups bandından ayarlanır. İmza durumu, puanı ve özel imzalar hedef vService'in OWASP rules ekranında ya da cihazın Signature & Rule Library ekranında ayrıca yapılır.

Doğrulama

1ListeTR7 tarafı

Hedef grubun Page types listesi kaynak grubunkiyle karşılaştırılır.

BeklenenAynı path'ler ve aynı N page types sayısı

2User LogsTR7 tarafı

Hedef cihazda Settings → System Logs → User Logs ekranında içe aktarma kaydına bakılır.

BeklenenN WAF rules are imported from file for grup@vService

Yöntem 2: Export (OpenAPI)

• Nasıl çalışır Kural seti OpenAPI 3 belgesi olarak indirilir; TR7'nin ürettiği belge Import (OpenAPI) ile yüklendiğinde kurallar belgedeki TR7'ye özel bölümden kayıpsız gelir ve mevcut kurallarla birleştirilir.
• Nerede açılır Page types → Export (OpenAPI) · Import (OpenAPI)
• Gereksinim Kaynak ve hedef vService'te WAF koruması etkin
• vService tipi WAF koruması etkin HTTP vService

Adım adım yapılandırma

1

Adım 1 Belgeyi indir

Kaynak grubun Page types sekmesinde Export (OpenAPI) tıklanır; belge .json olarak iner. Glob path'ler {param} şablonuna, metotlar ve parametreler OpenAPI alanlarına çevrilir; tam kural tanımı ve Any paths yapılandırması belgenin TR7'ye özel x-tr7-waf bölümünde taşınır (üretilen belge).

2

Adım 2 Hedefte yükle

Hedef grubun Page types sekmesinde Import (OpenAPI) tıklanır, belge seçilir ve Are you sure? sorusunda Yes tıklanır. Belgedeki path'ler aynı path'li kuralların yerine geçer, belgede olmayan kurallar kalır; TR7 çıktısında Any paths yapılandırması da belgedekiyle değişir (OpenAPI / Swagger dosyamdan otomatik kural üretebilir miyim?).

Doğrulama

1Bildirim ve listeTR7 tarafı

Yükleme sonrası bildirime ve Page types listesine bakılır.

BeklenenOpenAPI import: N path applied · belgedeki path'ler listede

Sık Yapılan Hatalar

• Dosyanın vService ayarlarını da taşıdığını sanmak. Dosya yalnızca kural listesidir; koruma düzeyi, Checks, engelleme sayfası ve diğer kartlar hedefte ayrıca ayarlanır.
• Import'un mevcut kurallara eklediğini sanmak. JSON Import tam değiştirmedir; birleştirme isteniyorsa OpenAPI yolu kullanılır (Import yaptığımda mevcut kurallar ne olur (tam değiştirme)?).
• Tablo dışa aktarımını (Excel, CSV, PDF) yedek sanmak. Export Table çıktısı yalnızca tabloda görünen kolonlardır ve geri yüklenemez (Export Table).
• vService'e özel imzalara verilen istisnaları kontrol etmemek. OWASP exclusions imza kimliğiyle taşınır; kaynak vService'in OWASP rules ekranında eklenmiş özel imzalar hedefte bulunmadığından bu istisnalar hedefte işlev görmez.
• Yanlış gruba yüklemek. Dosya grup bilgisi taşımaz; Import, açık olan grubun kural setini değiştirir.

Dokümantasyonda nasıl yapılır

• Export · Export nedir
• Export · Dışa aktarma adımları
• Import · İçe aktarma adımları
• Export (OpenAPI) · Üretilen belge

İlgili sorular

• WAF kurallarımı yedekleyebilir miyim?
• Test ortamında hazırladığım WAF kurallarını canlıya nasıl taşırım?
• Import yaptığımda mevcut kurallar ne olur (tam değiştirme)?