AGS Condition

AGS Condition Nedir?

AGS Condition koşulu, AGS - AAM (Application Access Management) tarafından sağlanan kullanıcı kimlik doğrulama ve oturum bilgilerini kullanarak trafik yönlendirme ve manipülasyon kararları almak için kullanılan özel bir koşul tipidir.

Variable typeAGS user groups

Text inclusion

Text to compareadmins

Kullanıcının AGS grup listesi "admins" içeriyorsa → koşul TRUE döner

Bu koşul sayesinde kullanıcı kimlik bilgilerine, rollerine ve oturum durumlarına göre dinamik trafik yönetimi yapılabilir.

WARNING

Bu koşul yalnızca HTTP vService'lerde kullanılabilir. Koşul, AGS yapılandırılmamış bir ortamda da tanımlanabilir; ancak değerlendirilecek AGS oturum verisi bulunmadığından bu durumda hiçbir zaman eşleşmez.

AGS Condition Koşulunun Önemi

AGS Condition, kullanıcı bazlı erişim kontrolü ve içerik kişiselleştirme için kritik bir araçtır.

AGS Condition sayesinde;

• Kimliği doğrulanmış kullanıcılar tespit edilebilir,
• Kullanıcı rollerine göre erişim kontrolü yapılabilir,
• Kullanıcı gruplarına göre farklı içerik gösterimi yapılabilir,
• Oturum durumuna göre yönlendirme yapılabilir,
• Kullanıcı özelliklerine göre dinamik davranışlar tanımlanabilir.

Desteklenen AGS Değişkenleri:

Değişken	Açıklama
AGS - is authenticated user	Kullanıcının AGS üzerinde kimliği doğrulanmış mı? (Boolean)
AGS session ID	Kullanıcıya ait aktif oturum kimliği
AGS user input	Kullanıcıdan alınan form veya giriş değeri
AGS user ID	AGS tarafından atanan kullanıcı kimliği
AGS username	Kullanıcı adı
AGS user e-mail address	Kullanıcının e-posta adresi
AGS user phone number	Kullanıcının cep telefon numarası
AGS user groups	Kullanıcının üye olduğu grup veya roller
AGS user attribute	AGS oturumundaki özel kullanıcı öznitelikleri (öznitelik adıyla okunur)

Desteklenen Operatörler:

Operatör	Açıklama
Text equality	Metin değerinin birebir eşleşmesini kontrol eder
Text inclusion	Metnin, belirtilen değeri içerip içermediğini kontrol eder
Text start	Metnin, belirtilen ifade ile başlayıp başlamadığını kontrol eder
Text end	Metnin, belirtilen ifade ile bitip bitmediğini kontrol eder
Text regex	Metnin, tanımlanan düzenli ifade (regex) ile eşleşip eşleşmediğini kontrol eder
Integer equality	Sayısal değerin belirtilen sayıya eşit olup olmadığını kontrol eder
Integer greater than	Sayısal değerin belirtilen değerden büyük olup olmadığını kontrol eder
Integer less than	Sayısal değerin belirtilen değerden küçük olup olmadığını kontrol eder
Integer range	Sayısal değerin tanımlı bir aralık içinde olup olmadığını kontrol eder
Boolean	Mantıksal (true/false) değerin durumunu kontrol eder
IP/cidr match	IP adresinin veya ağın (CIDR) belirtilen IP/CIDR bloğu ile eşleşip eşleşmediğini kontrol eder

Kullanılabildiği vService Tipleri

HTTP

L7 TCP

Network

Nasıl Eklenir?

Yeni bir AGS Condition, 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 AGS condition seçilir.
4. Koşula ait ilgili konfigürasyonlar yapılandırılır.
5. Add butonuna tıklanarak koşul eklenir.

AGS Condition Ekleme Formu

AGS Condition 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 AGS condition 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

Variable Type Varsayılan: AGS - is authenticated user

Karşılaştırılacak AGS değişkeni listeden seçilir. Alanda fx butonu bulunmaz; gerekirse alan üzerinde sağ tıklanarak açılan değişken penceresinden serbest bir akıllı değişken de girilebilir.

Kullanılabilir AGS Değişkenleri:

Değişken	Açıklama
AGS - is authenticated user	Kullanıcının AGS üzerinde kimliği doğrulanmış mı? (Boolean)
AGS session ID	Kullanıcıya ait aktif oturum kimliği
AGS user input	Kullanıcıdan alınan form veya giriş değeri; seçildiğinde ek AGS input variable alanı açılır ve girdi adı yazılır
AGS user ID	AGS tarafından atanan kullanıcı kimliği
AGS username	Kullanıcı adı
AGS user e-mail address	Kullanıcının e-posta adresi
AGS user phone number	Kullanıcının cep telefon numarası
AGS user groups	Kullanıcının üye olduğu grup veya roller
AGS user attribute	AGS oturumundaki özel kullanıcı öznitelikleri; seçildiğinde ek Attribute name alanı açılır ve öznitelik adı yazılır

Şifreli girdiler

AGS tarafında şifreli olarak işaretlenmiş kullanıcı girdileri (ör. parola alanları) bu koşulda okunamaz; böyle bir girdiye bağlanan koşul hiçbir zaman eşleşmez.

INFO

Operator Varsayılan: Text equality

Karşılaştırma yöntemi seçilir; seçilen operatör, altta açılacak değer alanını belirler.

Operatör	Açıklama
Text equality	Metin değerinin birebir eşleşmesini kontrol eder
Text inclusion	Metnin, belirtilen değeri içerip içermediğini kontrol eder
Text start	Metnin, belirtilen ifade ile başlayıp başlamadığını kontrol eder
Text end	Metnin, belirtilen ifade ile bitip bitmediğini kontrol eder
Text regex	Metnin, tanımlanan düzenli ifade (regex) ile eşleşip eşleşmediğini kontrol eder
Integer equality	Sayısal değerin belirtilen sayıya eşit olup olmadığını kontrol eder
Integer greater than	Sayısal değerin belirtilen değerden büyük olup olmadığını kontrol eder
Integer less than	Sayısal değerin belirtilen değerden küçük olup olmadığını kontrol eder
Integer range	Sayısal değerin tanımlı bir aralık içinde olup olmadığını kontrol eder
Boolean	Mantıksal (true/false) değerin durumunu kontrol eder; bu operatörde ayrıca değer alanı açılmaz
IP/cidr match	IP adresinin veya ağın (CIDR) belirtilen IP/CIDR bloğu ile eşleşip eşleşmediğini kontrol eder

INFO

Karşılaştırma Değeri Alanı Operatöre göre değişir

Karşılaştırmanın sağ tarafındaki değer, seçilen operatöre göre etiketi ve davranışı değişen bir alana girilir:

Operatör	Açılan Alan	Davranış
Text equality	Key to compare	Akıllı değişken destekli metin; fx butonu bulunur
Text inclusion / Text start / Text end	Text to compare	Düz metin (fx yok)
Text regex	Regex to compare	Düzenli ifade; yanındaki test aracıyla denenebilir
Integer equality / greater than / less than	Integer to compare	Akıllı değişken destekli sayısal değer; fx butonu bulunur
Integer range	Range start + Range end	Aralık için iki ayrı alan; ikisi de akıllı değişken destekler
Boolean	-	Değer alanı açılmaz; değişkenin doğru/yanlış durumu değerlendirilir
IP/cidr match	IP/cidr to compare	Ayrı IP ve CIDR girişleri (varsayılan CIDR: /24); ikisi de doğrulanır

Açılan alanların tümü zorunludur.

TIP

fx butonlu alanlar Smart Variables destekler; mevcut değişkenlere erişilerek dinamik içerik oluşturulabilir. Detaylı bilgi için Variables dokümanına bakılabilir.

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

• Oturum Kontrolü ile Başlayın. Her AGS koşulundan önce AGS - is authenticated user ile oturum durumunu kontrol edin.
• Rol Bazlı Erişim. AGS user groups veya AGS user attribute ile role, memberOf gibi öznitelikleri kullanarak rol bazlı erişim kontrolü yapın.
• Departman Bazlı Yönlendirme. Kullanıcı departmanına göre farklı Kurum Servislerine yönlendirme yapın.
• Öznitelikleri Kullanın. AGS user attribute ile oturumdaki özniteliklere (ör. department) bağlı dinamik davranışlar oluşturun.