SSS
Smarter by Design.Simpler for Business
TR7Enterprise Application Delivery & Security Platform

Türkçe

English

Türkçe

English

Görünüm

Orta

Belirli bir header'ın varlığını zorunlu kılabilir miyim? ​

Kısa cevap

Evet. Sayfa tipinin Header sekmesindeki ortak kuralda Required Headers listesi Restrict konumuna alınıp başlık adı eklenir; başlığı taşımayan her istek Structure Policies kategorisinde 24 puanlık Required headers ihlali üretir. Başlığın bulunması yeterlidir, değeri boş olabilir; değerin biçimi o başlığa açılan değişken kuralındaki Header Value Pattern ile ayrıca denetlenir. Başlıklar küçük harfe indirilerek karşılaştırılır ve liste girdileri çevrilmez; ad x-api-key gibi küçük harfle yazılır. Denetim için Checks penceresinde Argument Checks açık olmalıdır. Öğrenme ve öğretme başlık değişikliklerini Any Paths kuralına yazar (Combine With Old Rules ile uygulanan Analysis & Learning hariç); path'e özel Header kuralı elle düzenlenir.

Sorun: Bir Başlık Olmadan Gelen İstekler Uygulamaya Ulaşıyor ​

Bir API path'i yalnızca belirli bir başlıkla (ör. API anahtarı ya da istemci sürümü) çağrılmalı; başlık eksikse istek uygulamaya ulaşmadan reddedilmeli. Başlığın yalnızca varlığı değil, değerinin biçimi de denetlenmek istenebilir.

Çözüm: İki Yöntem ​

İki yöntem aynı listeyi yazar; biri seçilir. Değerin biçimi de denetlenecekse Yöntem 1'deki ek adım uygulanır.

DurumunuzUygun yöntem
Ayarı arayüzden yapmak istiyorumYöntem 1: Header ortak kuralı
Betik ya da komut satırıyla yapmak istiyorumYöntem 2: WEB-CLI
  • Nasıl çalışır Sayfa tipinin Header ortak kuralına zorunlu başlık adı yazılır; başlığı taşımayan istek ihlal sayılır.
  • Nerede açılır Left Monitor Panel → WAF-Protected vServices → vService → WAF Management → N page types → kural → Header → Add Common Rule for Header
  • GereksinimArgument Checks açık; değer biçimi için ayrıca Structure Checks açık
  • vService tipi WAF açık HTTP vService
  • Öğrenmeyle ilişkisi Öğrenme ve öğretme başlık değişikliklerini Any paths kuralına yazar; path'e özel Header kuralını yalnızca Combine With Old Rules ile uygulanan Analysis & Learning genişletebilir

Adım adım yapılandırma ​

1
Adım 1 Checks penceresini aç (gerekiyorsa)

Argument Checks WAF açıldığında açık gelir; kapatıldıysa Left Monitor Panel → WAF-Protected vServices → vService → WAF Management sekmesinde Inspection & Blocking bölümündeki Checks kartının sağ üstündeki kalem ikonu tıklanır (Checks Edit ekranı).

2
Adım 2 Argument checks'i aç

Argument Checks açık konuma alınır.

3
Adım 3 Checks ayarını kaydet

Edit tıklanır.

4
Adım 4 Page Types listesini aç

WAF Management sekmesinde host grubunun N page types satırına tıklanır (Page Types ekranına erişim).

5
Adım 5 Sayfa tipini seç

Zorunluluğun uygulanacağı sayfa tipinin satırına tıklanır; detay paneli sağda açılır (panele erişim). Sayfa tipi yoksa önce eklenir (ör. /api/** glob path'i ile) (Yeni bir page type'ı elle nasıl eklerim?).

6
Adım 6 Header sekmesini aç

Panelin sekme şeridinde Header sekmesine tıklanır.

7
Adım 7 Ortak kural formunu aç

Tablonun üstündeki Add Common Rule for Header tıklanır; kural kendi Header ortak kuralına sahipse buton Edit Common Rule for Header olarak görünür (Add Common Rule for Header ekranı). Ekleme formu Any paths kuralının Header değerleriyle dolu açılır.

8
Adım 8 Başlık adını yaz

Required Headers anahtarı Restrict konumuna alınır ve başlık adı küçük harfle eklenir (x-api-key).

9
Adım 9 Kaydet

Add (düzenlemede Edit) tıklanır; 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 eş cihaza elle gönderilir.

10
Adım 10 Değerin biçimini denetle (isteğe bağlı)

Aynı sekmede değişken tablosunun üstündeki Add Argument Rule for Header tıklanır; Argument Name kutusuna başlık adı küçük harfle yazılır ve Header Value Pattern alanına beklenen biçim girilir (ör. ^[A-Za-z0-9]{32}$). Form Add ile kaydedilir. Bu denetim Structure Checks anahtarına bağlıdır (Bir parametrenin değerini uzunluk veya regex desenle kısıtlayabilir miyim (Value length / Value pattern)?).

Doğrulama ​

1Başlıksız istekİstemci tarafı

Host grubu Blocking modundayken başlık olmadan istek gönderilir.

Komut: curl -s -o /dev/null -w "%{http_code}\n" https://www.example.com/api/rapor

Beklenen418
Aynı istek -H "X-Api-Key: …" ile gönderildiğinde uygulamanın yanıtı döner; istemcinin yazdığı harf büyüklüğü önemsizdir. 418, Blocking Status Code varsayılanıdır.
2Event LogsTR7 tarafı

Event Logs kaydının Attacks sekmesine bakılır.

BeklenenAttack area: Header@x-api-key · Attack name: Required headers

Yöntem 2: WEB-CLI ​

  • Nasıl çalışır Başlık adı WEB-CLI ile kuralın Header ortak parçasındaki headerMustArgs listesine yazılır.
  • Nerede açılır WEB-CLI → waf rule-parts
  • Gereksinim WEB-CLI erişimi; Argument Checks açık (waf options update poolId <vService> --syncWithDefaultFwRules false --argumentChecks true)
  • vService tipi WAF açık HTTP vService
  • Ön dolum farkıadd yazılmayan alanlara komutun varsayılanlarını yazar (headerSize ≤ 4096, headerKeyCount ≤ 32, valueLength 0–1024)

Adım adım yapılandırma ​

1
Adım 1 Kural kimliğini bul

Varsayılan host grubunun kimliği defaultHost'tur; kural kimlikleri id sütununda listelenir:

text
waf fw-rules list poolId <vService> hostGroupId defaultHost
2
Adım 2 Kuralın parçalarını listele

Açıklama sütununda header: (all keys) görünen satır Header ortak parçasıdır:

text
waf rule-parts list poolId <vService> hostGroupId defaultHost ruleId <kural>
3
Adım 3 Ortak parça varsa mevcut listeyi gör

Çıktıdaki headerMustArgs.0, headerMustArgs.1 … satırları mevcut zorunlu başlıklardır:

text
waf rule-parts show poolId <vService> hostGroupId defaultHost ruleId <kural> <parça>
4
Adım 4 Adı ilk boş sıraya yaz

--headerMustArgs.N o sıradaki mevcut adın yerine geçer; yeni ad ilk boş sıraya yazılır (liste boşsa 0):

text
waf rule-parts update poolId <vService> hostGroupId defaultHost ruleId <kural> id <parça> --headerMustArgs.0 x-api-key
5
Adım 5 Ortak parça yoksa ekle

Büyük başlıklı istekler engellenmesin diye toplam boyut sınırı komutta verilir:

text
waf rule-parts add poolId <vService> hostGroupId defaultHost ruleId <kural> loc header --headerSize.op "<=" --headerSize.val 65536 --headerMustArgs.0 x-api-key

Doğrulama ​

1Parça kaydıTR7 tarafı

Parça yeniden görüntülenir.

Komut: waf rule-parts show poolId <vService> hostGroupId defaultHost ruleId <kural> <parça>

BeklenenheaderMustArgs satırında x-api-key
Başlıksız istek Yöntem 1'deki gibi engellenir.

Sık Yapılan Hatalar ​

  • Adı büyük harfle yazmak. Liste girdileri küçük harfe çevrilmez; X-Api-Key yazılırsa zorunluluk hiçbir istekte sağlanmaz ve her istek ihlal üretir.
  • Zorunluluğu Any paths kuralına koymak. Any paths kuralının Header ortak kuralı, kendi Header kuralı olmayan bütün path'lere uygulanır; başlığı taşımayan tarayıcı ve izleme istekleri de engellenir. Zorunluluk yalnızca ilgili sayfa tipine yazılır.
  • Zorunluluğu değişken kuralında aramak. Değişken kuralı başlığın değerini denetler, varlığını denetlemez; başlık gelmezse değişken kuralı hiç çalışmaz.
  • Path'e özel Header kuralının öğrenmeyle gevşeyeceğini beklemek. Başlık öğrenmesi Any paths kuralına yazılır (yalnızca Combine With Old Rules ile uygulanan Analysis & Learning sayfa tipinin kendi Header kuralını genişletebilir); sayfa tipinin kendi Header ortak kuralından kaynaklanan ihlaller o kural elle düzenlenerek giderilir.

Dokümantasyonda nasıl yapılır

İlgili sorular