Dynamic List

Dynamic List Nedir?

Dynamic List koşulu, Smart Variables (fx) kullanılarak elde edilen dinamik bir değerin, önceden tanımlanmış bir liste içinde aranmasını sağlayan güçlü bir koşul tipidir.

Key to Searchİstemci IP adresi

IP/CIDR eşleşmesi

List192.168.1.0/24
10.0.0.0/8
172.16.0.0/12

İstemci IP listedeki bir aralıkta ise → koşul TRUE döner

Bu koşul sayesinde dinamik değerleri statik listelerle karşılaştırılarak esnek trafik yönetimi yapılabilir.

Dynamic List Koşulunun Önemi

Dynamic List koşulu, TR7'nin en esnek koşul tiplerinden biridir. Smart Variables (fx) sayesinde herhangi bir trafik bilgisi bir liste ile karşılaştırılabilir.

Dynamic List koşulu sayesinde;

• IP adreslerini whitelist/blacklist ile kontrol edilebilir,
• Belirli path'ler veya URL'ler listeyle eşleştirilebilir,
• Header değerleri izin verilen listelerle karşılaştırılabilir,
• Kullanıcı agent'ları filtrelenebilir,
• Coğrafi konum bazlı erişim kontrolü yapılabilir.

Arama Yöntemleri:

Yöntem	Açıklama
Exact match	Değer liste elemanıyla birebir eşleşmeli
Start	Değer liste elemanıyla başlamalı
End	Değer liste elemanıyla bitmeli
Includes	Değer liste elemanını içermeli
Regex	Değer regex desenlerinden biriyle eşleşmeli
IP/cidr match	IP adresi CIDR aralıklarından birinde olmalı

Kullanılabildiği vService Tipleri

HTTP

L7 TCP

Network

Nasıl Eklenir?

Yeni bir Dynamic List, TR7 web yönetim arayüzü üzerinden aşağıdaki adımlar izlenerek eklenebilir:

1. Sol altta bulunan TR7 logosuna tıklanarak Configuration Menu açılır.
2. Load Balancer → Conditions → Add adımları takip edilir.
3. Criteria olarak Dynamic list seçilir.
4. Koşula ait ilgili konfigürasyonlar yapılandırılır.
5. Add butonuna tıklanarak koşul eklenir.

Dynamic List Ekleme Formu

Dynamic List Ekleme Formu

INFO

Condition Name

Oluşturulacak koşul için isteğe bağlı bir isim girilebilir.

Bu alan, özellikle aşağıdaki senaryolarda önemlidir:

• Aynı vService altında çok sayıda koşul tanımlandığında,
• Benzer kriterlere sahip koşulların ayırt edilmesi gerektiğinde,
• Koşulun hangi iş kuralını temsil ettiğinin hızlıca anlaşılması istendiğinde.

Bu alan boş bırakıldığında, TR7 ilgili koşulun içeriğini analiz ederek Condition Description alanında otomatik ve açıklayıcı bir isim oluşturur. Oluşturulan bu açıklama, koşul listelerinde isim olarak kullanılır.

INFO

Criteria Zorunlu

Koşulun tipini belirleyen alandır; aranabilir açılır listeden Dynamic list seçilir. Bu seçim, formda görüntülenecek alanları belirler. Kriter, koşul kaydedildikten sonra değiştirilemez: farklı bir kritere ihtiyaç duyulursa yeni bir koşul tanımlanır. Listedeki tüm kriterler ve kapsamları için Conditions sayfasındaki kriter kataloğuna bakılabilir.

INFO

Condition Level

Koşulun hangi fazda değerlendirileceğini belirler; kayıttan sonra değiştirilemez.

• On request: İstek alındığında değerlendirilir.
• On response: Yanıt alındığında değerlendirilir.

INFO

Condition Protocol

Koşulun hangi protokolde çalışacağını belirler; kayıttan sonra değiştirilemez.

• HTTP: HTTP vService'lerde kullanılır.
• TCP: L7 TCP vService'lerde kullanılır. TCP'de yanıt aşamasına ait değişkenler bulunmadığından, On Response seçilse bile değişken listesi istek kümesinden sunulur.

INFO

Key to Search Zorunlu Varsayılan: İstemci IP adresi

Listede aranacak değeri üreten Akıllı Değişken bu alana girilir; sabit metinle değişkenler aynı alanda birleştirilebilir. Form, İstemci IP adresi değişkeni seçili olarak açılır.

TIP

Bu alan Smart Variables destekler. fx butonu ile mevcut değişkenlere erişilebilir ve dinamik içerik oluşturulabilir. Detaylı bilgi için Variables dokümanına bakılabilir.

Değişken listesi, seçili Condition Protocol ve Condition Level değerlerine göre değişir:

Değişken	Açıklama	Kullanılabilirlik
İstemci IP adresi	İstemci IP adresi	Her protokol ve aşamada
İstek yapan IP'ye ait ülke bilgisi	İstemci ülke kodu	Her protokol ve aşamada
İsteğin yapıldığı dizin/sayfa	İstek path'i	Yalnız HTTP
Host	Host başlık değeri	Yalnız HTTP
İstek Çerez bilgisi	İstek çerez değeri	Yalnız HTTP

INFO

Search Method

Değerin listede nasıl aranacağı seçilir. Aramalar büyük/küçük harfe duyarlıdır.

Yöntem	Açıklama
Exact match	Değer liste elemanıyla birebir eşleşmeli
Start	Değer liste elemanıyla başlamalı
End	Değer liste elemanıyla bitmeli
Includes	Değer liste elemanını içermeli
Regex	Değer regex desenlerinden biriyle eşleşmeli
IP/cidr match	IP adresi, listedeki IP/CIDR kayıtlarından biriyle eşleşmeli

TIP

İstemci IP adresi, Hedef Ip adresi gibi IP değişkenleri kullanılıyorsa IP/cidr match yöntemi seçilir.

WARNING

Bu alan formda zorunlu işaretli değildir; ancak boş bırakılırsa koşul hiçbir eşleşme üretmez (arama yöntemi seçilmeden koşul devreye girmez). Kaydetmeden önce bir yöntem seçildiğinden emin olunmalıdır.

INFO

List

Karşılaştırma yapılacak değerler listesi girilir. Her satıra bir değer yazılır.

Liste Kullanım Formatı:

Format	Örnek	Açıklama
Tekli IPv4	192.168.1.100	Tek bir IP adresi
Tekli IPv6	2001:db8::1	Tek bir IPv6 adresi
CIDR IPv4	10.20.0.0/24	256 IP adresi (10.20.0.0 - 10.20.0.255)
CIDR IPv6	2001:db8::/32	IPv6 subnet
Çoklu Giriş	Her satıra bir girdi	Birden fazla girdi
Yorum Satırı	#10.10.10.100	# ile başlayan satırlar yoksayılır

IP/cidr match yönteminde listedeki her satır IP/CIDR doğrulamasından geçirilir; geçersiz satırlar (ör. alan adı, path) hata verilmeden sessizce yok sayılır.

Örnek Liste İçerikleri:

IP/CIDR

192.168.1.0/24
10.0.0.0/8
172.16.0.0/12

Path

/admin
/api/internal
/management

Domain

example.com
test.example.com
staging.example.com

INFO

Condition Description

Girilen kriter ve değerler doğrultusunda TR7 tarafından otomatik olarak oluşturulur.

Bu açıklama;

• Koşulun hangi değer için geçerli olduğunu,
• Hangi kriter üzerinden çalıştığını,
• Listeleme ekranlarında koşulun hızlıca anlaşılmasını

sağlayacak şekilde sistem tarafından dinamik olarak üretilir.

INFO

Form Butonları

Add

Add butonuna tıklanarak koşul ekleme işlemi tamamlanır.

Add & Repeat

Add & Repeat butonu ile koşul ekleme işlemi tamamlanır ve farklı konfigürasyonlarla ilgili pencereden çıkılmadan yeni bir koşul daha eklenebilir.

Koşul Eklendi

Operasyonel Kullanım Önerileri

• IP Whitelist/Blacklist. Güvenilir veya engellenmesi gereken IP adreslerini liste olarak yönetin.
• Path Bazlı Erişim Kontrolü. Belirli path'lere erişimi kontrol etmek için path listesi kullanın.
• Coğrafi Filtreleme. İstek yapan IP'ye ait ülke bilgisi değişkeni ile ülke bazlı erişim kontrolü yapın.
• Dinamik Değer Eşleştirme. Akıllı Değişkenler sayesinde herhangi bir trafik bilgisini listeyle karşılaştırın.