waf host-groups

waf host-groups komutu, bir vService'in WAF host gruplarını yönetir. Her grup bir host kümesini ve o kümeye uygulanacak WAF kipini taşır; WAF kuralları grup altında tutulur.

Komut Özeti

TR7 WEB-CLI · waf host-groups

# komuttan sonra Tab

admin@TR7LBWAF01> waf host-groups

add add-arg-headers delete list reset-rules

show update update-many

 

admin@TR7LBWAF01> waf host-groups list poolId <vservice>

admin@TR7LBWAF01> waf host-groups add poolId <vservice> name <ad> …

admin@TR7LBWAF01> waf host-groups update poolId <vservice> id <kimlik> …

admin@TR7LBWAF01> waf host-groups delete poolId <vservice> <kimlik>

admin@TR7LBWAF01>  

Zorunlu Alanlar

add komutunda CLI zorunlu alanları aşağıdaki sırayla, tek tek ister; biri yazılmadan sonrakini göstermez. Alanlar alan adı ile değeri birlikte yazılır.

Sıra	Alan	Durum	Değer
1	poolId	Zorunlu	Grubun tanımlanacağı vService kaydı
2	name	Zorunlu	Gruba özgü ad; aynı ad iki grupta kullanılamaz

update komutunda sıra poolId, id biçimindedir. list, show ve delete komutları önce poolId ister; show ve delete komutlarında ardından grubun kimliği alan adı olmadan yazılır.

İsteğe Bağlı Alanlar

Alan	Ne yapar	Arkasına ne yazılır
--mode	Grubun WAF kipini belirler	blocking eşleşen isteği engeller (varsayılan) · monitor engellemeden yalnız kaydeder · learning trafikten kural öğrenir
--hosts.N	Grubun hangi host'ları kapsadığını belirler	Host adı ya da IP adresi; her host kendi indeksiyle, aynı host iki kez yazılamaz

add-arg-headers — Fabrika Header Kurallarını Uygulama

Hazır header-argüman denetim setini (accept-encoding, cookie, host, referer ve benzeri) hedeflenen her host grubunun varsayılan kuralına uygular; setin var olan girdilerini güncel fabrika tanımlarıyla yeniler. Özel kurallara ve varsayılan kuralın kalanına dokunulmaz.

Sıra	Alan	Durum	Değer
1	target	Zorunlu	selected seçim listesinden işaretlenen gruplar · all bütün gruplar
—	--ids.N	Koşullu	target selected için grup kimlikleri. Tab bu alanı önermez; kimlikler seçim listesinden işaretlenir, betikte elle yazılır

reset-rules — Kuralları Fabrikaya Döndürme

Hedeflenen her host grubunun WAF kurallarını fabrika setinden yeniden kurar. Fabrika sıkılığı her servisin kendi koruma seviyesini izler.

Sıra	Alan	Durum	Değer
1	target	Zorunlu	selected seçim listesinden işaretlenen gruplar · all bütün gruplar
2	scope	Zorunlu	defaultRule yalnız varsayılan (tüm yollar) kuralı fabrikaya döndürür, özel ve öğrenilmiş kurallar kalır · all grubun bütün kurallarını siler ve fabrika setini yeniden kurar
—	--ids.N	Koşullu	target selected için grup kimlikleri; Tab önermez

scope all yedeksiz geri alınamaz

Uç nokta açıklamasına göre scope all, grubun bütün kurallarını önce siler. Öğrenilmiş ve elle yazılmış kurallar dahil hiçbiri kalmaz. İşlem yedek olmadan geri alınamaz.

Her iki komut da çalışmadan önce onay ekranı gösterir: seçim yapıldığında kaç grubun etkileneceğini, target all yazıldığında bütün grupların etkileneceğini bildirir.

Toplu Güncelleme

update-many, aynı değişikliği birçok host grubu kaydına birden uygular. Yazım sırası her kaynakta aynıdır.

Adım 1 Hedefi seç

Tek zorunlu alan target: selected listeden seçilen kayıtlar, all koleksiyonun tamamı.

Adım 2 Yazılacak alanları ekle

Yalnız birçok kayda aynı değerle yazılabilen alanlar bulunur; kimlik, ad ve host listesi gibi kayda özgü alanlar bu komutta yer almaz.

Adım 3 Hedefleri listeden işaretle

target selected yazılıp kimlik verilmediğinde onay kutulu seçim listesi açılır.

Adım 4 Onayla

Kaç kaydın etkileneceğini yazan uyarı çıkar; onay sözcüğü yazılmadan hiçbir şey yazılmaz.

Alan	Durum	Değer
target	Zorunlu	selected — listeden seçilen kayıtlar · all — koleksiyonun tamamı
--ids.N	Koşullu	target selected için hedef kimlikleri. Tab listesinde önerilmez: hedefler seçim listesinden işaretlenir. Betikte ve boru hattında elle yazılır.
--onError	İsteğe bağlı	abort (varsayılan) — hedeflerden biri bile doğrulamadan geçmezse hiçbir şey yazılmaz · skip — geçen hedefler yazılır

Yazılabilen Alanlar

TR7 WEB-CLI · update-many · Tab çıktısı

# komuttan sonra Tab

admin@TR7LBWAF01> waf host-groups update-many

--info target

 

# target alanından sonra Tab

admin@TR7LBWAF01> waf host-groups update-many target

all selected

 

# -- yazıp Tab: yazılabilen alanların tamamı

admin@TR7LBWAF01> waf host-groups update-many target all --

--mode

admin@TR7LBWAF01>  

Komutta 1 alan bulunur; yukarıdaki liste cihazda -- yazıp Tab'a basıldığında çıkanın aynısıdır. Her birinin ne yaptığı ve arkasına ne yazıldığı aşağıdaki tablodadır.

Tekil komutta koşula bağlı olan alanlar (bir başka alanın değerine göre açılanlar) burada koşulsuz listelenir: toplu güncellemede her hedef kendi kaydına göre ayrı doğrulanır, alan bir hedefte aktif değilse yalnız o hedefte atlanır.

Alan	Ne yapar	Arkasına ne yazılır
--mode	Seçilen grupların WAF kipini değiştirir	blocking engeller · monitor yalnız kaydeder · learning öğrenir

Tekil komutta bulunup burada olmayan alanlar ve nedenleri:

Alan	Neden yok
--name	Ad kayda özgüdür; aynı ad birden çok gruba yazılamaz
--hosts.N	Host listesi grubun kimliğidir; şemada toplu yazıma kapalı işaretlidir (batch: false)

Hedef Seçimi ve Onay

TR7 WEB-CLI · seçim listesi ve onay

admin@TR7LBWAF01> waf host-groups update-many target selected --mode monitor

 

?  Hedef nesneler

    boşluk: işaretle · ctrl+a: tümü · enter: onayla

    Filtre: (yazarak filtreleyin) · esc: iptal

 

  [x] <kayıt-1>

  [x] <kayıt-2>

  [ ] <kayıt-3>

    2 seçili / 3

 

⚠  2 nesne güncellenecek

    <kayıt-1>, <kayıt-2>

 

Devam etmek için "evet" yazın: evet

admin@TR7LBWAF01>  

TR7 WEB-CLI · tüm koleksiyon ve betik yazımı

# koleksiyonun tamamı: liste açılmaz, doğrudan onay gelir

admin@TR7LBWAF01> waf host-groups update-many target all --mode blocking

⚠  Bu işlem koleksiyondaki TÜM nesneleri güncelleyecek

Devam etmek için "evet" yazın:

 

# betikte ya da boru hattında: hedefler elle yazılır, liste açılmaz

admin@TR7LBWAF01> waf host-groups update-many target selected \

--ids.0 <kimlik-1> --ids.1 <kimlik-2> --mode monitor --onError skip

admin@TR7LBWAF01>  

Ekran dili kullanıcıya bağlıdır

Seçim listesindeki ve onay ekranındaki metinler, oturum açan kullanıcının dil tercihine göre gelir. İngilizce arayüzde onay sözcüğü yes, Türkçe arayüzde evet olur.

Toplu güncellemenin ayrıntılı davranışı — hangi alanların toplu yazılabildiği ve her hedef için dönen rapor — API Commands sayfasındadır.

Örnekler

TR7 WEB-CLI · host grupları

# iki host'u kapsayan, önce izleyen bir grup

admin@TR7LBWAF01> waf host-groups add poolId <vservice> name web-grup \

--mode monitor --hosts.0 www.kurum.com.tr --hosts.1 kurum.com.tr

 

# izleme bittikten sonra engellemeye geçme

admin@TR7LBWAF01> waf host-groups update poolId <vservice> id <kimlik> --mode blocking

 

# fabrika header denetimlerini bütün gruplara yayma

admin@TR7LBWAF01> waf host-groups add-arg-headers target all

 

# yalnız varsayılan kuralı fabrikaya döndürme

admin@TR7LBWAF01> waf host-groups reset-rules target selected scope defaultRule

admin@TR7LBWAF01>  

Bilinmesi Gerekenler

• Grup bir vService'e aittir. Her komutta poolId ile hangi vService'in grupları üzerinde çalışıldığı belirtilir.
• Zorunlu alanlar -- almaz. poolId, name, target ve scope alan adı ile değeri yan yana yazılır; isteğe bağlı alanlar --alan değer biçimindedir. Ayrıntı API Commands sayfasındadır.
• Kip, kuralların ne yapacağını belirler. monitor kipinde eşleşen istek engellenmez, yalnız kaydedilir; yeni bir grubu önce bu kiple çalıştırıp sonra blocking kipine almak yanlış engellemeleri azaltır.
• Host listesi grubun kimliğidir. Şemada toplu yazıma kapalı işaretlidir; birden çok gruba aynı host listesini yazmak beklenen bir kullanım değildir.
• Kurallar ayrı komutlarda yönetilir. Yol kuralları waf fw-rules, o kuralların denetim parçaları waf rule-parts komutundadır.
• Servis geneli ayarlar ayrıdır. Koruma seviyesi, engelleme sayfası, öğrenme ve bildirim ayarları waf options komutundadır.