Sürüm Notları - 2023

Sürüm 2023.08.1

Yayınlanma Tarihi: 28 Temmuz 2023

APNZ-3746 maddesinde belirtilen değişiklik sebebiyle güncelleme sırasında Veri tabanında aşağıdaki komut çalıştırılmalıdır:
MongoDB v6.0 ve sonrası için:

mongosh "mongodb://MONGOIPADDRESS:25080/apinizerdb" --eval 'db.getSiblingDB("admin").auth("apinizer", "MONGODBPASSWORD"); db.getSiblingDB("apinizerdb").apinizer_log.drop();'

CODE

MongoDB v6.0 öncesi için:

mongo "mongodb://MONGOIPADDRESS:25080/apinizerdb" --eval 'db.getSiblingDB("admin").auth("apinizer", "MONGODBPASSWORD"); db.getSiblingDB("apinizerdb").apinizer_log.drop();'

CODE

APNZ-3709 maddesinde belirtilen değişiklik sebebiyle güncelleme sırasında cache deployment'ına aşağıdaki girdi eklenmelidir

          - name: CACHE_SERVICE_NAME
            value: cache-http-service.ENVIRONMENTNAME.svc.cluster.local

CODE

ÖNEMLI DEĞIŞIKLIKLER VE IYILEŞTIRMELER

• Worker'ın log seviyesinin environment variable ile ilk değer ataması yapılabilmesi sağlandı. Bkz. Ayrıca bu issue ile MongoDB üzerinde tutulan uygulama loglarının 1 saatlik time to live değeri kaldırılarak sınırsız hale getirilmiştir. 

• Public Key, Secret Key ve Sertifikadan JWK oluşturulması sağlandı. Bkz.
• API Entegratörü kapsamında çalışan tüm görevler üzerinde iyileştirmeler yapıldı; Görevleri aktifleştir/devre dışı bırakma alanı eklendi, loop tipindeki görevlerin söz dizimi alanına varsayılan parametre değerini ekleyebilme butonu getirildi, değişken ekleme listesi iyileştirildi ve Çıktı Anahtarı alanı eklendi.
• API Proxy Şablonu ekranına Yönlendirme bazındaki çalışan Bağlantı Ayarları ve Log Ayarları seçenekleri getirildi. Bkz.
• Günlük olarak Kota politikasının sıfırlanması UTC'ye göre değil yerel time zone'a göre olması sağlandı. 
• Anomali Dedektör'ün çalışma mantığı güncellendi ve ekranın kullanıcı deneyimi iyileştirildi. Bkz.
• Veri Tabanı ve LDAP bağlantı tanımlarının ortam bazında test edilmesi sağlandı. Bkz1. Bkz2.
• API Proxy, API Proxy Grup ve Proje bazında, relative path'in biricik olma doğrulaması kaldırılarak, environment bazında biricik olması sağlandı. 
• Ağ Geçidi Ortamı ekranlarının kullanıcı deneyimi iyileştirildi. Bkz1. Bkz2.
• API Proxy'e Backend API versiyonunu metadata alanı eklendi ve Deployment History'sinde bu bilgi gösterildi. Bkz.
• API Proxy'nin yönlendirme bölümü üzerinden bağlantı havuzu (connection pool) ayarının özelleştirilebilmesi sağlandı. Bkz.
• Tüm rapor ekranları Raporlar menüsü altında toplandı. 

HATA DÜZELTMELERI

Sürüm 2023.06.1

Yayınlanma Tarihi: 7 Haziran 2023

YENI ÖZELLIKLER

•  Manuel Kubernetes Yönetimi

Ön tanımlı olarak, Gateway ve Cache sunucuların Kubernetes üzerinde tanımlanması ve yönetilmesi Apinizer üzerinden yapılmaktadaydı. Bu sürüm ile birlikte sadece ilgili metadata tanımlamalarını yapılması ile mevcut Kubernetes kümelerinin manuel olarak yönetilebilmesine imkan sağlandı. Böylece kubernetes ortamlarının Apinizer yönetim konsolu üzerinden yönetim zorunluluğu isteğe bağlı hale getirilmiş oldu. Bkz.

•  Personal API Access Token Oluşturma

Personal API Access Token, Apinizer Management API'ye erişim sürecinde şifre yerine kullanıcının kimliğini doğrulamak için kullanılan jeton bilgisidir. Yönetim konsoluna giriş yapan kullanıcı tarafından kendisine özel olarak üretilmektedir. Bkz.

•  Deployment Geçmişine göre API Proxy'i Geri Yükleme

API Proxy deployment geçmişi üzerinden önceki revizyonuna (deploy edilmiş haline) geri yüklenebilir. Bkz.

ÖNEMLI DEĞIŞIKLIKLER VE IYILEŞTIRMELER

• Job sonuçlarının görüntülendiği ekranlardaki tarih filtreleme alanlarının kullanıcı deneyimi iyileştirildi.
• Genel Ayarlar ekranının kullanıcı deneyimi iyileştirildi.
• ApiOps'a eklenen  API Proxy kaydet ve güncelle metodu ile birlikte API Proxy yoksa kayıt eklemesi, varsa güncellemesi sağlandı.
• ApiOps API'sinde API Proxy kaydet/güncelle işlemlerinde eğer istek mesajında varsa kayıt işlemi sonrası deploy edilmesi ve ayıt işleminde routing bilgilerinin de ayarlanabilmesi sağlandı.

HATA DÜZELTMELERI

Sürüm 2023.05.1

Yayınlanma Tarihi: 18 Mayıs 2023

Bu sürümde veri tabanında tutulan hassas verilerin şifreleme yönteminde yükseltme yapıldığından güncelleme yapılmadan önce veri tabanının yedeğinin alınması önemle tavsiye edilmektedir.

YENI ÖZELLIKLER

• SNMP Bağlantısı Konfigürasyonu Tanımlama

Apinizer üzerinden SNMP protokolünü destekleyen izleme araçlarına veri gönderilebilmesi için SNMP bağlantı tanımları yapılabilir. Bkz.

• SNMP ile Eylem Oluşturma

SNMP Bağlantı tanımları kullanılarak oluşan eylemlerdeki verilerin izleyici sistemlere gönderilebilmesi sağlanır. Bkz.

• Elasticsearch Loglamasını Tamamen Kapatma

Apinizer varsayılan olarak, loglama sürecini Elasticsearch ile yönetir ve Manager konsolu üzerindeki analitik işlemleri için tüm sorgulamalarını Elasticsearch üzerinde yapar. Eğer istenirse, bu özellik devre dışı bırakılabilir. Devre dışı bırakıldığında, analitik modülünün, bazı politikaların ve monitör özelliklerinden mahrum kalınacağına dikkat edilmelidir. Bkz.

• Kafka Entegrasyonu ile Logların Başka Sisteme Aktarılması

Varsayılan olarak, API Proxy'e gelen ve giden mesajın öğeleri, Elasticsearch üzerinde tutulmaktadır. Kafka Entegrasyonu yapılarak, mesajların kuyruk sistemi üzerinde farklı bir uygulamaya aktarımı gerçekleştirilebilir. Bkz.

• mTLS Kimlik Doğrulama Politikası

mTLS Authentication (Mutual Transport Layer Security Authentication) Politikası, Apinizer tarafında yapılan, kimlik doğrulama yöntemlerinden biridir. Bu yöntem, istemci ve sunucu arasında güvenli bir kanal oluşturmak için kullanılan TLS protokolünün bir türüdür. mTLS Authentication kullanıldığında, Apinizer, gelen isteklerdeki istemcinin sertifikasının geçerliliğini kontrol eder ve belirli bir sertifika otoritesinden geldiğinden emin olmak için güvenilir bir sertifika otoritesi (CA) kullanılmasını sağlar. Bkz.

• İsteğe mTLS Ayarını Uygulama

Routing ayarları üzerinden mTLS konfigürasyonu aktifleştirilebilir. Böylece Apinizer'dan hedef hizmete gönderim yapacak olan Apinizer istemcisi, hedef hizmetin sertifikasını doğrular ve kendisinin de bir sertifikası olduğunu ve hedef hizmet tarafından doğrulanması gerektiğini belirtir. Hedef hizmet de istemcinin sertifikasını doğrular ve bu sayede istemci ile güvenli bir iletişim kurulmuş olur. Bkz.

• Kimlik Bilgisine mTLS Ayarını Uygulama

Eğer Kimlik Bilgisi'nin mTLS Authentication Politikası ile sertifikanın doğrulanabilmesi istenirse, Kimlik Bilgisine ait sertifika yüklemesi yapılabilir. Bkz.

• API Proxy Grup bazında Log Ayarları

API Proxy Grup'a eklenen API Proxy'lere gelen ve giden mesaj bilgileri, mesaj ögelerine (başlık, parametre, gövde) göre Elasticsearch veri tabanında loglanıp loglanmayacağı ya da logların tanımlanmış bir sisteme (Syslog, Webhook, RabbitMQ, Kafka) aktarma ayarları yapılabilir. Bkz.

ÖNEMLI DEĞIŞIKLIKLER VE IYILEŞTIRMELER

• API Çağrısı politikasının cache özelliğinin çalışması için Api Proxy'e gelen istekte Cache-Control adlı başlığın olup olmamasına değil, istek hattında isteğin API Çağrısı Politikasına geldiği anda Cache-Control adlı başlığa bakılması sağlandı.
• Global politikaların listelendiği ekranlardaki menüye, Dışa Aktar seçeneği eklendi. 
• Decryption, Encryption ve Digital Signing politikaları içerisindeki tanımlar düzenlenebilir oldu.
• API Proxy EKL ve API Proxy Grup EKL bilgilerinin listesine hangi projede olduğu bilgisi eklendi.
• Uygulama bazında Sorgu, Filtre ve Rapor Üretici oluşturulması sağlandı. Bkz.
• (Uygulama bazındaki) Analitik menüsündeki API Proxies ile Genel Bakış (Overview) ekranı, Genel Bakış sayfası üzerinde birleştirildi. 
• IP Grup Değerlerini İçe ya da Dışa Aktarma
• Denetim Kayıtları (Audit Records) ekranına Object name ve Keyword bilgilerine göre arama filtreleri eklendi.
• Proje dialogunda arama yapma işlemi iyileştirildi.
• Kimlik Bilgisini İçe ya da Dışa Aktarma
• Veri Tabanı Bağlantı Tanımlarını İçe ya da Dışa Aktarma
• API Integration bölümüne ait detay ekranındaki filtreleme seçenekleri ve tablonun okunması iyileştirildi.
• JOSE Doğrulama ve JOSE Gerçekleştirim politikaları hem istek hem yanıt hattına eklenmesi sağlandı.
• İstek hattına eklenen JOSE Doğrulama politikasının içine yetkilendirme alanları eklendi.
• API Proxy Grup'daki bir politikanın API proxy'e uygulanmayacaksa, uyarı ikonunun gelmesi sağlandı.
• DB2API ile metot oluşturma ayarlarına, JSON verisini işlerken optimize etmek için alanlar eklendi. 
• JWK ile üretilen Keypair ya da Keypair Set bilgileri açık şekilde gösterimi düzenlendi.
• Veri tabanında tutulan hassas verilerin şifreleme algoritması yükseltildi.
• Routing'e ait bağlantı ayarlarındaki Error Handling Type özelliğine yeni bir seçenek (Status Code List) eklendi.
• Trafik loglarının dışa aktarımlarında API Proxy'e gelmeyen istekler için log'un aktarımına genel ayarlardan yönetilmesi sağlandı.

HATA DÜZELTMELERI

Sürüm 2023.03.1

Yayınlanma Tarihi: 14 mart 2023

YENI ÖZELLIKLER

•  JSON Web Keypair Set (JWK) Oluşturma

JWK, JSON formatında public key ya da keypair bilgisi tutar. 4 farklı yöntem (key store'dan dönüştürme, URL bağlantısından al, panoya yapıştır, üret) ile 4 farklı tipte (RSA, EC, OCT, OKP) key, key set, keypair ya da keypair set oluşturulabilir. Bu key tanımları, JOSE politikaları ile isteğin üzerindeki mesaj içeriğini doğrulama (validation) ya da imzalama (sign) işlemleri için kullanılırken, yanıt hattındaki içeriğin şifresini açma (decryption) ya da şifreleme (encryption) için kullanılır. 

•  JOSE Doğrulama Politikası

JOSE (Javascript Object Signing and Encryption), "claim" veya genellikle JSON verilerin herhangi iki taraf arasında güvenli aktarımını kolaylaştırmak için kullanılan bir çözümdür.  JOSE Doğrulama Politikası ile imzalanmış olan verilerin imza doğrulaması ve şifrelenmiş olan verilerin deşifre edilmesi işlemleri yapılır.

•  JOSE Implementasyonu Politikası

JOSE (Javascript Object Signing and Encryption), "claim" veya genellikle JSON verilerin herhangi iki taraf arasında güvenli aktarımını kolaylaştırmak için kullanılan bir çözümdür.  JOSE Implementasyon Politikası ile verilerin imzalanması ve şifrelenmesi işlemleri yapılır.

•  Elasticsearch Konfigürasyonu

Eğer loglama direkt olarak Apinizer üzerinden değilde dış bir sistem tarafından Elasticsearch'e yazılmak istenirse, Elasticsearch, read-only moda geçirilebilir. Bu durumda, API Proxy üzerinden gelen giden mesaj logların Elasticsearch kümesine yazımı Apinizer üzerinde durdurulur ve sadece logları okuma aktif olarak yapılır. Böylece, analitik ekranlarının çalıştırdığı sorgulama işlemlerine devam edilir. 

•  Webhook Entegrasyonu ile Logların Aktarımı

Varsayılan olarak, API Proxy'e gelen ve giden mesajın öğeleri, Elasticsearch üzerinde depolanmaktadır. Webhook Entegrasyonu yapılarak, mesajların loglanması farklı bir uygulamaya aktarılabilir.

•  RabbitMQ Entegrasyonu ile Logların Başka Sisteme Aktarılması

Varsayılan olarak, API Proxy'e gelen ve giden mesajın öğeleri, Elasticsearch üzerinde tutulmaktadır. RabbitMQ Entegrasyonu yapılarak, mesajların kuyruk sistemi üzerinde farklı bir uygulamaya aktarımı gerçekleştirilebilir.

•  Sistem Bilgilendirmesi için Alarm Oluşturma

Real-time çalışan sistemlerde, uygulama performansının düşmemesi için sistem kaynak kullanımıyla ilgili durumların probleme dönüşmeden önce yakalanması önemli bir gereksinimdir. Böylelikle, olası problem ile çözüm üretilerek, karşılaşılması önlenir. Alarm ise Apinizer Platformu'nun bulunduğu Kubernetes modülleri ve Elasticsearch kümelerinin, ön tanımlı tetikleme tiplerine göre izlenmesi sağlanır. Eğer verilen eşik değeri aşılmış ise uygulama üzerinde bildirim oluşturulur.

•  Yeni bir Eylem tipi: Bildirim (Notification) Oluşturma

Anomali Dedektörü, Çalışma Süresi Monitörü, API Entegratörü veya Alarm oluştururken zamanlayıcı sonunda, sonucu işlemek için yeni bir eylem olan bildirim oluşturma eylemi eklenebilir. Bu sayede, her iş tanımı çalıştığında  tüm ya da bildirim alınması istenen kullanıcılara bildirim gönderilir. Kullanıcı, uygulamanın arayüzünden bildirimlerini yönetebilir.

•  Bildirimleri Yönetme

Apinizer üzerinde 3 farklı durum sonucunda bildirim oluşturulmaktadır; eylem sonucunu gösteren bildirimler, Hesap/Geliştirici oluşturma istekleri ve API Ürünü abonelik istekleri. Tüm bildirimler, uygulamanın header kısmındaki ikondan görüntülenebilir ve ya ilgili bildirim kategorisine tıklanarak bildirim yönetimi yapılabilir.

•  MongoDB'den Bağlantı Tanımı Oluşturma 

Veri tabanı bağlantı konfigürasyonlarına yeni bir tip olan MongoDB eklendi. 

•  MongoDB ile DB-2-API Find Metodu Oluşturma 

API Creator modülünde olan Db-2-API ile veri tabanından endpoint oluştururken, MongoDB konfigürasyonu ile find sorgusu yazarak endpoint eklenebilir.

•  Tüm API Proxy'nin Log Ayarlarını Proje ya da Uygulama Bazında Kontrol Etme

Önceden Proje, API Proxy Grup ve API Proxy olarak 3 farklı bazda, hangi bölgede hangi mesaj öğelerinin log kaydı alınıp alınmayacağı ayarlanmaktaydı. Log ayarlarının kullanılabilirliği ve yönetilebilirliği iyileştirmek için, sadece API Proxy bazına indirgenmiştir. Log ayarlarını etkinleştirme veya devre dışı bırakmak için 3 farklı ekran bulunur; her API Proxy'nin kendi sayfasından ayarlanabilir ya da Proje ve uygulama bazında bulunan Log Ayarları ekranı üzerinden çoklu olarak API Proxy log ayarlamaları yapılabilir.

•  Pod Probe'ların Kubernetes Resources Ekranından Tanımlama

Kubernetes, konteynerının (container) ne zaman yeniden başlatılacağını, hazır olduğunu ve başlatılacağını bilmek için Probe'ları kullanır. Temel olarak, Probe'lar containerların sağlığını kontrol eder ve yanıt vermeyen uygulamanın yeniden başlatılmasını sağlar. Apinizer'ın üzerinden, Pod'ların Probe'larını tanımlanması sağlandı.

ÖNEMLI DEĞIŞIKLIKLER VE IYILEŞTIRMELER

• Eylemler dialogundaki görünüm ve eylemler oluşturma dialoglarının kullanıcı deneyimi iyileştirildi.
• Spec Tasarımı üzerinden API Proxy oluşturulduğunda, oluşturulan spec tanımından tasarıma devam edilebilmesi sağlandı.   
• API Çağrısı politikasında gövdenin orijinal mesaj verisi düzenlemesi işlemine ekleme operasyonu eklendi.
• API Proxy listesini, yükleme durumuna göre arayabilme filtresi getirildi.
• Kubernetes Resources ekranına podların durumunu gösteren tabloya yenile butonu eklendi.
• API Proxy Trafik ekranına sorguyu cURL olarak kopyalama ve excel olarak dışa aktarma özellikleri eklendi.
• Rapor Üretici ekranına sorgu ve filtreyi düzenleme ve sorguyu cURL olarak kopyalama özellikleri eklendi.
• JWT token'ların saklanması veri tabanı tarafından bağımsız hale getirildi.
• Sertifika, Anahtar ve Key Store ekranları project bazında da yönetilebilir olması sağlandı.
• Audit kaydı için Manager Console girişlerindeki IP bilgisinin X-Forwarded-For alanından alınması sağlandı.
• API Proxy'nin Yönlendirme sekmesinde Circuit Breaker gözükmesi için en az 2 tane adres ekleme kontrolü kaldırıldı.
• Rapor Oluşturma ve Sorgu ekranlarındaki zaman bilgileri (Total Time, API Proxy Time, Backend Time) ait alanlar revize edildi.
• Veritabanlarına ait bağlantı konfigürasyonları ekranları birleştirildi.
• API Proxy ekranına Log Ayarları sekmesi eklenerek, tüm log ayarlarının Ayarlar sekmesinden ayrıldı. 
• Çalışma Süresi Monitörü ve Anomali Dedektörü tanımlarının, uygulama bazında da yönetilmesi sağlandı.
• Veri Tabanı bağlantılarında zorunlu girilmesi gereken kimlik bilgileri, kimlik bilgisi istemeyen bağlantıların desteklenebilmesi için seçimli hale getirildi.
• Plain-Text Kimlik Doğrulama Politikasında şifre (password) alanının seçilmesi isteğe bağlı hale getirildi. Böylece sadece API Key kullanarak servislerin yetkilendirilebilmesi sağlandı.
• Yetki Konfigürasyonunda (Authorization) politikasında rol kontrolü yapılmadan sadece rollerin alınabilmesi sağlandı.
• JWT, OAuth2 ve JOSE Validasyonu politikalarında, eğer Kimlik/Yetki Doğrulama Servisi seçildiyse, bu servisteki rollerin istek başlığına eklenebilmesi durumu sağlandı.
• Hassas Veri Yönetimi, Syslog Entegrasyonu ekranı Log Ayarları menüsüne taşındı.
• KPS Ayarı ve ProCrpyt ekranı Sistem Ayarları menüsüne taşındı.
• API Proxy Raporu, Analitik menüsüne taşındı.
• ACL Raporu ekranı, Kimlik Yönetimi menüsüne taşındı. Önceden uygulama bazında çalışan ekran proje menüsüne de eklendi.
• Analitik menüsündeki API Proxies ekranı kaldırılıp, buradaki tablo verileri, API Proxy Raporu ekranının liste modundaki tablo verileri ile birleştirildi.
• Kimlik Bilgisi ekranına JWK Ayarı tabı getirilerek, JOSE politikaları için kullanılacak olan JWK'nın seçilmesi sağlandı.
• OpenAPI 3.0.3 sürümünün desteklenmesi sağlandı.

HATA DÜZELTMELERI