Versiyon tarihi: 1 Haziran 2022

Bu dokümanda 2022.06.1 versiyonuna ait Değişiklikler, İyileştirmeler ve Hata düzeltmeleri (Bug Fixes) bulunmaktadır.

Yeni özellikler

Elasticsearch Snapshot Ayarları (Backup Settings)

Tanımlı Elasticsearch Kümesindeki indekslerin belirlenen zaman aralığında otomatik olarak snapshot yani yedeklemesi (backup) yapılabilir. Bu ayar konfigüre edildiğinde küme üzerinden Snapshot Lifecycle Management (SLM) poliçesi tanımlanmış olur. Dolayısıyla başka bir eklentiye ihtiyaç duymadan kümede yedek ayarları yönetilebilir ve çalıştırılan yedeklerin sonuç bilgilerini içeren geçmiş bilgileri izlenebilir. İstendiği zaman snapshot alımı manuel olarak başlatılabilir. Detaylı bilgi ve kullanım için Elasticsearch Yedekleme Politikası sayfasına bakınız.

API Portal Ayarlarını/Sayfalarını Kişiselleştirme

API Developer Portal üzerindeki genel ayarlar (logo, başlık) ve sayfaların içerikleri veya bazı alanları(How It Works, SSS, Login, Register) isteğe bağlı olarak özelleştirilebilir. Bu sayede, Portal Yöneticisi istemcilerin kullanacağı içeriklerini kişiselleştirebilir. Böylelikle market dinamikleri ve ihtiyaçları göre içerik yönetimi yapılabilir.

Önemli değişiklikler ve iyileştirmeler

Kimlik Bilgisi (Credential) sayfasına Token Ayarları (Token Settings) eklenerek, kimlik doğrulama ayarlarının Kimlik Bilgisi bazında da yönetilebilmesi sağlandı. Bkz.
API Proxy içerisinde metot/endpoint düzenleme dialoguna yanıt içeriğine yapılacak işlemi yönetmek için "İndirmeyi Etkinleştir (Enable Download)" alanı ve "Sıkıştırılmış yanıt için (Accept-Encoding değerine göre) Text/ByteArray tipini kullan (Use Base64 Encoded Text/Byte Array For Compressed Response(by Accept-Encoding value))" seçeneği geldi. Bkz.
API Proxy ekranında Routing Adresine göre arama filtresi eklendi. Bkz.
API Proxy bazında log4j ayarına ait seviyenin değiştirilmesi sağlandı. Bkz.
Kimlik Doğrulama (Authentication) Politikaları'nın kolay kullanımı için ekran iyileştirmeleri gerçekleştirildi. Bkz1. Bkz2. Bkz3. Bkz4.
Test Konsolu üzerinden API Tanım dosyasından alınan örnek gövde (body) gösterimi iyileştirildi.
API Call Politikasının, İstek (Request) ve Original Message (Orijinal Message) alanlarına ait tüm bölümlerin görünümü düzenlendi. Gövde (Body) bölümlerinin kullanımı iyileştirildi. Bkz.
API Call Politikasının İstek (Request) bölümüne Cache ayarları getirilerek, seçilen değişkene göre istek sonucunun önbellekten getirilmesini sağlandı. Bkz.
API Proxy, Trace modda iken API Çağrısı (API Call) politikasının bilgilerinin loglanması sağlandı.
API Proxy içerisinde XML/JSON Hata Yanıt Şablonu (Error Response Template) ile hata mesajı veya API'den Dönen yanıt mesajı karakterlerini sınırlama yapan yeni değişken tanımları getirildi. Bkz.
API Proxy ve API Proxy Grup ekranlarındaki deployment bilgilerinin gösterimi geliştirildi. Bkz.
API Bazlı Kota (Quota) ve API Bazlı Daraltma (Throttling) ekranlarına "Apply by" değeri getirilerek, belirli bir değişken üzerinden bu politikaların çalışması sağlandı. Bkz1. Bkz2.
Değişkenler (Variables) ekranına "Context Value" tipi ve değerleri ile Parametre tipi için "Form" seçeneği eklendi. Bkz1. Bkz2.
Ağ Geçidi Ortam (Gateway Environment) ayarlarına, dosya yüklemeleri için multi-part HTTP isteklerine ait ayarları konfigüre etmek için yeni anahtar kavramlar eklendi. Bkz.
Projeler sayfasındaki üyelerin ve rollerin görünümü yenilendi. Bkz.
XML Transformer ve JSON Transformer ekranlarına ait hata mesajlarının gösterimi iyileştirildi.
LDAP bağlantı tanımı ve LDAP Identity Provider ekranlarındaki hata mesajlarının gösterimi iyileştirildi.
API Proxy'nin Geliştirme (Development) tabında endpointler/metotlar bölümüne hızlı arama özelliği getirildi. Bkz.
Uygulama Logları (Application Logs) ekranındaki Gateway Engine'e ait loglar üzerinde "Correlation ID"ye göre filtreleme seçeneği eklendi. Bkz.
Token Requests ekranında Username or Key bilgisinin görüntülenmesi sağlandı. Filtreleme seçeneklerine API Proxy, Username or Key ve Status Code Bigger Than alanları eklendi. Bkz.
Deployment adres bilgisi üzerinden Swagger ve OpenAPI tanım dosyalarına erişim için yeni metotlar eklendi. Bkz.
API Proxy Grup'un API tanım dosyasına (API Definition Document) ve API tanım bilgisinin arayüzünü görüntüleme özellikleri eklendi.
SOAP2Rest dönüşümlerinin konfigürasyonlarının yapıldığı ekranda ayarlara göre oluşan Yanıt Mesajının görüntülenebilmesi sağlandı.
Ortam ayarlarında HTTPs sonlandırma için kullanılacak olan keystore dosya tiplerine PKCS12 tipinde olup PFX uzantısına sahip olan dosyalar için de izin verildi. Bkz.
Key Stores ekranındaki eklenmiş konfigürasyonlarının düzenlenmesi sağlandı. Bkz.
"isByteArrayContent" değerlerini yönetmek için Ön Tanımlı Değerler (Predefined Variables) menüsüne Byte Array Content Types sayfası yapıldı. Bkz.
Önbellek Monitörü (Cache Monitoring) ekranında API Proxy Grup ve API Çağrısı için gerekli seçenekler eklendi. Bkz.
Swagger ve Open API formatındaki API Specification bilgilerine kimlik doğrulama (authentication) bilgisi eklendi.
API Proxy ayrıştırıldığında (reparsing), ad ve açıklama bilgileri artık original API Proxy'den getirildi.
Seçili API Proxy Group sayfası üzerinden, tüm API'lerin endpoint'lerini swagger arayüzünde görüntüleme imkanı verildi.
API Proxy Grup ile API Product oluşturma imkanı verildi.
API Proxy Grup ayarlarının API Proxy'lere uygula özelliği aktifleştirilse, içerisindeki tüm API Proxy'lere uygulanacak olarak ayarların (CORS, Log Settings, XML/JSON Error Response Template, Forwarded IP Header Parameter ve Log Settings) API Proxy Grup ekranından yönetme olanağı sağlandı.
API Proxy, API Proxy Grup olarak eklendiyse ilgili API Proxy deployment bilgilerine ek olarak API Proxy Gruba ait deployment bilgilerininde listelenmesi sağlandı.
Gateway Instance oluştururken, ilgili ortamın hangi Kubernetes worker sunucusu üzerinde çalışacağı seçimi eklendi.
Mock API tanımı düzenlenirken bir endpoint'e birden fazla örnek yanıt (example response) ekleme özelliği geliştirildi.
Proje bazında çalışan ve Kimlik Yönetimi (Identity Management) bölümünü yönetmek için API Security rolü eklendi.
API Trafik loglarını gösteren listeler ve log detaylarının görüntülendiği dialog alanlarına yenileri eklendi. Filtreleme kriterlerine metot adı eklendi.
WS-Security to Target poliçesinde Signature bölümüne "Signature Digest Algorithm, Use Single Certificate" alanları ve Encryption bölümüne "Key Identifier Type, Custom Identifier Type, Custom Identifier Type Value Type" alanları eklendi.
Silinen Elasticsearch Cluster tanımının ILM Poliçe ve Template bilgileri başka bir küme içinde de kullanılabilir hale getirilmesi için "Log Key" alanı düzenlenebilir yapıldı. Bunun dışında, kümelerin listelendiği ekran üzerindeki ILM ve Template durumlarını gösteren kutulara tıklandığında ilgili ILM ya da Template durumu güncellenebilir hale getirildi.
Sadece local bazlı oluşturulan API Bazlı Kota ve Backend API Authentication politikaları Global Polices menüsü üzerinden global bazlı olarak oluşturulabilir.
Yedekleme yapılırken seçilen MongoDb koleksiyonları hariç tutulabilir. Böylece log için tutulan kayıtların yedek dosyasına alınmaması sağlanarak yedek dosyası büyüklüğü kontrol edilebilir.
Ortam Ayarları (Environment Settings) sayfasındaki JWT bilgisinin üretilmesiyle ilgili 2 işlem eklendi; token'ı yeniden oluşturup yükleme ve private key bilgisini dosyadan alıp token'ı üretip yükleme.
SOAP türündeki API Proxy için metot bazında güncellenebilecek WSA ayarına "SOAP Action" alanı eklendi.
Privacy Management üzerindeki genel ayarların API Proxy dışında gelen isteklere de uygulanması sağlandı. Böylece istekler yanlış adrese gönderilse bile sahip olduğu hassas veriler korunmaktadır.

Hata düzeltmeleri (Bug Fixes)

Issue No	Açıklama
APNZ-3004	Ağ Geçidi Ortamları (Gateway Environment) yeniden yayınlama ya da yayınlama yapıldığında HTTPS için kaydedilmiş şifreyi tekrar şifreleniyor.
APNZ-2903	Boşluk içeren Path parametresi API'ye yanlış gönderiliyor.
APNZ-2976	Sorgular (Queries) sayfası üzerinden keyword kriteri ile parametre ve header kısmı için arama yapma çalışmıyor.
APNZ-2974	Test Konsolu (Test Console) üzerindeki API Tanım dosyasındaki "example" boş ise "examples" içindeki API tipine göre seçim yapılmalıdır.
APNZ-2963	DB2API ile oluşturulan StoredProcedure tipindeki metoda API Proxy üzerinden istek gönderildiğinde, yanıttaki büyük sayılarda format bozuk olarak geliyor ve bilimsel notasyonlu görünüyor.
APNZ-2956	API Proxy'nin Tasarım (Design) tabından oluşturulan örnek istek gövdesi test konsola gelmiyor.
APNZ-2955	API Proxy'nin Tasarım (Design) tabından örnek istek ve yanıt gövdesi oluşturulmak istendiğinde hata oluşuyor.
APNZ-2952	WSDL türünden eklenen web servislerin parametre bilgileri test konsola gelmiyor.
APNZ-2948	Rest2SOAP Protokol Dönüştürme (Protocol Transformation) kayıt edildikten sonra değişiklikler, Tasarım (Design) tabına yansımıyor.
APNZ-2947	KPS servislerine ait WSDL parse edilirken hata fırlatıyor.
APNZ-2943	Ağ Geçidi Ortamları (Gateway Environment) üzerinde yapılan herhangi bir düzenleme pod seçimini "hepsi" olacak şekilde bozuyor.
APNZ-2933	API Proxy'nin Trace tabındaki logların yanıt hattındaki politikaların işlem sırası tam tersi gösteriliyor.
APNZ-2931	Veri Tabanı Kimlik Sağlayıcısı'nda(Database Identity Provider) deneme yaparken username ve password alan değerleri yanlış kullanılıyor.
APNZ-2930	DB-2-API'deki örnek mesaj değerleri, API Proxy oluşturulup, test edilmek istendiğinde otomatik olarak gelmiyor.
APNZ-2923	API Proxy Grup’da eklenen poliçe kaldırıldığında, durum bilgisi deployed olarak kalıyor.
APNZ-2899	API Design ekranından metoda tıklandığında hata alınmaktadır.
APNZ-2895	API Proxy'ye local politika içe aktarıldığında (import) hata oluşuyor.
APNZ-2983	Metot/endpoint eklendiğinde ya da güncellendiğinde, API Proxy akış yapısındaki politika ikonu kayboluyor.
APNZ-2881	API Proxy Grup'da Apinizer hata mesaj şablonlarını kullanmıyor.
APNZ-2880	CORS eklendiğinde, HTTP metodu Options dışında gelen isteklere ait yanıtların durum kodları bozuluyor.
APNZ-2876	API Spec bilgisi Swagger 2.x formatı olarak görüntülendiğinde hatalar görülmektedir.
APNZ-2873	API Proxy Trafik ekranındaki sayfalama komponenti kaybolmaktadır.
APNZ-2870	JWT Token alım mesajında Content-Type "application/x-www-form-urlencoded;charset=UTF-8" gönderilirse hata dönüyor.
APNZ-2868	WSDL için üretilen Open API formatındaki specification bilgilerinde bazı servislerde modeller gelmiyor.
APNZ-2864	Kimlik Bilgileri (Credentials) menüsü üzerinden herhangi bir kimlik bilgisinin API Proxy Erişim Kontrol Listesi (EKL) listesine API Proxy'i eklendiği dialogda, proje gibi filtre seçimi sayfalama yapmadan listeye yansımıyor.
APNZ-2862	API Proxy Grup birden fazla ortama yüklü olduğu durumda, eğer biri redeploy (yeniden yükle) edilirse, diğerleri redeploy required duruma düşüyor.
APNZ-2861	JWT Token yanıtlarındaki time alanlarının ISO 8601 formatında değil.
APNZ-2855	Rest2Soap tipindeki API Proxy'nin Tasarım (Design) tabı üzerinden örneği değiştirildiğinde, bu durum Swagger dokümantasyonuna ve Test Console'a yansımıyor.
APNZ-2846	Mock API'de aynı endpoint'e aynı durum koduyla birden fazla yanıt oluşturulabiliyor.
APNZ-2841	API Proxy sayfasının Yönlendirme tabı üzerinde koşul eklerken "does not contain" fonksiyonu seçili olsada koşulu güncellerken bileşen içinde gözükmüyor.
APNZ-2836	API Integration çalıştırıldığında sadece bir sonuç getiriyor.
APNZ-2829	SOAP web servisi REST API olarak oluşturulmak istendiğinde protokol dönüşümü sırasında yapılan değişikler Tasarım'a yansımıyor.
APNZ-2828	Rest-to-SOAP tipindeki API Proxy'lerde Jackson Transformation üzerinden değişik yapıldığında, Test Konsol'a otomatik gelmiyor.
APNZ-2826	API Proxy yeniden ayrıştırıldığında çıkan dialogda yazılar yanlış gözüküyor.
APNZ-2824	API Portal üzerinden API'nin dokümanı ile uç nokta test edildiğinde CSP hatası veriyor.
APNZ-2819	Open API üzerinden API Proxy oluşturulmak istendiğinde hata veriyor.
APNZ-2818	API Proxy'i dosya yükleyerek oluşturulmak istendiğinde açılan dialogdaki dosya bileşeni hata veriyor.
APNZ-2805	DB-2-API'den birden fazla API Proxy oluşturulduğunda DB-2-API ekranı üzerindeki tüm API Proxy yükle butonu çalışmıyor.
APNZ-2797	Test Konsolundaki Log tabı hata veriyor.
APNZ-2788	Open API dokümantasyonu example bölümü düzgün gelmiyor.
APNZ-2787	API Proxy Şablonu ekranında Kimlik Doğrulama poliçesi eklendiğinde çöküyor.
APNZ-2783	Test Konsolu üzerindeki Koleksiyon tabı ile Koleksiyon Listesindeki koleksiyon listesi aynı gelmiyor.
APNZ-2782	WS-Security poliçesine ikinci bir Key Store tanımı eklenmiyor.
APNZ-2763	Routing'te koşul hatası; koşullu yönlendirme eklendiği zaman query parametrelere göre ayırt edemiyor.
APNZ-2760	API Proxy ACL üzerinden bir API Proxy'e çok fazla sayıda kimlik bilgisi (credential) eklendiğinde ya da tablonun farklı sayfaları üzerinde seçim yapıldığında düzgün çalışmıyor. Ek olarak, kimlik bilgisi seçimi yapılan dialogda filtreler silindikten sonra eklenmiş kimlik bilgileri tekrar seçilebiliyor.
APNZ-2756	Empty API tipindeki API Proxy'nin endpoint ekleme ve düzenleme işlemleri Design tabı ya da Develop tabında yapıldığında, buradaki değişimler ilgili path'in alanlarına ait (Backend Path, Name, Description) verilerin senkron çalışmamasına sebeb olmaktadır.
APNZ-2723	API Proxy Grup kayıt edildikten ya da yeniden yükle (redeploy) edildikten sonra API Proxy'ler redeploy moda geçiyor.
APNZ-2749	Mock API'ye endpoint eklerken Response Informationdaki varsayılan yanıtın gövdesi düzenlenerek kayıt edilmiştir. Sonrasında bu yanıt görüntülenmek istediğinde bu bilgi verilen değer ile değişmediği görülmüştür.
APNZ-2744	API'nin spec dosyasını yükleyerek API Proxy oluşturmak istenirken input alanında birden fazla dosya işlemi yapıldığında bu input takılı kalıyor, atanan veri değişmiyor.
APNZ-2742	API Call Poliçesinde Modify Original Message alanında "Use a variable" seçilip kaydedildiğinde bile "Specify the Value" seçeneği seçili geliyor.
APNZ-2741	Digest Kimlik Doğrulama poliçesinde Identity/Role/Group Service alanına ait değer seçilemiyor.
APNZ-2572	Test Konsolunda farklı ortamlara ait aynı isimli sertifikalarda seçim yapılırken hangi sertifika hangi ortama ait belli olmuyor.