Versiyon tarihi: 31 Ocak 2025

Bu dokümanda 2025.01.0 versiyonuna ait Yeni Özellikler, Değişiklikler, İyileştirmeler ve Hata Düzeltmeleri (Bug Fixes) yer almaktadır.

Öne Çıkan Yeni Özellikler

APNZ-4085 Yeni API Proxy Tipleri: gRPC ve WebSocket

API Proxy oluşturma seçeneklerine iki yeni tip eklendi: gRPC, WebSocket. Bkz.

gRPC Proxy Desteği:

Unary gRPC çağrıları (istemci tarafından tek istek, sunucu tarafından tek yanıt)
Server streaming gRPC çağrıları (istemci tarafından tek istek, sunucu tarafından çoklu yanıt akışı)
Client streaming gRPC çağrıları (istemci tarafından çoklu istek akışı, sunucu tarafından tek yanıt)
Bidirectional streaming gRPC çağrıları (hem istemci hem sunucu tarafından çift yönlü veri akışı)
gRPC-Web desteği (tarayıcı tabanlı gRPC iletişimi için)
TLS/SSL güvenli bağlantı desteği

WebSocket Proxy Desteği:

Standard WebSocket protokolü (ws://)
Güvenli WebSocket protokolü (wss://)
Text mesaj formatı
Binary mesaj formatı

Bu iki yeni tipte oluşturulan API Proxyler üzerinde politikalar kısmi olarak çalıştırılabiliyor, gelen ve giden mesajlar log konnektörlerine gönderilebiliyor.

Test konsolu henüz bu iki protokolü desteklemiyor

Yeni API Proxy Tiplerine Uygun Yeni Ortamlar (Environments)

Ortamlara "İletişim Protokolü Tipi" alanı getirildi. API Proxy'lerin deployment ortamları, proxy türlerine göre otomatik olarak eşleştirilecek şekilde düzenlendi. REST ve SOAP API Proxy'ler HTTP tipi ortamlara, gRPC API Proxy'ler gRPC tipi ortamlara ve WebSocket API Proxy'ler WebSocket tipi ortamlara deploy edilebilir hale getirildi. Bu güncelleme ile proxy türü ve deployment ortamı uyumluluğu garantilenerek yanlış ortam seçimlerinin önüne geçildi. Bkz.

Desteklenmeyen Politikalar/Ayarlar: Ws Security Sts Token, mTLS Authentication, Script, Backend API Authentication, API Call, API Proxy Grup, CORS Settings, Cache Settings, XML/ JSON Error Response Template, Load Balancing Type, Define Circuit Breaker, Define Client Flow Banner, Define Proxy Server, NTLM Settings, Customize Error Messages

APNZ-4582 IP Kontrolü ile Geolocation Yönetimi

IP kontrollerini Geolocation verisine (Ülke,İl) göre kontroller yapılabilmesi sağlandı. Bkz.

DİKKAT! Bu değişiklik ile tutulan log veri yapısı değiştiğinden Elastic search kullanan kurumların log index template'ini güncelleyip, rollover index yapmaları gerekmektedir. Yeni index yapısı için bu sayfayı ziyaret edebilirsiniz.

APNZ-4682 Ayarlar Grubu Yönetimi

Ayarlar Grubu ekranı ile hem API Proxy'e hem de API Proxy Grubuna Global Ayarlar oluşturulup atanabilmesi sağlandı. Bkz.

APNZ-4683 Politika Grubu Yönetimi

Politika Grubu ekranı ile hem API Proxy'e hem de API Proxy Grubuna Politika Grubu oluşturulup atanabilmesi sağlandı. Bkz.

Bu geliştirme ile Politika Görüntüleme ekranlarının yapısı ileride readonly kullanıcının erişimine izin verilecek şekilde yeniden tasarlandı.

APNZ-4762 APNZ-4784 Deploy İşlemleri Senkronizasyonu ve Sonuç Gösterimi Geliştirmesi

Tüm Deploy işlemlerininin detaylı bir şekilde sonucunun gösterilmesi sağlandı. Bkz.

DİKKAT! Bu geliştirme ile kubernetes servisi üzerinden gerçekleştirilen pod dağıtım süreçleri için kapsamlı bir iyileştirme yapıldı. Önceki versiyonda, Manager'dan Worker'a gönderilen deployment işlemlerinde, Worker kendi ortamındaki diğer pod'lara bu deployment'ı asenkron olarak broadcast ediyordu. Bu yapı nedeniyle Worker'ın diğer pod'lara deployment'ı başarılı bir şekilde yapıp yapmadığı Manager ekranında doğrudan görüntülenemiyor, olası hatalar sadece sistem loglarından tespit edilebiliyordu. Ayrıca pod'ların namespace içindeki dağıtım durumları anlık olarak takip edilemediğinden, erişilemeyen pod'lar sistemde tutarsızlıklara yol açabiliyordu.

Yeni geliştirme ile tüm deployment süreci senkron hale getirildi. Manager ve Worker arasındaki iletişim güçlendirildi, böylece herhangi bir pod'a erişim sağlanamadığında hatalar anında yakalanıp Manager ekranında görüntülenebiliyor. Kubernetes servisi üzerinden yapılan tüm pod dağıtım işlemlerinin sonuçları artık detaylı bir şekilde kullanıcı arayüzünde raporlanıyor. Bu iyileştirmeler sayesinde deployment sürecinin şeffaflığı artırıldı, hataların daha hızlı tespit edilmesi ve yönetilmesi kolaylaştırıldı. Not edilmesi gereken bir nokta, önceden kısmen asenkron olan sürecin tamamen senkron hale getirilmesi nedeniyle deployment sürelerinde bir miktar artış gözlemlenebilir.

Yeni Özellikler

APNZ-4778 API Portal için Yapay Zeka Destekli Chatbot Entegrasyonu

API Portal'e yapay zeka destekli bir chatbot entegresi sağlandı. Bkz.

APNZ-4731 API Portal için Destek Paket Talepleri Yönetimi (Support Package Request)

API Portal Manager'a, destek paketi taleplerinin kolayca yönetilebilmesi için "Support Package Request" ekranı eklendi. Bkz.

APNZ-4724 API Portal için Destek Paketlerinin Görüntülenmesi ve Yönetilmesi (Support Package Feature)

API Portal'a, destek paketlerinin görüntülenip yönetilebilmesi için "Support Package Feature" ekranı eklendi. Bkz.

APNZ-4722 API Portal için Destek Paketi Türlerinin Yönetimi (Support Package Type)

API Portal'a, destek paketi türlerinin yönetilebilmesi için "Support Package Type" ekranı eklendi. Bkz.

APNZ-4721 API Portal için Destek Paketleri Yönetimi (Support Package)

API Portal'a, destek paketlerinin yönetilebilmesi için "Support Package" ekranı eklendi. Bkz.

APNZ-4713 API Portal için Jira Entegrasyonu

API Portal'a Jira entegrasyonu eklendi. Kullanıcılar'ın, taleplerini doğrudan API Portal üzerinden oluşturup, Jira sistemi üzerinden kolayca takip edilebilmesi sağlandı. Bkz.

APNZ-4712 API Portal Yönetici Paneli için Jira Entegrasyonu

API Portal Yönetici paneline Jira entegrasyonu eklendi, bu sayede kullanıcılar Jira üzerinden talepleri yönetebilir ve izleyebilir. Bkz.

APNZ-4698 API Portal için Çerezler Yönetimi

API Portal'a çerezler yönetimi eklendi. Bkz.

APNZ-4826 API Portal için API Product Update - Uygulama Oluşturma Butonu

API Portal'de API Product update bölümüne kullanıcının hiç uygulaması yoksa uygulama oluşturabilme butonu eklendi. Bkz.

APNZ-3089 WSDL tanım dosyaları Zip formatında indirilebilmesi sağlandı.

APNZ-4649 API Proxy'lere bakım modu özelliği eklendi. Bkz.

APNZ-4783 Deployment süresi için timeout değerleri, parametrik olarak yapılandırılabilir hale getirildi. Bkz.

APNZ-4728 TLS ayarları JVM parametreleri ile parametrik verilebilir hale getirildi.Bkz.

APNZ-4844 Log yapısına location verisi eklendi. Bu veri içerisinde latitude (enlem) ve longitude (boylam) alanları bulunmaktadır. Bkz.

Önemli Değişiklikler ve İyileştirmeler

APNZ-4734 Global politikalar, politika grupları ve Ayar grupları kullanan API Proxy ve API Proxy gruplarına "Redeploy All" seçeneği eklendi. Bkz1, Bkz2, Bkz3.

APNZ-4693 Portal'deki ayarlar ve font'ların yüklenmesi, sistem ilk açıldığında otomatik olarak yapılacak şekilde düzenlendi.

APNZ-4765 Yeni API Proxy oluşturulurken, Routing kısmındaki "Ignore Error Response Template In Case Of Error On Backend API" parametresinin varsayılan değeri false olarak ayarlandı.

DİKKAT! Bu değişiklik, backend hatası durumunda güvenlik açığı oluşmasını engelleyerek, hata yanıtının error response template ile dönmesini sağlamaktadır.

APNZ-4770 API Traffic log, Test Konsolu Yanıt Logu, AuthToken Kayıt Logu ve Trace Log’larındaki verilerin formatlı gösterimi, yanlış yorumlanma riskini önlemek amacıyla kaldırıldı. Bu değişiklik ile logların olduğu şekilde sunulmasını sağlandı.

APNZ-4793 API Portal API Product sayfasındaki başlık ve açıklama kısmı dinamik hale getirildi.

APNZ-4573 API Proxy Grup endpoints sekmesinde undeployed durumundaki environment'lar için test butonu kaldırıldı. Bkz.

APNZ-4575 Admin Projects sayfasındaki listede Members and Roles kaldıldı, Tabloya Relative Path aktif, pasif durumu ve var ise Relative Path'i eklendi. Bkz.

APNZ-4827 API Portal'de Try It butonu görünmesi her API Product için dinamik hale getirildi. Bkz.

APNZ-4714 API tarafından dönen response'lar için desteklenen Content-Encoding değerleri genişletildi. Önceden yalnızca gzip, deflate ve br desteklenirken, artık gzip, deflate, br, compress ve zstd encoding tipleri de desteklenmesi sağlandı.

Hata Düzeltmeleri

APNZ-4755	Test console ikinci defa açıldığında düzgün açılmıyor.
APNZ-4746	API Portal'de product veya responsible gibi değerler silindiğinde, null hatası nedeniyle sayfalar açılmıyor.
APNZ-4737	Test konsolu sağ üstteki çarpıdan kapatılırsa, bir sonraki test endpoint isteğinde body alanı yüklenmiyor.
APNZ-4720	API Proxy export'ları boş zip dosyası olarak export ediliyor.
APNZ-4697	Her gece saat 1'de uygulama loglarını silen job kaldırılmalı, çünkü bu durum app purge jobs'un düzgün çalışmasını engelliyor.
APNZ-4626	API Proxy'den export edilen politikalar Politika Grup 'a import edilemiyor.
APNZ-4204	CORS'ta Access-Control-Allow-Origin değerlerinden silme işlemi sırasında yanlış değer siliniyor.
APNZ-4702	Export/Import menüsünde tekrarlanan export seçeneği görünüyor.
APNZ-4780	Groovy'de mail importunda yanlış kütüphane geliyor.
APNZ-4771	API trafik log ekranında tablar arasında geçiş yapıldığında, body alanı tıklanmadan güncellenmiyor.
APNZ-4752	Politikalar ile ilgili hatalar; Script Politikasında Groovy script kaydedilirken, script tipi doğru kaydedilmiyor. Business rule’da yeni kural eklerken, variable seçimi arkaya kayıyor ve cancel sonrası sayfa kilitleniyor. Trace’te API Call’ların bazıları birden fazla görünüyor. Politika kaydedildikten sonra 'Updated' yazısı iki defa görünüyor. Konsolda hata olmamasına rağmen, hata mesajları readonly ekrana yansımıyor.
APNZ-4741	Backend'den dönen SOAP mesajı logda tamamlanıyor.
APNZ-4714	Accept-Encoding başlığında 'zstd'kodlaması kullanıldığında, response'taki içerik doğru şekilde kodlanamıyor ve içerik bozuluyor.
APNZ-3933	API Proxy üzerinden export edilen politikalar, Proxy Groubuna import edilemiyor.
APNZ-4756	Mock Proxy'sinde, ilk metotta önceden kayıtlı çalışan ve loglara göre hala çalışmakta olan API Call'larda hata alınıyor. Ekranda ilgili hata mesajları yüklenmiyor ve loglarda bu durum 404 hatası olarak düşüyor.
APNZ-4790	Test konsolunda header ekleme kısmında açılan "name" ve "value" modal'ı arka planda açılıyor.
APNZ-4787	API Call'da "one way" seçilip "two way"e geçildiğinde, "not change default" seçeneği varsayılan olarak işaretli gelmiyor, aktif olmuyor.
APNZ-4822	Multipart/form-data ile dosya gönderilirken, dosya içeriği gönderilmediğinde ilgili part verisi backend'e gitmiyor.
APNZ-4815	Script'te Yeni Eklenen Context Values'lar eksik görünüyor.
APNZ-4812	API Manager'da Portal Account'lar arama filtreleri çalışmıyor.
APNZ-4799	Request hattında yapılan 'Activate All' ve 'Disable All' policies işlemleri, metoddaki response ve error hatalarını etkilerken, 'All' seçenekleri bu durumu etkilemiyor.
APNZ-4678	DB2 API connection'ı silindiğinde, kullanılamaz hale gelen DB2 API'ler bulunuyor.
APNZ-4286	Admin projects sayfasında listeleme var ama 10 kayıt değil tüm kayıtlar gösteriliyor.
APNZ-4806	API Portal' de doğrudan API Product linki açılmıyor.
APNZ-4831	WSS kullanıcı bilgileri eklenirken, yalnızca username alanı eklenmesi gerekirken, readonly modda fazladan bir timestamp alanı görünüyor. Ayrıca, şifre alanı açık bir şekilde görüntüleniyor. API Proxy Group üzerinde deploy işlemi yapıldıktan sonra sayfa yenilendiğinde, sistem redeploy seçeneğini gösteriyor. Ancak, API Proxy Groups sayfasında grup doğru şekilde deploy edilmiş olarak görünüyor. Test konsolundaki CodeMirror body kısmı, 3 karakter içeride hizalanmış şekilde görüntüleniyor. API Proxy import edildiğinde, relative path alanına gereksiz şekilde imported kelimesi fazladan ekleniyor.
APNZ-4829	Log konnektöründe failover ayarı kapatıldığında, "Apply" işlemi sırasında sistem timeout süresine düşmeden uzun süre bekliyor. Kullanıcı tarafından sayfa yenilense bile ayar kapatılamıyor ve değişiklikler tamamlanamıyor.
APNZ-4836	Business Rule politikasında string exist condition hatalı çalışıyor.
APNZ-2889	API Product silindiğinde, Account ekranındaki ApiProductAppRegister tablosunda boşluklar oluşuyor.