Sürüm Notları - 2021
Versiyon 2021.11.1
Yayınlanma tarihi : 1 Kasım 2021
YENI ÖZELLIKLER
- 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.
- Portal API
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.
- Portal Accounts
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.
- Portal Settings
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.
ÖNEMLI GELIŞTIRMELER VE DEĞIŞIKLIKLER
- 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ÜZELTMELERI (BUG FIXES)
Issue No | Açıklama |
|---|---|
| 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. |
Versiyon 2021.06.1
Yayınlanma tarihi : 1 Haziran 2021
YENI ÖZELLIKLER
- API Proxy Şablonu (API Proxy Template)
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. Detaylı bilgi ve kullanım için API Proxy Şablonu sayfasına bakınız.
- Mock API Creator
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. Detaylı bilgi ve kullanım için Mock API sayfasına bakınız.
ÖNEMLI GELIŞTIRMELER VE DEĞIŞIKLIKLER
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ÜZELTMELERI (BUG FIXES)
| Issue No | Açıklama |
|---|---|
| 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. |
Versiyon 2021.05.1
Yayınlanma tarihi : 1 Mayıs 2021
YENI ÖZELLIKLER
- Script Connector
Script Connector, Action ve Task Flow tanımlarında JavaScript ve/veya Groovy dili kullanılarak çeşitli işlemler yapılabilmesini sağlar.
- Projeyi Dışa Aktarma (Project Full Export)
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ı (API Proxy Groups)
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. Detaylı bilgi ve kullanım için API Proxy Grupları (API Proxy Groups) sayfasına bakınız.
- Kimlik Yönetimi (Identity Management)
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. Detaylı bilgi ve kullanım için Kimlik Yönetimi (Identity Management) sayfasına bakınız.
- DB-2-API Cursor desteği
DB-2-API modülünde Stored Procedure kullanan metot/endpoint'ler için Cursor desteği eklendi. Detaylı bilgi ve kullanım için DB-2-API sayfasına bakınız.
- Sözleşme/Protokol
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. Detaylı bilgi ve kullanım için Sözleşmeler/Protokoller sayfasına bakınız.
ÖNEMLI GELIŞTIRMELER VE DEĞIŞIKLIKLER
- 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ÜZELTMELERI (BUG FIXES)
| Issue No | Açıklama |
|---|---|
| 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. |
Versiyon 2021.03.1
Yayınlanma tarihi : 1 Mart 2021
YENI ÖZELLIKLER
- API Proxy Klonlama
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. Detaylı bilgi ve kullanım için API Proxy Klonlama sayfasına bakınız.
- Yük Dengelemede Single ve Distributed seçenekleri
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.
Detaylı bilgi ve kullanım için Yönlendirme Sekmesi -> Yük Dengeleme sayfasına bakınız.
- APICyrpt
APICrypt, istek/yanıt mesajlarının bir HSM cihazından geçirilerek şifreli iletişim yapılmasını sağlar.
- Syslog Entegrasyonu
Log kayıtları Syslog'a da yazılarak merkezi log sistemleri ile entegre edilebilir. Detaylı bilgi ve kullanım için SysLog Ayarları sayfasına bakınız.
- Empty API
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. Detaylı bilgi ve kullanım için API Proxy Oluşturma -> Empty API sayfasına bakınız.
- Test Araçları
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. Detaylı bilgi ve kullanım için Test sayfasına bakınız.
- Test Tarihçesi
Yapılan bütün testler için tarihçe tutulur. Tarihçedeki kayıtları kullanarak aynı testleri çalıştırmak mümkündür.
- Test Koleksiyonu
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.
- Log Kaydı ile Test
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.
Expired Token Cleaner
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. Detaylı bilgi ve kullanım için Zamanlanmış İşler (ExpiredToken görevi) sayfasına bakınız.
ÖNEMLI DEĞIŞIKLIKLER VE IYILEŞTIRMELER
- 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ÜZELTMELERI (BUG FIXES)
| Issue No | Açıklama |
|---|---|
| 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. |