Skip to main content
Bu doküman spesifik bir politikanın detaylı kullanımını anlatır. Eğer Apinizer politika yapısını ilk kez kullanıyorsanız veya politikaların genel çalışma prensiplerini öğrenmek istiyorsanız, öncelikle Politika Nedir? sayfasını okumanızı öneririz.

Genel Bakış

Amacı Nedir?

  • Backend API’den dönen mesajın içindeki başlık (header), parametre (parameter) veya gövde (body) alanlarını veya değerlerini koşullu olarak değiştirir veya siler.
  • Farklı kullanıcı tiplerine göre yanıt özelleştirmesi yaparak, her kullanıcı tipi için ayrı API oluşturma ihtiyacını ortadan kaldırır.
  • Mesaj içeriğindeki hassas bilgileri maskeleyerek veya kaldırarak veri gizliliği sağlar.
  • Koşul bazlı eylemlerle esnek veri manipülasyonu yapar, numerik, metin ve zaman veri tiplerinde çeşitli operatörler kullanır.

Çalışma Prensibi

  1. Yanıt Alınması: Backend API’den dönen mesaj API Gateway’e ulaşır.
  2. Politika Kontrolü: Veri Değiştirme 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)?
    • Kural kümeleri tanımlı mı?
  3. Kural Değerlendirmesi: Her kural kümesi için:
    • Değişken varlığı veya değişken değeri kontrolü yapılır.
    • Koşul sağlanırsa, tanımlı eylemler sırasıyla uygulanır.
  4. Eylem Uygulama:
    • Değiştir (Modify): Seçilen alanın değeri, veri tipine göre operatör kullanılarak değiştirilir.
    • Sil (Delete): Seçilen alan veya değer mesajdan kaldırılır.
  5. Sonuç: Özelleştirilmiş yanıt istemciye iletilir.

İş Kuralı Politikası ile Farkları

Mesaj içerisinde veri dönüşümü yapıldığı için İş Kuralı politikası (Business Rule) ile karıştırılabilir. Bu iki politika arasındaki farklar;
  • İş Kuralı politikası hem istek hattına hem de yanıt hattına eklenirken, Veri Değiştirme politikası sadece yanıt hattına eklenmektedir.
  • İş Kuralı politikasında doğrudan eylemler (Ekle, Değiştir, Sil, Akışı Kes) tanımlanabilirken, Veri Değiştirme politikasında belirli bir alan ya da alanın değeri ile karşılaşıldığında eylemler (Değiştir, Sil) tanımlanır.

Özellikler ve Yetenekler

Temel Özellikler

  • Koşullu Veri Manipülasyonu: Değişken varlığı veya değişken değerine göre mesaj içeriğini dinamik olarak değiştirir veya siler.
  • Çoklu Veri Tipi Desteği: Numerik, metin ve zaman veri tiplerinde çeşitli operatörlerle işlem yapar.
  • Esnek Eylem Tanımlama: Bir kurala birden fazla eylem eklenebilir, eylemler sırasıyla uygulanır.
  • Değişken Bazlı Erişim: Mesajın başlık, parametre veya gövde alanlarına değişkenlerle erişim sağlar.
  • Aktif/Pasif Durum Kontrolü: Politikanın aktif veya pasif durumunu kolayca değiştirme (active/passive toggle). Pasif durumda politika uygulanmaz ancak yapılandırması saklanır.
  • Koşul Bazlı Uygulama: Query Builder ile karmaşık koşullar oluşturarak politikanın ne zaman uygulanacağını belirleme (örn: sadece belirli endpoint’lere veya header değerlerine göre).

İleri Düzey Özellikler

  • Gelişmiş Metin İşlemleri: Base64 encode/decode, mask, format, substring, replace, transform gibi metin manipülasyon operatörleri.
  • Matematiksel İşlemler: Numerik değerlerde toplama, çıkarma, çarpma, bölme, mod alma, üs alma işlemleri.
  • Zaman Manipülasyonu: Zaman değerlerine ekleme veya çıkarma işlemleri.
  • XSLT ve JOLT Dönüşümleri: Transform operatörü ile XML ve JSON dönüşümleri yapabilir.
  • 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

Bu adımda, kullanıcı yeni bir politika oluşturabilir ya da mevcut politika parametrelerini yapılandırarak veri manipülasyon kurallarını belirleyebilir. Tanımlanan parametreler, politikanın çalışma şeklini (örneğin hangi alanların değiştirileceği, hangi koşullarda eylem yapılacağı, koşullu aktivasyonlar vb.) doğrudan etkiler. Bu sayede politika hem kuruma özel gereksinimlere göre özelleştirilebilir hem de merkezi olarak yönetilebilir.

Yeni Veri Değiştirme Politikası Oluşturma

Yapılandırma Adımları

Kural ve Eylem Detayları

Kural Oluşturma

Kural, yanıtın neye göre düzeltileceğini belirten kriterdir. Eylem ise bu kriter ile karşılaşıldığında mesajda yapılacak düzenleme işlemidir. Bir kurala birden fazla eylem eklenebilir. Verilen eylem sırasına göre mesaj özelleştirme yapılır. Ek olarak, politikada birden fazla kural olabilir. Kural konfigürasyonu için kullanılan alanlar aşağıdaki tabloda görülmektedir.

Eylem Oluşturma

2 tip eylem seçilebilir:
  • Değiştir (Modify): İsteğin/yanıtın başlık, parametre veya gövdesi içerisinde var olan bir alanın değeri değiştirilir.
  • Sil (Delete): İsteğin/yanıtın başlık, parametre veya gövdesi içerisinde var olan bir alanın değeri veya alanın tamamı silinir.

Düzenleme Eylemi

Mesajın, başlık, parametre ya da gövdesindeki değeri değiştirmek için kullanılır. Bu eylem seçildiğinde mesajda eklenmek istenen değerin olduğu varsayılır, bulunamaması durumunda politika hata verir. Kuralın koşul kısmında buna dikkat edilmelidir. Düzenleme eylemi konfigürasyonu için kullanılan alanlar aşağıdaki tabloda görülmektedir.
Veri Tipi ve Operatörler
Veri tipi (Variable Data Type) ve bu veri tiplerine ait işlemler (Operator) şunlar olabilir:

Silme Eylemi

Mesajın, başlık, parametre ya da gövdesindeki değeri silmek için kullanılır. Bu eylem seçildiğinde mesajda silinmek istenen değerin olduğu varsayılır, bulunamaması durumunda politika hata vermez, diğer işlemlere devam edilir. Mesajın neresinin silineceği değişken ile belirtilir. Koşullar ve Hata Mesajı Özelleştirme panellerinin açıklaması için Politika Nedir? sayfasındaki Koşullar ve Hata Mesajı Özelleştirme (Error Message Customization) bölümlerini inceleyebilirsiniz. Hata mesajı yapılandırmasının tüm katmanları, öncelik sırası ve senaryo örnekleri için Hata Mesajı Yapılandırma Rehberi sayfasına bakın.

Politikayı Silme

Bu politikanın silme adımları ve kullanımdayken uygulanacak işlemler için Politika Yönetimi sayfasındaki Akıştan Politika Kaldırma bölümüne bakabilirsiniz.

Politikayı Dışa/İçe Aktarma

Bu politikanın dışa aktarma (Export) ve içe aktarma (Import) adımları için Export/Import sayfasına bakabilirsiniz.

Politikayı API’ye Bağlama

Bu politikanın API’lere nasıl bağlanacağına ilişkin süreç için Politika Yönetimi sayfasındaki Politikayı API’ye Bağlama bölümüne bakabilirsiniz.

İ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)