Versiyon tarihi: 2 Ocak 2024

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

Kaldırılan Özellikler

APNZ-3790 DİKKAT! Log kayıtlarının veri sahibi tarafından kontrol edilerek silinmesi gerekliliği olduğundan, Monitör Ekranlarında, Uygulama Loglarında, API Integration, Raporlar sayfalarında log kayıtlarının retention süresi ile otomatik silinmesi kaldırıldı. Bu kayıtların veri tabanından silinebilmesi için purge scriptleri hazırlandı. Bkz.  

APNZ-3884 ÖNEMLİ! Elasticsearch indekslerini Apinizer ile ekran üzerinden otomatik yedeklemek için kullanılan snapshot politikası ekranları, snapshot politikasının kullanım gereksinimleri sebebiyle kaldırıldı. Bu işlemlerin manuel olarak yapılabilmesi için gerekli scriptler hazırlandı. Bkz.

APNZ-3865 DİKKAT! Eski revizyon mantığı ile ilgili tüm özellikler kullanım zorluğu sebebiyle kaldırıldı. Artık tamamen Versiyon 2023.06.1'de uygulanmaya başlanan "Deployment History" uygulamasına geçildi. Apinizer Yönetim API'lerinde yer alan revizyon parametreleri de kaldırıldı. Bkz.

Yeni Özellikler

APNZ-3684 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.

APNZ-3771 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.

APNZ-3855 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.

APNZ-3772 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.

APNZ-3856 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.

APNZ-3773 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.

APNZ-3854 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.

APNZ-3774 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.

APNZ-3853 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.

APNZ-3779 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.

APNZ-3852 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.

APNZ-3880 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.

APNZ-3880 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.

APNZ-3991 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.

APNZ-3991 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.

APNZ-3775 Ortam bazında Log Konnektörü Tanımlama DİKKAT!

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.

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ı. Bkz.

APNZ-3867 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.

APNZ-3879 Uygulama ve Token Logları için Konnektör Tanımlama DİKKAT!

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. 

APNZ-3484 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.

APNZ-3764 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.

APNZ-2390 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ı.  Bkz1. Bkz2.

APNZ-2940 Sertifika Export Etme

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

APNZ-909 APNZ-3892  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.

APNZ-3968 API Proxy Export/Import API'si

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

APNZ-3615 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.

APNZ-3572 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. Bkz1. Bkz2.

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.

APNZ-3911 Deployment Geçmişinden Revizyon Silme

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

APNZ-3935 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.

APNZ-3951 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.

APNZ-4027 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.

APNZ-4038 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.

APNZ-4013 Script Politikasında Context Value'ları Değiştirme

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

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

APNZ-3768 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.

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

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

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

APNZ-3885 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.

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

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

APNZ-3756 Application Log'unda ortam bilgisinin tutulması sağlandı.

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

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

APNZ-3810 DİKKAT! OAuth2 ve Trace bilgilerinin, Elasticsearch'de loglanması kaldırıldı. OAuth2 ve Trace bilgilerinin Apinizer veri tabanında tutulması sağlandı.

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

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

APNZ-3895 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.

APNZ-3902 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ı.  

APNZ-3761 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.

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

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

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

APNZ-3145 Tüm schedule'lar standartlaştırıldı.

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

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

APNZ-3231 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.

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

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

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

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

APNZ-3980 JSON Schema kütüphanesi değiştirildi. Bkz.

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

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

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

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

APNZ-4031 API Ürünleri arayüzü iyileştirildi. Bkz.

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

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

APNZ-4043 Analitik raporları standartize edildi. Bkz.

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

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

Hata Düzeltmeleri