Sürüm Notları 2024

Sürüm 2024.09.0

Yayınlanma Tarihi : 9 Eylül 2024

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

uyarı

2024.05.3 Patch versiyonundan güncelleme yapacak kullanıcılar için, API Proxy Grup'ta çoklu API Proxy seçimine izin verilmesi sağlanmıştır. Bu ayarla birlikte, daha önce mevcut olan API Proxy Grup'taki politikaların API Proxy'lere uygulanması özelliği kaldırılmıştır.

uyarı

2024.05.4 Patch versiyonundan güncelleme yapacak kullanıcılar için, yapılan güvenlik güncellemesiyle, Apinizer Yönetim Konsolu'nda tarayıcıların istemci IP adreslerinin değer kontrolü zorunlu hale getirilmiştir. Bu nedenle, arayüze "Kubernetes Ingress Controller" kullanarak bağlanan kurumların, client IP bilgisini X-Forwarded-For header'ı ile göndermesi gerekliliği kaldırılmıştır.

YENİ ÖZELLİK

• API Portal'de Spesifikasyonların İndirilebilir Olması

API Portal'de spesifikasyonların indirilebilir olması sağlandı.

• Management API'lerine Yeni Politikalar

Management API'lerine yeni politikalar eklendi. Bkz.

ÖNEMLİ DEĞİŞİKLİKLER VE İYİLEŞTİRMELER

• Disable Routing butonu ile, bir tanım dosyası ile yüklenen bir servis backend'e gitmeden çalıştırılabilir hale geldi. Bkz.

• Proxy'lerin routing adresleri backend'e gitmediği durumlarda nereye gittiğinin daha anlaşılır olması için Routing adresinde yazan değerler detaylandırıldı. Bkz.

• ÖNEMLİ! API Proxy oluştururken seçilen Mirror API bu versiyonda deprecated edilerek kaldırıldı. API Proxy Routing sekmesinde ayarlanması sağlandı.

• API Proxy ve API Proxy Group Geliştirme (Development) sekmesinde yapılabilecek işlemler her hatta özelleştirildi. Bkz.

• Bağlantı Konfigürasyonlarındaki aktif/pasif butonu ayrıca listeleme ekranına da yerleştirildi. Bkz.

• DB-2-API ekranına, get sorgularında görünmeyen top1/limit1 olarak sonuç döndüğü bilgisi uyarı olarak eklendi. Bkz.

• Apiops tamamen kapatılabilir hale geldi. Bkz.

• Global politikalara Proxy Grubu'nda kullanılanlar listesi eklendi.

• API Portal'daki uç nokta (endpoint) testinde, uygulama (application) seçilince Auth bilgisinin otomatik gelmesi sağlandı. Bkz.

• Önbellek (Cache) başlatılırken önceki quota verilerinin veri tabanından yüklemesi lazy ya da eager olarak yapılabilmesi sağlandı. Bkz.

• Gateway Runtime'lara Üretim (Production) ve Test alanları eklendi. Bkz.

• Bağlantı Konfigürasyonlarındaki aktifleştir (enable) butonu tablolarda standartlaştırıldı.

HATA DÜZELTMELERİ

APNZ-4562 : Genel Ayarlar bölümünde belirlenen WSDL örnek dosya oluşturma boyut limiti, Rest2Soap yapılandırmasına yansıtılmıyor.

APNZ-4559 : API Portal Test Konsolu'nda, body içeriği eski veri ile geliyor, güncellenmiyor.

APNZ-4558 : Genel Ayarlar kaydedildiğinde LogRetentionSetting yapılandırması siliniyor.

APNZ-4549 : Rest2Soap'ta örnek mesajın oluşturulmamasından dolayı bir metod açılamıyor.

APNZ-4546 : Endpoint düzenlemesi yapıldığında ve metod ismi değiştirildiğinde tasarımdaki response body içeriği kayboluyor.

APNZ-4545 : Error handling type default olarak ayarlanmadığında ve backend bağlantısı sağlanamadığında, status code belirlenmiyor.

APNZ-4552 : API Portal Sorunları:

• Metotlarda, 'Request Body', 'Description' ve 'Header' parametreleri managerda tanımlanmasına rağmen portal ekranında görüntülenmiyor.
• Manager'da description eklenirken tablo ekleme desteği bulunmuyor; mevcut editör tablo eklemeyi desteklemiyor.
• API Portal'de font tipi kurumsal font ya da birden fazla font seçilemiyor.
• API Portal ana ekranda bulunan documentation bölümü özelleştirilemiyor veya daha net hale getirilemiyor.
• Renkler ayarlanırken tüm butonların renkleri değişmiyor.
• API Portal navbarının orta kısmında çizgi yer alıyor.

APNZ-4553 : ApinizerKubernetesClientService k8s metriklerini okuyamıyor.

APNZ-4540 : Sıfır veritabanı ile son sürüm (2024.05.4) kullanıldığında gerekli veritabanı tabloları oluşturulmuyor.

APNZ-4537 : Test ortamında proje dışa aktarıldığında, hata mesajlarının ID'lerinin farklı olması nedeniyle üretim ortamında içe aktarılan hata mesajları global politikalarda boş görünüyor.

APNZ-4525 : Dışa aktarılan verinin isminde dosya sisteminde anlamlı karakterler bulunması, export dosyasının bozulmasına neden oluyor.

APNZ-4544 : XML işlemlerinde concurrency (eşzamanlılık) arttığında sorunlar yaşanıyor.

APNZ-4507 : Proxy grubundan dışa aktarılan kimlik doğrulama politikası, proxy'ye içe aktarıldığında null hatası veriyor.

APNZ-4529 : Secret Manager'da anahtar eklerken 'private' veya 'public' seçeneği seçildiğinde, tuşlar etkinleşmiyor.

APNZ-4521 : Credentials ekranında hesap filtreleme kısmında hesaplar (accounts) gelmiyor.

APNZ-4435 : API Proxy Group'ta deploy veya undeploy işlemi gerçekleştirildiğinde, endpointlerin URL'leri sayfa yenilenmeden güncellenmiyor.

APNZ-4518 : Portal hızlı test sorunları:

• 'Yetkilendir' butonuna basıp 'Dene' işlemini gerçekleştirdikten sonra, tanımladığımız parametreler header'da görünmüyor.
• Parametreler kısmında yalnızca X-Client-Id ve X-Client-Secret alanları görünüyor. Ayrıca, 'Dene' ekranını kapattıktan sonra, 'Parametreler' kısmından ilk eklediğimiz parametreler de siliniyor.

APNZ-4516 : Integration'da, 'disabled' durumdaki işler tetikleniyor ve 'in progress' (devam eden) durumda kalıyor.

APNZ-4536 : Alert history ekranında tarih ve sıralama yanlış çalışıyor.

APNZ-4512 : Manager health check, HTTPS protokolü ile yapılamıyor.

APNZ-4511 : Portal'daki üyelik modeli seçim alanında hatalar mevcut.

APNZ-4510 : Rest2Soap işlemlerinde null olarak gönderilen değerlere namespace eklenmiyor.

APNZ-4506 : Bir proxy grubundan dışa aktarılan Authentication politikasının farklı bir proxy grubuna içe aktarılması işlemi başarılı bir yanıt verilmesine rağmen, politika görünmüyor. Politikanın eklenip eklenmediği anlaşılmıyor ve sayfa yenilenmesine rağmen politika hala görünmüyor.

APNZ-4358 : API Proxy tasarım sekmesinde path parametreleri görünmüyor.

APNZ-4351 : Logout işlemi gerçekleştirildikten sonra login olunduğunda, son yapılan kayıt silme işlemi proje seçme popup'ının önünde açık kalıyor.

APNZ-4520 : Routing NTLM Authentication yapılandırması çalışmıyor.

APNZ-4502 : Cache yavaş açılıyor ve gereksiz bir şekilde public bir IP'ye ping atıyor.

APNZ-4569 : API Proxy analitik sekmesinde zaman zaman environment'ların yüklenmeme sorunu yaşanıyor.

APNZ-4508 : JWT politikasında 'LDAP API Authentication' seçili iken, LDAP API Authentication tanımı silindiğinde problem yaşanıyor.

APNZ-4533 : Proje dışa aktarıldığında bazı bağlantılar eksik oluyor.

Versiyon 2024.05.3 Patch ve Versiyon 2024.05.4 Patch ile gelen Yeni Özellikler, Önemli Değişiklikler ve İyileştirmeler hakkında detaylı bilgi edinmek için ilgili Dökümanı İnceleyebilirsiniz: 2024.05.x

Sürüm 2024.05.0

Yayınlanma Tarihi : 7 Haziran 2024

YENİ ÖZELLİK

• Script ve Değişken Ortam Değerlerine Yeni Alanlar

Script ve değişken (variable) ortam değerlerine (context values) yeni alanlar eklendi. Bkz.

• Proje ve Admin Genel Bakış Sayfaları İyileştirmesi

Proje ve Admin Genel Bakış (Overview) sayfaları daha interaktif hale getirildi. Bkz. Proje Bkz. Admin

• Script Politikasına Credential Secret Erişimi

Script politikasına, kimlik bilgisine (credential) ait olan secret değerlere erişilebilmesi eklendi. Bkz.

• API Trafik Ekranına Saniye Bazlı Filtreleme

API trafik ekranına saniye bazlı filtreleme eklendi.

• Graylog GELF Formatında Loglama

Logların, Graylog GELF formatında UDP/TCP loglanabilmesi sağlandı. Bkz.

• Manager ve Portal HTTPS Desteği

Manager ve Portal'ın HTTPS olarak açılabilmesi sağlandı.

• Hata Politikaları Hattı

Hata durumunda belirlenen politikaların çalışması için Hata Politikaları (Error Policy) hattı eklendi. Bkz.

• Eski Logların Silinmesine user_token_blackList Eklendi

Eski logların silinmesine user_token_blackList nesnesi eklendi. Bkz.

• Çoklu Sekme/Lokasyondan Giriş Ayarı

Genel ayarlara kullanıcıların aynı anda çoklu sekme/lokasyondan giriş yapabilmesine izin verilen ayar eklendi. Bkz.

• Sertifikalar Ekranına Truststore Sekmesi

Sertifikalar ekranına truststore sekmesi eklendi. Bkz.

• API Portal Sık Sorulan Sorular

API Portal'de Sık Sorulan Sorular'ın dinamik olarak tanımlanabilmesi sağlandı. Bkz.

• Portal'e Uygulama Ekleme

Portal'e Uygulama (Application) eklenmesi sağlandı. Bkz.

• Portal'e Dokümantasyon&Test Sekmesi

Portal'e Dokümantasyon&Test sekmesi eklendi.

• Credential Ekranı Filtreleme

Credential ekranı, Portal'daki uygulamalar ve hesaplara göre filtrelenecek şekilde yapılandırıldı.

• Portal'e Araçlar Menüsü

Portal'e Araçlar (Tools) menüsü eklendi.

• Test User Rolü

Test User rolü eklendi. Bkz.

• Bildirimler Purge Jobs Listesine Eklendi

Bildirimler, sistemde yer alan purge jobs listesine dahil edildi. Bkz.

• Script Politikasının Asenkron Çalışması

Script politikasının asenkron çalışabilmesi sağlandı. Bkz.

ÖNEMLİ DEĞİŞİKLİKLER VE İYİLEŞTİRMELER

• API Call politikası tek yönlü olarak çalışırken bir API çağrısından hata alındığında, bu hatanın ilgili API Proxy'nin sonucuna yansıtılabilir olması sağlandı.

• API Proxy Trafik ekranında gelişmiş sorgu alanında empty/is not empty/exists/not exists/contains/not contains/in list/not in list seçenekleri ile arama yapılabilabilir hale getirildi. Bkz.

• Portal Yönetimi'ne Organizasyonların API Görünürlüğü ekranı eklendi. Bkz.

• Condition'a liste verilip listeye dahil/değil gibi değerlerin kontrol edilebilmesi sağlandı. Bkz.

• Zaman politikasına belirli günler girilebilmesi özelliği getirildi. Bkz.

• Kullanıcı ekranında LDAP tipinde kullanıcı aratıldığında kullanıcı bulunamadı ise ekrana uyarı verilmesi sağlandı.

• ldentity provider'daki LDAP bilgisinde gelişmiş seçili ise object'in varsayılan gelmesi, silinememesi, sadece düzenlenebilmesi sağlandı.

• LDAP provider'ın içindeki LDAP Connection'ların doğru bir şekilde gelmesi sağlandı.

• Yönetici panelindeki başlıklar düzeltildi. Bkz.

• Script ile erişilebilen değerlere yeni değerler eklendi. Bkz.

• Aynı kullanıcı ile aynı anda iki kişinin girmesi engellenebilir oldu. Bkz.

• Sistem ayarlarında güvenli bağlantıların hostname doğrulamasının yönteminin seçilmesi sağlandı.

• Test konsolda xslt dosyasında sorun olduğunda sorunun detayının da ekrana getirilmesi sağlandı.

• Kullanıcı API Manager'a login olduğunda oluşan JWT'nin daha küçük boyutta oluşması sağlandı.

• Deploy edilirken relative path'in çakışması durumunda, çakışmanın hangi proxy veya proxy grubu ile olduğuna dair ayrıntılar sağlandı.

• Elasticsearch şablon ayarlarının ekrandan düzenlenebilmesi sağlandı. Bkz.

• API Developer Portal'de hesap kaydının yapılandırılabilir olması sağlandı. Bkz.

• Elasticsearch işlemlerine rollover özelliği eklendi. Bkz.

• Uptime Monitor ve Anomaly ekranlarında performans iyileştirmesi yapıldı.

• Test konsola request body'yi JSON olarak imzalama özelliği eklendi. Bkz.

• JWK ekranında açılan Key Store, Public Key, Private Key ve Sertifika alanlarının sıralı gelmesi ve arama yapılabilmesi sağlandı.

• Kimlik Bilgisi (Credential) ekranında organizasyona göre arama yapma ve isimlerin sıralı gelmesi sağlandı.

• Sertifikanın düzenlenebilir olması sağlandı. Bkz.

• Xml transformation politikasında ve protocol transformation'da performans iyileştirmesi sağlandı.

• Routing'de Connection Request Timeout değerinin ayarlanabilir olması sağlandı. Bkz.

• Test konsola request body'yi WS Security olarak imzalama özelliği eklendi. Bkz.

HATA DÜZELTMELERİ

APNZ-4309 : API Manager farklı sekmelerde açıldığında proje bilgisi karışıyor.

APNZ-4369 : REST-SOAP-REST dönüşümünde response mesajındaki numerik alanların metin olarak dönüştürülmesinde hata var.

Büyük sayılar, JSON'da bilimsel notasyon kullanılarak gösteriliyordu. Bu düzeltmeden sonra, yanıt mesajında sayılar olduğu şekilde kullanılmaya başlandı.

Daha önce hatalı çalışan dönüşüm işlemleri, bu güncelleme sayesinde düzeltilecektir. Ancak, bu durum daha önce fark edilmeyen hataların ortaya çıkmasına neden olabilir. Bu nedenle, REST-2-SOAP işlemlerinizi kontrol etmenizi öneririz.

APNZ-3833 : Uygulama loglarında log seviyesi "off" olduğunda bile, loglar tutulmaya devam ediyor.

APNZ-3857 : Context Values'daki değişkenlerde problemler mevcuttur.

APNZ-4022 : Uptime monitör'de yeniden deneme sayısı gibi routing bazlı ayarların çalışmasında hata alınıyor.

APNZ-4039 : Analitik grafiklerinde yetkili kullanıcının yetkisi kaldırıldığında kullanıcı listelenmiyor.

APNZ-4061 : Report generator çalışmıyor.

APNZ-4093 : Alert'lerdeki "Elasticsearch diskte log var" öntanımlı değeri kaldırılmış.

APNZ-4101 : Mevcut Cron expression'lar güncellenmiyor.

APNZ-4123 : ACL Reports sorunları:

• Proje listesi gelmiyor.
• Search By Credentials istenilen filtreleme ile çalışmıyor.

APNZ-4138 : Hata durumunda logla seçeneği açık olmasına rağmen proxy'de log kapalı iken White IP'ye takılan isteğe ait log kaydı bulunamıyor.

APNZ-4162 : OpenAPI ayrıştırması sonrasında kayıt edilemiyor.

APNZ-4174 : Integration tetikleniyor ama istek atamıyor.

APNZ-4183 : Elasticsearch disk doluluk oranı alarmı için sorgulama yapılamıyor.

APNZ-4208 : Proje değiştirilince 5-6 saniye ekranlarda duraksama oluyor.

APNZ-4210 : Context Value'da label hatası alınıyor.

APNZ-4215 : Ldap Secure çalışmıyor.

APNZ-4229 : API Call'da projedeki sertifika listelenmiyor.

APNZ-4236 : Anomali kapalı bile olsa, sonuç listesine 'anomaly detected' eklenmeye devam ediyor.

APNZ-4244 : Applications logs'ta en fazla son 1 günlük logları kayıtlı tutuyor.

APNZ-4245 : Bir environment bir projeye bağlanırsa, o proje silindiğinde o gateway sayfasında o environment'a girilemiyor.

APNZ-4259 : Environment ayarlarında HTTP kapalı olmasına rağmen Kubernetes'te svc oluşturuluyor.

APNZ-4260 : Application Logs'ta Purge Jobs işlemi çalışmıyor.

APNZ-4262 : API Manager kullanıcısı oturumu kapattığında JWT geçersiz hale gelmiyor.

APNZ-4263 : Rest2Soap dönüşümlerinde jackson kütüphanesinin (default) veri boyutu limiti 20mb'tan integer limiti olan 2.1Gb'a çıkarılmıştır.

APNZ-4274 : Servisi sadece HTTPS üzerinden açtığımızda, WSDL içindeki XSD adresi HTTP olarak kalıyor.

APNZ-4276 : Business rule, JWT taleplerinde çalışmıyor.

APNZ-4294 : Business Rule ile body'e veri eklenmesi hatalı çalışıyor.

APNZ-4297 : Portal'de API public olmasa bile sayfasına direkt IP üzerinden erişilebiliyor. Portal'de hesabım sayfası gelmiyor.

APNZ-4298 : Cache pod birden fazla olduğunda HTTP protokol hatası alınıyor.

APNZ-4308 : Kullanıcı API Manager'a giriş yaptığında varsayılan projesi gelmiyor.

APNZ-4318 : Disk doluluğu alarmı için threshold değeri belirlenirken herhangi bir değer girildiğinde hata alınıyor.

APNZ-4323 : Redaction'da silme işlemi çalışmıyor ve değiştirme işlemi sırasında ilgili alana değer girilemiyor.

APNZ-4324 : CN ifadesi olmayan sertifikalar yüklenirken hata alınıyor.

APNZ-4332 : REST to SOAP dönüşümünde, xsi:nil durumunda namespace prefix özel durumlarda XML'e eklenmiyor.

APNZ-4335 : Republish edilen ortamda cache servisi oluşturulmuyor.

APNZ-4349 : Active Directory'den giriş yapan ve projede tam yetkili olan bir kullanıcı, bağlantı yapılandırması > veritabanı seçeneğinde isim yerine bir şey yazmaya çalışırsa ve yönetici yetkisi yoksa, otomatik olarak oturumu kapatılıyor.

APNZ-4357 : Error Policy'e birden fazla politika eklendiğinde yer değiştiriyor.

APNZ-4358 : API Proxy design sekmesinde path param gözükmüyor.

APNZ-4360 : Error Policy hattına eklenen politikalar, Global politikaların referanslarında gözükmüyor.

APNZ-4362 : Global politikalardaki error politikaları görüntülenmiyor ve güncellenmiyor.

Sürüm 2024.01.0

Yayınlanma Tarihi : 2 Ocak 2024

YENİ ÖZELLİK

• API Trafik Log Ayarı

API Proxy ve API Proxy Grup'lara ait mesaj bölgelerinde hangi alanların loglanıp loglanmayacağı kendi sayfaları üzerinden yönetilmekteydi. Kullanıcı deneyimi iyileştirmek için uygulama bazında ve proje bazında bu ayarın, API Proxy listesi üzerinden ortam bazında yapılması sağlandı. Ek olarak, API Proxy ya da API Proxy Grup bazında atanan konnektörler ile loglama işlemi aktif ya da devre dışı bırakılması sağlandı. Bkz.

• Yeni Bağlantı Konfigürasyonu: Syslog

Apinizer üzerinden oluşturulan log kayıtlarını Syslog sisteminde tutmak için Syslog bağlantı tanımları yapılabilmesi sağlandı. Bkz.

• Yeni Aksiyon/Konnektör: Syslog

Syslog bağlantı tanımları kullanılarak oluşturulan konnektör ile verilerin ilgili sisteme gönderilmesi sağlandı. Bkz.

• Yeni Bağlantı Konfigürasyonu: Webhook

Apinizer üzerinden oluşturulan log kayıtlarını hedef sisteme Webhook ile taşımak için Webhook bağlantı tanımları yapılabilmesi sağlandı. Bkz.

• Yeni Aksiyon/Konnektör: Webhook

Webhook bağlantı tanımları kullanılarak oluşturulan konnektör ile verilerin ilgili sisteme aktarımı sağlandı. Bkz.

• Yeni Bağlantı Konfigürasyonu: RabbitMQ

Apinizer üzerinden oluşturulan log kayıtlarını RabbitMQ ile kuyruk sistemine göndermek için RabbitMQ bağlantı tanımları yapılabilmesi sağlandı. Bkz.

• Yeni Aksiyon/Konnektör: RabbitMQ

RabbitMQ bağlantı tanımları kullanılarak oluşturulan konnektör ile verilerin ilgili kuyruk sistemine gönderilmesi sağlandı. Bkz.

• Yeni Bağlantı Konfigürasyonu: Kafka

Apinizer üzerinden oluşturulan log kayıtlarını Kafka ile ilgili hedefe transfer etmek için Kafka bağlantı tanımları yapılabilmesi sağlandı. Bkz.

• Yeni Aksiyon/Konnektör: Kafka

Kafka bağlantı tanımları kullanılarak oluşturulan konnektör ile verilerin ilgili hedefe gönderilmesi sağlandı. Bkz.

• Yeni Bağlantı Konfigürasyonu: Elasticsearch

Apinizer üzerinden oluşturulan log kayıtlarını Elasticsearch sisteminde tutmak için Elasticsearch bağlantı tanımları yapılabilmesi sağlandı. Bkz.

• Yeni Aksiyon/Konnektör: Elasticsearch

Elasticsearch bağlantı tanımları kullanılarak oluşturulan konnektör ile verilerin ilgili sisteme gönderilmesi sağlandı. Bkz.

• Yeni Bağlantı Konfigürasyonu: Apache ActiveMQ

Apinizer üzerinden oluşturulan log kayıtlarını ActiveMQ ile mesaj sistemine göndermek için ActiveMQ bağlantı tanımları yapılabilmesi sağlandı. Bkz.

• Yeni Aksiyon/Konnektör: Apache ActiveMQ

ActiveMQ bağlantı tanımları kullanılarak oluşturulan konnektör ile veriler ilgili mesaj sistemine gönderilmesi sağlandı. Bkz.

• Yeni Bağlantı Tanımı: Logback

Apinizer üzerinden oluşturulan log kayıtlarını Logback sisteminde tutmak için Logback bağlantı tanımları yapılabilmesi sağlandı. Bkz.

• Yeni Konnektör: Logback

Logback bağlantı tanımları kullanılarak oluşturulan konnektör ile verilerin ilgili hedef sisteme gönderilmesi sağlandı. Bkz.

• Ortam Bazında Log Konnektörü Tanımlama

Varsayılan olarak, logların saklanması Elasticsearch ile yapılmakta ya da bu varsayılan ayar kapatılarak, logların başka bir sisteme (Syslog, Kafka) aktarılması sağlanmaktaydı.

Log yönetimini esnek hale getirmek için bu ayarın ortam bazında yapılması, gerektiğinde devre dışı bırakılması ve bir çok log konnektörü (Database, Elasticsearch, Kafka, RabbitMQ, ActiveMQ, Syslog, Webhook) üzerinde eşzamanlı loglama yapılabilmesi sağlandı. Bkz.

• Failover Konnektör Desteği

API Proxy Trafik kaydedilemediği durumda Apinizer veri tabanında tutulmaktaydı. Konnektör altyapısına geçilmesi ile birlikte bu özellik kaldırılarak, konnektöre failover konnektör seçilebilmesi imkanı getirildi. Böylece konnektörde bir sorun olması durumunda trafiğin failover konnektör(lerin)e aktarılması sağlandı.

• Konnektör ile API Proxy Oluşturma

Tanımlanan yeni konnektörler (Elasticsearch, Kafka, RabbitMQ, ActiveMQ, Syslog) kullanılarak API Proxy oluşturulabilmesi sağlandı. Böylece konnektördeki entegrasyon noktasına API ile erişim sağlanmış oldu. Bkz.

• Uygulama ve Token Logları için Konnektör Tanımlama

Varsayılan olarak, Uygulama ve Token logları Apinizer veri tabanına kayıt edilmekteydi. Log yönetimini esnek hale getirmek için konnektör tanımları yapılarak, bu konnektörler üzerinden uygulama ve token loglarının Apinizer veri tabanına ek olarak başka sistemlere aktarılabilmesi sağlandı. Bkz.

• Gizlilik Ayarları Tanımlama

Gizlilik ayarları eskiden genel olarak ayarlanabilmekteydi. Yapılan düzenleme ile ortamdaki konnektöre özel olarak Gizlilik Ayarları (Privacy Settings) yapılandırılabilmesi sağlandı. Bkz.

• IP Bazlı Rapor

Proje ya da uygulama bazındaki API Proxy'lere gelen isteklerin IP bilgisine göre gruplanarak kullanım özetlerine ait metriklerin görüntülenebilmesi sağlandı. Bkz.

• Metot ve Endpoint Bazında Cache Ayarlama

Metot/endpoint bazında cache ayarlarının yapılabilmesi sağlandı. Cache ayarlarının sadece Http Metodu GET olanlar için değil diğer durumlarda da yapılabilmesine imkan sağlandı. Bkz.

• Sertifika Export Etme

Sisteme yüklü sertifikaların export edilebilmesi sağlandı. Bkz.

• Apinizer Kimlik Yönetiminde Kullanıcı Havuzu'na REST API ile Kullanıcı Ekleme/Silme/Güncelleme

Apinizer kullanıcı havuzuna REST API ile kullanıcı ekleme/silme/güncelleme işlemleri getirildi. Bkz.

• API Proxy Export/Import API'si

Yönetim API'lerine API Proxy'leri Export/Import edilmesini sağlayan API eklendi. Bkz.

• Yeni Rapor: API Proxy Trafiği (Zamana Göre)

API Proxy Trafiğini zaman bazlı gruplayarak görselleştirmek için API Proxy Trafiği (Zamana Göre) raporu eklendi. Bkz.

• XML to JSON ve JSON to XML Dönüşümleri

İş Kuralı politikasında dönüşüm işlemine XSLT ve JSON işlemlerinin yanına XML to JSON ve JSON to XML dönüşümleri eklendi. Bkz.

XML Dönüşüm Politikasına XSLT seçeneğine ek olarak XML to JSON seçeneği getirildi. Bkz.

JSON Dönüşüm Politikasına Jolt seçeneğine ek olarak JSON to XML seçeneği getirildi. Bkz.

XML Dönüştürme ve JSON Dönüştürme test sayfalarına XML to JSON ve JSON to XML dönüşümleri eklendi. Bkz. XML Bkz. JSON

• Değişken Tanımlanmasında Tüm Gövde Seçeneği

Değişken tanımlanmasında Gövde tipinde değişken oluştururken mesaj tiplerine tüm gövde değerinin alınabilmesi için yeni "Tüm Gövde" seçeneği getirildi. Bkz.

• Deployment Geçmişinden Revizyon Silme

API Proxy deployment geçmişi üzerindeki revizyonların manuel olarak silinebilmesi için imkan sağlandı. Bkz.

• Gönderilmemiş API Proxy Trafik Loglarının Taşınması

Failover konnektör olarak Apinizer konfigürasyon veri tabanı seçilmiş ise Apinizer konfigürasyon veri tabanında biriken failover verilerini esas gitmesi gereken konnektörlere taşıyan ekran geliştirildi. Bkz.

• Audit Loglarını Konnektör ile Gönderme

Audit Loglarının Sistem Genel Ayarları ekranı üzerinden tanımlanabilen Konnektör ile farklı hedeflere gönderilebilmesi sağlandı. Bkz.

• API Portal Görünürlük Ayarları

API Ürünleri sayfasına API ürünlerinin detaylı bir şekilde görünürlüklerinin ayarlanabilmesi için yeni ayarlar eklendi. Bkz.

• Navbar Rengi Belirleme

Apinizer Yönetim Konsolu kullananların ortamları ayırt etmesinde kolaylık sağlamak için navbar renginin sistem ayarları üzerinden belirlenmesi özelliği getirildi. Bkz.

• Script Politikasında Context Value'ları Değiştirme

Script politikasında context value'ların değiştirilebilmesine imkan sağlandı. Bkz.

ÖNEMLİ DEĞİŞİKLİKLER VE İYİLEŞTİRMELER

• Elasticsearch index şablonunda tutulan istek/yanıt header ve parametre değerlerine ait eskiden text olan veri tipi nested hale dönüştürüldü. Bkz.

Böylece hem gelişmiş aramalarda yaşanan sorun giderildi hem de tüm konnektörlere gönderilen veri tipi standart hale getirildi. Bkz.

• Elasticsearch monitör sayfasına erişim, Elasticsearch bağlantı konfigürasyonları ekranına taşındı.

• Genel Ayarlar sayfasından yapılan Elasticsearch yapılandırma alanları, Elasticsearch bağlantı konfigürasyonları ekranına taşındı.

• Bağlantı Konfigürasyonları menüsü altındaki tüm bağlantılara export ya da import edilebilir hale getirildi.

• Değişkenler ekranına Özelleştirilmiş Değişken (Custom Variable) adında yeni tip eklendi. Bu tip ile mesaj hattına özel değişken oluşturulabilme imkanı sağlandı. Bkz.

• Script politikasında Custom Variable değerine erişim imkanı sağlandı.

• Script politikasında Message Context değişkenlerine erişim imkanı sağlandı.

• Application Log'unda ortam bilgisinin tutulması sağlandı.

• API Proxy, Custom Query ile sadece istenen veriler üzerinden özel olarak trace edilebilmesi sağlandı.

• Bağlantı konfigürasyonlarına ait bağlantıların, ortam bilgisi üzerinden test edilmesi sağlandı.

• OAuth2 ve Trace bilgilerinin, Elasticsearch'de loglanması kaldırıldı. OAuth2 ve Trace bilgilerinin Apinizer veri tabanında tutulması sağlandı.

• API Proxy yüklenirken, Deployment Geçmişi'nin silinmemesi için seçenek (kalıcı revizyon) özelliği getirildi.

• Anomali Detektörüne, aranan sorgunun ilgili zaman dilimindeki toplam veriye oranını bulan "query/filter rate percent" tipinde yeni bir koşul eklendi.

• API Proxy'ye ait Backend API'sine bağlantı esnasında alınan hata ile Backend API'den dönen mesajların anlaşılabilmesi için iyileştirme yapıldı, hata mesajları basitleştirildi. Hata mesaj şablonuna kullanılabilecek yeni değerler eklendi. Bkz.

• Uygulama Logları INFO seviyesi altındaki bir seviyede ise ve/veya herhangi bir API Proxy'de Trace modu açıksa Api Yönetim Konsolunda uyarı mesajı çıkması sağlandı.

• Mesajın istek, Backend API ve yanıt hattında ne kadar süre geçirdiği metrik bilgisi detaylandırıldı. İlgili API trafik ve raporlama ekranlarında da bu alanlar üzerinde sorgulama yapılabilme imkanı getirildi.

• API Proxy relative path değeri sadece "/" karakteri ile deploy edilememeli kuralı getirildi.

• Api analitik rolündeki bir kullanıcının API Trafik Sekmesindeki test konsolu kullanması engellendi.

• API Yönetim Konsol ekranının kullandığı API'lerde kapsamlı güvenlik iyileştirmeleri yapıldı.

• Tüm schedule'lar standartlaştırıldı.

• Yasaklı IP ve İzin Verilen IP politikalarına değişken ile İstemci IP'si eklendi. Bkz1. Bkz2.

• Kimlik Bilgisi (Credential) sayfasına Excel Export özelliği eklendi. Bkz.

• Profilim sayfasında kişiye öntanımlı olarak proje seçilebilmesi özelliği getirildi. Böylece her ekran açıldığında proje seçme zorunluluğu kalmış oldu. Bkz.

• API Proxy Grup üzerinden gelen istekler için API Trafik detayı üzerinden grup bilgisinin görüntülenebilmesi sağlandı.

• Görev Akışları'nda Kubernetes Apinizer ile yönetilmiyorsa uyarı mesajının ekrana getirilmesi sağlandı ve ekrandaki WARN mesajı düzenlendi.

• Yönetim menüsü altındaki değişkenler menüsüne sık kullanılan değerler varsayılan olarak eklendi.

• Ortam oluşturma sırasında gitops ve normal yöntemlerde cache ve worker server adreslerinin trim edilmesi sağlandı.

• JSON Schema kütüphanesi değiştirildi. Bkz.

• API Trafik ekranlarında Request Address alanının her zaman tek parça halinde görünmesi sağlandı.

• API Proxy'de specifikasyonlarda Swagger olarak gösterim ekrandan kaldırıldı, endpoint ile erişiminin devamı sağlandı.

• Base64 Decode/Encode aracının yanına XML/JSON formatlama özelliği getirildi. İsmi Veri İşlemleri olarak değiştirildi. Bkz.

• SOAP to REST'te SOAP reparse edildiğinde şablondaki var olan ayarların kalması sağlandı.

• API Ürünleri arayüzü iyileştirildi. Bkz.

• Path paramda "/" lar arasında path param olarak "" kullanımı genişletilerek "/değer{param}/" şeklinde de kullanılabilmesi sağlandı.

• API Portal'de kimlik ve analitik bilgilerinin konfigürasyondan alınması sağlandı. Bkz.

• Analitik raporları standartlaştırıldı. Bkz.

• Adım adım izleme log kayıtlarında MongoDB kısıtından dolayı body boyutuna 1MB sınır eklendi.

• API Proxy, adım adım izleme (trace) sekmesine yenile (refresh) ve sil (delete) butonları eklendi. Bkz.

HATA DÜZELTMELERİ

APNZ-3373 : Genel Bakış sayfasındaki grafiklerde hatalar var.

APNZ-3373 : Anomali Dedektörüne ait sonuçlar ekran hatası var.

APNZ-3625 : API Proxy Trafiği ekranındaki gelişmiş filtreleme yapıldığında, başlık ve parametre alanlarına ait sorgular hatalı çalışıyor.

APNZ-3715 : Proje bazında, analitik yetkili kullanıcı tarafından API Proxy Trafik üzerinde test konsolu açarken hata alınıyor.

APNZ-3730 : Plain-Text Kimlik Doğrulama politikasında varsayılan ayarlar ekran yenileyince yansımıyor.

APNZ-3731 : Çalışma Süresi (Uptime) Monitörü yeniden deneme sayısı gibi yönlendirme bazlı ayarlar ile çalışırken hata veriyor.

APNZ-3743 : Script politikasında Execute Script butonuna tıklandığında hata fırlatıyor.

APNZ-3745 : Çalışma Süresi (Uptime) Monitörü'nde, eylem varken yeni bir eylem eklenmeye çalışırken, bir önceki eylemin çalışmıyor.

APNZ-3786 : Kubernetes Resources sayfasına girince Kubernetes'te çalışan nginx pod ve servislerinden kaynaklı hatalar alınıyor.

APNZ-3789 : API bazlı kota metota eklendiğinde, API Proxy bazında çalışıyor.

APNZ-3820 : API Proxy Grup yüklendiğinde hata fırlatıyor.

APNZ-3834 : WSDL dosyası yüklenerek KPS tipinde API Proxy oluştururken, yükleme sırasında hata alınıyor.

APNZ-3845 : API Proxy Dışa Aktar sayfasında tüm API Proxy'ler listelenmiyor.

APNZ-3889 : Script politikasında statusCode alanı default 401 olarak geliyor.

APNZ-3897 : Yanıt hattına eklenen Script politikasına ait status code değeri gözükmüyor.

APNZ-3898 : API Trafik loglarının kaydedilmesi esnasında, response body alanının boş olması durumunda kaydolmuyor.

APNZ-3754 : Kafka bağlantısındaki string list veri tipinde sorun var.

APNZ-3795 : URL bilgisi, API Proxy'nin Genel Bakış sekmesinde geliyor, listesinde gelmiyor.

APNZ-3883 : Task Integration modülünde database connector'de MySQL dışında bir seçim yapıldığında pool tanımlarını hatalı getiriyor.

APNZ-3715 : Proje bazında Analitik yetkili kullanıcı tarafından API Proxy Trafik üzerinde test konsolu açarken hata alınıyor.

APNZ-3984 : Takımı olan bir projede, bir takımı silerken ya da geri eklerken diğer takımların 'id'lerinin siliniyor.

APNZ-3699 : API Proxy gelişmiş aramada ortam (environment) sorgusu hatalı çalışıyor.

APNZ-3723 : Görev Akış Yönetiminde veritabanı aksiyonu ile yapılan işlemlerinde bir süre sonra hata alınıyor.

APNZ-3843 : API Proxy Trafik kayıtlarında istek Http Metodu Options olarak geldiğinde trafikte gösterilen yanıt süresi hatalı gösteriliyor.

APNZ-3797 : Yönetim menüsü altındaki Değişkenler sayfasında son sekmeye tıklanınca hata alınıyor.

APNZ-3840 : Bağlantı Konfigürasyonları ekranlarındaki LDAP kısmında zorunlu alanlar doldurulduktan sonra ortam (environment) seçilmeden test edilebiliyor ve hata veriyor. İsim ve parola alanları zorunlu olmadığı halde bu alanları girmeden test ve kayıt edilemiyor.

APNZ-3863 : Proje içerisindeki API Proxy Trafik ekranındayken API Proxy isimlerine tıklandığında 404 hatası alınıyor.

APNZ-3891 : Anomali tespiti için sorgu oluştururken "there is an invalid condition" uyarısı ile kaydetmeyi engelleme hatasıa alınıyor.

APNZ-3901 : Keystore ve truststore'da, eğer mevcut ortam silinip yenisi oluşturulursa ortam seçilemiyor.

APNZ-3568 : Mock API'de gövdenin belli bir karakter sayısından sonrası ekranda gösterilmemelidir.

APNZ-3349 : Görev Akış Yönetimi ekranında:

• Access URL yazıldıktan sonra kayboluyor,
• Mevcut deploy'un portu değiştirilemiyor,
• Ortam değişkenlerini (environment variables) iki kere yazıyor, birini silince hepsini siliyor.

APNZ-3561 : Bağlantılar (connection) Görev Akış Yönetiminde önbelleğe alınıyor/siliniyor.

APNZ-3946 : API Proxy Trafik ekranında gövdeye tıklandığında veri yenileniyor.

APNZ-3952 : API Analitik yetkisine sahip kullanıcı Raporlar ekranını göremiyor.

APNZ-3955 : Ortam (environment) üzerindeki Konnektörler üzerinde sonradan Gizlilik Ayarı düzeltilmek istenirse Salt gelmiyor.

APNZ-3959 : API Portal'dan Kimlik Bilgisi (Credential) eklendiğinde ACL'ye eklenip ortam (environment) olmadığı için 401 hatası veriyor.

APNZ-3979 : Ortam konnektörlerindeki Gizlilik Ayarlarında delete ve hash yöntemleri hatalı çalışıyor.

APNZ-3983 : Metot bazlı raporlarda bir API Proxy'nin bir metodu query parametresi içeriyorsa her bir değer için ayrı kayıt listeleniyor.

APNZ-3990 : Kimlik Bilgisi (Credential) username değiştiğinde API Gateway'de eski username ile erişilebiliyor.

APNZ-3993 : API Proxy yanıtında aynı header değeri iki defa geçiyorsa sadece bir tanesi istemciye iletiliyor.

APNZ-4001 : Sistem ayarlarında belirtilen süre kadar boşta (idle) kalınmadan uyarı geliyor.

APNZ-4004 : API Designer'da istek ve yanıt gövdelerinin swagger çıktısında hata oluşuyor.

APNZ-4006, APNZ-3465 : API Proxy içerisinde ya da proje içerisinde loglama kapalı olmasına rağmen log yazılıyor.

APNZ-4015 : API Proxy Trafik Log Ayarları'nda ismi olmayan ortam (environment)'lar var.

APNZ-4029 : Audit Token ve Uygulama Loglarını göndermek için konnektör eklendikten sonra kayıt edilemiyor.

APNZ-4030 : Ortamda (environment) Kafka seçince ve configure seçeneği ile sadece yazılması istenen alanlar seçilince Kafka'ya gönderilemiyor.

APNZ-4035 : API Manager'daki API Ürünleri sayfasındaki filtrelerde hata alınıyor.

APNZ-4037 : Uygulama logları, Token logları ve Audit logları konnektöre log göndermiyor.

APNZ-4040 : Analitik ekranındaki filtreleme hatalı çalışıyor.

APNZ-4041 : Webhook konnektörde http bağlantı havuzundan yeni bağlantı alınamıyor.