Mesaj Oluşturucu

​

Genel Bakış

​

Amacı Nedir?

• Template ve form tabanlı mesaj oluşturarak değişken değerlerini hedef değişkenlere atamak.
• İstek veya yanıttaki body, header, query parametresi gibi kaynaklardan veri okuyup yeni değişkenler oluşturmak.
• JEXL expression’ları ile dinamik içerik üretmek ve birden fazla kaynaktan veri birleştirmek.
• Satır bazlı koşullu çalıştırma ile sadece belirli durumlarda değişken ataması yapmak.

​

Çalışma Prensibi

1. İstek Gelişi: API Gateway’e gelen HTTP/HTTPS isteği için MessageContext oluşturulur.
2. Politika Kontrolü: Mesaj Oluşturucu politikası aktif ise, sistem aşağıdaki sırayla kontrol yapar:
   • Condition (koşul) tanımlı mı? Varsa koşul sağlanıyor mu?
   • Politika aktif mi (active=true)?
3. Satır Zinciri Çalıştırma: Satır listesi (Row List) sırasıyla değerlendirilir. Her satır için:
   • Satır koşulu kontrol edilir (varsa).
   • Form modunda: Kaynak değişkenden değer okunur.
   • Template modunda: Şablon #{variable} syntax’ı ile işlenir, JEXL expression’lar evaluate edilir.
   • Sonuç hedef değişkene yazılır.
4. Boş Değer İşleme:
   • Değer boş ve Zorunlu=true ise hata fırlatılır.
   • Değer boş ise varsayılan değer kullanılır.
5. Hata İşleme: Hata Durumunda Devam Et aktifse satır atlanır ve sonraki satıra geçilir. Pasifse politika hata ile sonlanır.

​

Özellikler ve Yetenekler

​

Temel Özellikler

• İki Oluşturma Modu: Form modu (basit değişken kopyalama) ve Template modu (JEXL expression desteği ile dinamik içerik oluşturma).
• Satır Bazlı İşleme: Her satır bağımsız olarak yapılandırılabilir; kaynak, hedef, koşul, varsayılan değer ayrı ayrı belirlenir.
• Sürükle-Bırak Sıralama: Satır sırası sürükle-bırak ile kolayca değiştirilebilir.
• Aktif/Pasif Durum Kontrolü: Politikanın aktif veya pasif durumunu kolayca değiştirme. Pasif durumda politika uygulanmaz ancak yapılandırması saklanır.
• Koşul Bazlı Uygulama: Query Builder ile hem politika seviyesinde hem satır seviyesinde koşullar tanımlanabilir.

​

İleri Düzey Özellikler

• JEXL Expression Desteği: Template modunda #{expression} syntax’ı ile matematiksel, mantıksal ve string operatörleri kullanılabilir.
• Çoklu Değişken Kaynağı: Body (JSON/XML path), Header, Query/Path/Form parametreleri ve Context Variable’lardan veri okunabilir.
• Satır Seviyesi Hata Yönetimi: Her satır için Hata Durumunda Devam Et ve Zorunlu bayrakları ayrı ayrı ayarlanabilir.
• Export/Import Özelliği: Politika yapılandırmasını ZIP dosyası olarak export etme. Farklı ortamlara (Development, Test, Production) import etme. Versiyon kontrolü ve yedekleme imkanı.
• Policy Group ve Proxy Group Desteği: Birden fazla politikayı Policy Group içinde yönetme. Proxy Group’lara toplu politika atama. Merkezi güncelleme ve deploy işlemleri.
• Deploy ve Versiyonlama: Politika değişikliklerini canlı ortama deploy etme. Hangi API Proxy’lerde kullanıldığını görme (Policy Usage). Proxy Group ve Policy Group kullanım raporları.

​

Kullanım Senaryoları

​

Politika Parametrelerini Yapılandırma

​

Yeni Mesaj Oluşturucu Politikası Oluşturma

​

Yapılandırma Adımları

​

Satır Parametreleri

​

Template Syntax

#{body.$.userName}          → JSON body'den userName alanı
#{body.$[0].name}           → JSON array body'den ilk elemanın name alanı
#{body./root/name}          → XML body'den XPath ile değer
#{header.Authorization}     → Authorization header değeri
#{query.page}               → Query parametresi
#{form.username}            → Form parametresi
#{path.id}                  → Path parametresi
#{credential.clientId}      → Kimlik doğrulanmış credential anahtarı/kullanıcı adı
#{request.remoteAddress}    → İstemci IP adresi (yapılandırılmışsa yönlendirilmiş IP'yi yansıtır)
#{dateTime.formattedText}   → Formatlanmış tarih/saat (UTC, yyyy-MM-dd HH:mm:ss)

#{request.body.$.field}     → İstek body alanı (açık bölge belirtimi)
#{request.header.Name}      → İstek header değeri (açık bölge belirtimi)
#{response.body.$.data.id}  → Yanıt body alanı (açık bölge belirtimi)
#{response.header.Name}     → Yanıt header değeri (açık bölge belirtimi)
#{request.body./root/name}  → İstek body XPath (açık bölge belirtimi)
#{response.body./root/name} → Yanıt body XPath (açık bölge belirtimi)

#{myVar.$.user.name}                → Özel değişkenin JSON içeriği üzerinde JSONPath
#{myVar./root/element}              → Özel değişkenin XML içeriği üzerinde XPath
#{myVar./bookstore/book[1]/title}   → Özel değişken üzerinde predicate'li XPath

#{body.$.price * 1.18}                       → Fiyata KDV ekleme
#{body.$.firstName + ' ' + body.$.lastName}  → Ad ve soyad birleştirme
#{body.$.age >= 18 ? 'adult' : 'minor'}      → Koşullu değer
#{context.request.httpMethod == 'POST' ? 'create' : 'read'}  → HTTP metoduna göre işlem tipi
#{body.$.status == 'available' ? '{"label":"Satın Alınabilir"}' : null}  → JSON string üretimi

#{
  var out = '[';
  var first = true;
  for (item : body.$.tags) {
    if (!first) { out = out + ','; }
    out = out + '{"id":' + item.id + ',"name":"' + item.name + '"}';
    first = false;
  }
  out + ']'
}

#{
  var total = 0;
  for (item : body.$.items) {
    total = total + item.price;
  }
  total
}

#{
  var role = body.$.user.role;
  if (role == 'admin') {
    'TAM_YETKİ'
  } else if (role == 'manager') {
    'KISITLI_YETKİ'
  } else {
    'SADECE_OKUMA'
  }
}

#{dtf.format('+03:00')}                              → 2026-03-02 15:30:45
#{dtf.format('UTC')}                                  → 2026-03-02 12:30:45
#{dtf.format('+03:00', 'dd/MM/yyyy HH:mm:ss')}       → 02/03/2026 15:30:45
#{dtf.format('+03:00', 'yyyy-MM-dd HH:mm:ssXXX')}    → 2026-03-02 15:30:45+03:00
#{dtf.format('Europe/Istanbul')}                      → 2026-03-02 15:30:45
#{dtf.epochMillis()}                                  → 1740912645000

​

Politikayı Silme

​

Politikayı Dışa/İçe Aktarma

​

Politikayı API’ye Bağlama

​

İleri Düzey Özellikler

​

Best Practices

​

Yapılması Gerekenler ve En İyi Uygulamalar

​

Güvenlik En İyi Uygulamaları

​

Kaçınılması Gerekenler

​

Performans İpuçları

​

Sık Sorulan Sorular (SSS)