Bu sayfa, Apinizer platformunun 2021 yılında yayınlanan tüm sürümlerinin release notlarını içerir. Her sürüm için yeni özellikler, değişiklikler, düzeltmeler ve migration notları detaylı olarak listelenmiştir.
2021 yılında Apinizer platformu önemli güncellemeler ve yeni özelliklerle geliştirildi. Bu yıl içinde yapılan tüm değişiklikler aşağıda listelenmiştir.
Apinizer API Developer Portal’ın ilk versiyonu yayınlandı! API Portal, API için önemli bir iletişim kanalıdır, API Provider ile API Consumer arasında köprü görevini yapar. API Provider, dış dünyaya açmak istediği API Proxy’lerini Apinizer Manager Console’undan tanımlar. API Consumer, da bir API’ye nasıl iletişime geçebileceğini Apinizer API Developer Portal üzerinden yönetir. Amaç, API Provider’ın API Proxy’lerini kolayca paylaşıp tüketilmelerini sağlayabilmektir. Ek olarak, Apinizer, API Developer Portal üzerindeki tasarım kisiselleştirme, API Katalogu ile API Dokümantasyonuna erişme ve test etme, Şart&Koşul tanımlama, API analitiği, API trafiğini izleme, hesap yönetimi, kimlik bilgileri yönetimi, API ve Kimlik Bilgi bazında erişim denetimi imkanları sağlar.
API Developer Portal Yöneticisi tarafından, yönetim bölümü üzerinden API Proxy’den API oluşturulabilir. Böylelikle, dış kaynaklar API Proxy’ye atanmış ortam üzerinden erişim gerçekleştirebilir. Ayrıca Portal Yöneticisi API’nin erişilebilirliğini buradan yönetir.
API Developer Portal Yöneticisi tarafından, API Developer Portal’a giriş yapabilecek kurum yöneticisi olan ya da olmayan hesaplar tanımlar. Kurum yöneticisi olan hesap, kendi alt kurumlarında ait başka hesaplar oluşturma yetkisine sahiptir. Hesap, kendisine atanmış API’leri yönetebilir ya da başka bir hesaba atayabilir. Her hesap, API’ye istek gönderen kendi kimlik bilgilerini belirler. Ek olarak, kimlik bilgisi bazında API erişim denetimi ya da API bazında kimlik bilgisi erişimi kısıtlaması yapılabilir.
API Developer Portal Yöneticisi tarafından, portalın genelinde geçerli olan kişiselleştirme, eposta yönetimi, şartlar & koşullar ve entegrasyon işlemleri yapılandırılır.ÖNEMLİ DEĞİŞİKLİKLER VE İYİLEŞTİRMELER
Worker’a ait uygulama loglarına, API Proxy ekranındaki Uygulama Logları tabı üzerinden denetleyebilir hale getirildi.
Portal UI tarafında kullanılacak Credential ve API’ye ait geçmiş bilgilerinin yönetimi Denetim Kayıtlarına eklendi.
API Trafiği ekranına CorrelationID filtresi eklendi.
HATA DÜZELTMELERİAPNZ-2593 : Kontraktan kimlik bilgisi kaldırıldığı halde ilişkisi gözüküyor.APNZ-2599 : Her nesnenin denetim kaydı tutulmuyor.APNZ-2601 : Expire olmuş kontraktaki kimlik bilgisi, istek yapabilmekte olup “Contract Expire Date ..vs” hatası vermiyor.APNZ-2605 : WS-Security poliçesi hata veriyor.APNZ-2606 : Uygulama logları ekranında silme ve filtreleme işlemleri tutarlı çalışmıyor.APNZ-2607 : Audit sayfaları/sekmeleri açılmıyor.APNZ-2609 : Kimlik Bilgisi’nin, ACL tabında proje filtresi çalışmıyor. Aynı API Proxy, kimlik bilgisine birden fazla eklenebiliyor.APNZ-2619 : Login olunca proje seçili gelmesine rağmen değilmiş gibi davranıyor.APNZ-2624 : DB-2-API de bir parametrenin birden fazla yerde kullanılması durumunda hata alınıyor.APNZ-2638 : JWT Kimlik Doğrulama poliçesinde header’a kullanıcıyı ekle seçeneği aktif olmasına rağmen log’unda eklenmiş bir header görünmüyor.APNZ-2640 : Authentication token alma hatası token loglarına düşmüyor.
Her proje için tanımlanabilecek API Proxy Şablonu ile, o Projedeki bütün API Proxy’lerin belirlenen şablona uygun olarak oluşturulması sağlanır. Böylece, API Proxy’lerin hepsi ya da çoğu için ortak olan Cache, CORS, Authentication, Error Response Template, Forwardded IP Header Parameter, API Based Quota ve API Based Throttling gibi tanımlamalar bir defada yapılarak API Geliştiricilerin işi azaltılabilir. API Proxy Şablonu ile gelen özellikler istenirse API Proxy için değiştirilebilir.
Mock API Creator ile, istekler için önceden tanımlanmış yanıtları döndüren Mock API’ler kolay ve hızlı bir şekilde oluşturulabilir. Bu yanıtlar koşullara göre özelleştirilebilir. Bu şekilde oluşturulan RESTful Mock API’ler, prototip oluşturma veya test etme gibi amaçlar için kullanılabilir.ÖNEMLİ DEĞİŞİKLİKLER VE İYİLEŞTİRMELER
API Creator → DB-2-API modülünde, IN sorgularının yazılmasını desteklemek üzere liste şeklinde parametre tanımlama özelliği eklendi.
Oracle veri tabanı için Cursor dönüş değeri eklendi.
HATA DÜZELTMELERİAPNZ-2483: Elasticsearch authentication hatası.APNZ-2480: Soap2Rest bir API Proxy için oluşturulan örnek mesajlarda parametreler görünmüyor.APNZ-2479: Mock API Reparse işleminde önceden girilmiş olan Koşullar kayboluyor.APNZ-2477 : Backend digest authentication poliçesinde hata.APNZ-2476 : Privacy Manager’da API Proxyler için eksik tanım oluşma sorunu var.APNZ-2475 : Privacy manager ekranında element name boş ise Save tuşu disabled olmalı.APNZ-2472 : Soap2Rest ekranındaki hata mesajları gelmiyor.APNZ-2469 : DB-2-API için oluşturulan Swagger ve Open API Spec’te Response hatalı.APNZ-2457 : DB-2-API’ye yeni eklenen metot, API Spec’te görünmüyor.APNZ-2454 : Projedeki API Developer rolü API Proxy silemiyor. API Manager rolü ise global politikaları görmüyor.APNZ-2453 : Mail Connector’de mail body’de {{}} gibi değerler gelirse null hatası oluşuyor.APNZ-2441 : DB-2-API’de Stored Procedure’a ait OUT parametreleri bu DB-2-AI için oluşturulan API Spec’te IN parametresi olarak gözüküyor.
Bir Proje’de tanımlı tüm varlıklar yedekleme ya da içe aktararak (import) aynı ayarlara sahip yeni bir proje oluşturma amacıyla dışa aktarılabilir (export).
API Proxy Grupları, Politikaları yapılandırmak ve erişimi kontrol etmek için birden fazla API Proxy’nin bir grup olarak yönetilmesini ve yüklenebilmesini sağlar. API Proxy Grubundaki API Proxy’lerin kendi URL’leri devre dışı bırakılarak, API Proxy Grubunun URL’si üzerinden erişim sağlanabilir.
API Proxy’lere erişebilecek istemcilerin (API Tüketicilerin) kimliklerinin tek noktadan yönetilmesini ve kolayca Erişim Denetim Listeleri (Access Control Lists) oluşturulabilmesini sağlar.
API Proxy’lerin kime, ne zaman, hangi sözleşmeye/protokole göre açıldığı, sözleşmenşn/protokolün ne zaman sona ereceği ve buna bağlı olarak API Proxy’lere erişimin otomatik olarak kapatılması gibi konuların yönetilebilmesini sağlar.ÖNEMLİ DEĞİŞİKLİKLER VE İYİLEŞTİRMELER
Herhangi bir sistemden alınan ve/veya hazırlanan CSV formatındaki kimlik bilgileri, Apinizer kimlik havuzuna kolayca yüklenebilir hale getirildi.
Test Konsolunda API Proxy seçerken Ad ve Geçit Adresi alanları üzerinden hızlı arama yeteneği eklendi.
Worker sunucularının performans iyileştirmesi için Elasticsearch ve Routing için Connection Pool yapısı kuruldu.
Elasticsearch konfigürasyonunda apinizer-log-ilm-policy -elas lifecyce için delete fazı ayarları eklendi.
API Proxy’lerin kullanım amacını tanımlama ve kurum/firma içine ve/veya dışına açılan API Proxy’leri filtremele imkanı getirildi.
Test Konsolunda API Proxy Gruplarını test etme yeteneği eklendi.
HATA DÜZELTMELERİAPNZ-2428 : DB-2-API’de try butonuna tıklayınca hata oluşuyor ve try butonu çalışmıyor.AC-2011 : Projedeki “enable relative path” alanı disable edilemiyor.AC-2209 : Revizyon oluşturulurken eski revizyonun görünmesi gerekiyor.AC-2213 : Test Konsolunda oluşturulan testin ismi değiştirilemiyor.AC-2334 : API Integration, sunucu konfigürasyonu oluşturulmadan disable edildiğinde null hatası veriyor.AC-2352 : Spec API ekranında, Swagger import edip Spec oluştur dendiğinde server bilgisi gelmiyor.AC-2372 : Circuit Breaker ve Client Flow Banner enable edilince bazı zorunlu olması gereken alanlar boş geçilebiliyor.AC-2387 : Integration uygulaması production modda çalışırken mail atmıyor ve dependency hatası veriyor.AC-2388 : DB-2-API’den oluşturulan API Proxy’de, Test Konsoluna seçilen endpoint’in parametreleri gelmiyor.AC-2391 : Privacy Management, API Proxy Settings tabında hata veriyor ve liste yüklenmiyor.AC-2400 : Hiç proje seçili değilse, proje menüsünde sol tarafta yetkili olmamasına rağmen Connection Management menüsü geliyor.AC-2410 : Analitikte Response Time grafiğinde Total Time ile Routing Time aynı ise grafik yanlış gösteriyor.AC-2412 : Analitik Dashboard’da son 5 dk seçilince grafiklerde bazı sonuçlar eksik geliyor.
Bir API Proxy’nin klonlanması ve böylece aynı ayarlara sahip başka adla yeni bir API Proxy oluşturulabilmesi yeteneği eklendi. API Proxy klonu, özellikle bir API Proxy’nin farklı bir adresten açılmak istenen yeni versiyonu için oldukça kullanışlı bir yöntemdir.
API Proxy Routing bölümünde Yük Dengeleme için Single ve Distributed seçenekleri eklendi.Single: Yük dengeleme için her Worker sunucusu Routing bilgilerini kendi üzerinde tutar. Böylece Routing işleminde ciddi bir performans artışı sağlanmış olur. Ancak yük Worker sunucuları arasında dağıtılırken, seçilen algoritmaya (Round Robin, LRU, Weighted vb.) %100 uyulacağını garanti etmez.Distributed: Yük dengeleme sırasında, isteğin gönderileceği Worker sunucusunun hangisi olduğuna karar verilebilmesi için dağıtılmış önbellek kullanılır. Böylece yük Worker sunucuları arasında dağıtılırken, seçilen algoritmaya (Round Robin, LRU, Weighted vb.) %100 uyulacağını garanti eder. Ancak performansı Single seçeneğine göre daha kötüdür.
Empty API, API tanım dosyası olmayan API/Web Servisler için API Proxy oluşturulabilmesini sağlar. Bu sayede code-first geliştirilmiş API’ler de Apinizer üzerinden kolayca açılabilir.
API/Web Servislere istek gönderip yanıt dönüp dönmediğini ya da dönen yanıtın içeriğini görmek için Test araçları kullanılabilir. Böylece Apinizer ortamından çıkmadan hızlıca testler yapmak mümkündür.
Test kullanımı arttıkça tarihçeyi kullanmak zorlaşabilir. Test Koleksiyonları hazırlayarak test tanımlarını gruplayarak kaydetmek, böylece daha yönetilebilir hale getirmek olanaklıdır.
Hata alan istekler varsa, bunlar log kayıtlarını gösteren arayüzün içinden hemen tekrarlanabilir. Böylece herhangi bir arama işlemi yapmadan, doğrudan hataya neden olan istek tekrarlanarak hızla ve kolayca yeniden test yapılabilir.
Veri tabanında tutulan ve süresi dolmuş (expired) token’ları otomatik olarak silen bir görev oluşturuldu. Apinizer yöneticisi isterse Yönetim → Zamanlanmış İşler (Scheduled Jobs) menüsünden bu görevi durdurabilir ya da herhangi bir zamanda tekrar çalışmasını sağlayabilir.ÖNEMLİ DEĞİŞİKLİKLER VE İYİLEŞTİRMELER
Task Flow ekranında ilgili Task Flow için açılacak Endpoint varsayılan olarak pasif geliyor, kullanıcı isterse aktif hale getirebiliyor.
Soap1.1 servisinde SOAPAction header yoksa WSDL’da tarif edilen SOAPAction otomatik olarak ekleniyor.
Admin menüsündeki Error Message ekranı kolay tanımlamalar için düzeltildi.
Veri tabanı konektörleri için JDBC URL Template’in varsayılan olarak gelmesi sağlandı.
Test Konsolu ve Test Araçları, uygulama içinde her yerden kolay ulaşılabilecek şekilde üst menüye eklendi.
Global poliçelerde değişiklik olduğunda aynı ekranda onu kullanan tüm API Proxy’lerin gösterilip redeploy yapılabilmesi sağlandı.
HATA DÜZELTMELERİAPNZ-2034 : Test Console için API Proxy listesi çekilirken tarayıcının konsolunda bir hata geliyor.APNZ-2091 : API Proxy oluşturma tipi KPS olunca REST to SOAP seçeneği gelmiyor.APNZ-2111 : LDAP Authentication Provider’ın gelişmiş ayar bölümünün test kısmında hatalar var.APNZ-2114 : Integrator Environment güncellenirken hatalar oluşuyor.APNZ-2121 : DB-2-API Spec dosyasında body tipindeki parametreler görünmüyor.APNZ-2021 : Email action disable edilmesine rağmen mail atıyor.APNZ-2096 : Heartbeat Monitor ekranında hatalar oluşuyor.APNZ-2136 : Apinizer rootcontext’de sadece ’/’ yazıldığında Servis Erişim Adres’inde null hatası alınıyor.APNZ-2138 : Business Rule politikasında, “Condition is empty” seçilince çalışma zamanında hata oluşuyor.APNZ-2150 : Script Politikası ekranında statusCode girilince hata oluşuyor.APNZ-2152 : Query Parameter’de JSON verisi gönderilirken encoding hatası oluşuyor.APNZ-2148 : Script politikası test edilirken hata alınırsa, kullanıcı okuyamadan hata mesajı kayboluyor.APNZ-2154 : API Proxy tabları API Trafik, API Analytics ve Audit sayfalarında ilk açılışında sadece seçilen API Proxy’nin değil diğer API Proxy’lerin de bilgisi geliyor.APNZ-2156 : Policy Error Message biçimlendirmede üç alandan sadece birine veri girişi yapılınca API Proxy hata veriyor.APNZ-2202 : API Proxy’nin Analytics tabında proxyTime, backendTime ve totalTime değerleri yanlış alanların değerlerini gösteriyor.APNZ-2208 : API Tasarımında ibr yanıt mesajına Code eklerken hata oluşuyor.APNZ-2226 : API Proxy’de metot/endpoint disable olsa bile cevap dönüyor.
