Sürüm Notları - 2022

Versiyon 2022.12.1

Yayınlanma tarihi : 7 Aralık 2022

YENI ÖZELLIK

• Test Konsolu'na Code Snippet sekmesi getirilerek, cURL üzerinden isteği göndermek için gerekli kodun üretilmesi sağlandı. Bkz.

ÖNEMLI DEĞIŞIKLIKLER VE IYILEŞTIRMELER

• API Trafik ekranı arama panelinde, Basit sekmesindeki İstek Adresi (Request Address) ve Gönderilen Adres (Routing Address) alanlarının sorguları geliştirildi. Bkz. Bu geliştirmelerin yapılabilmesi için Index Mapping Type değiştiğinden eski verilerde bu alanların üzerinde arama yapılabilmesi için eski indexlerin reindex yapılması önerilir. Reindex yapılması için Bkz.
• Error response template'in ignore edilme ayarının, API Proxy Grup üzerinden yönetimi sağlandı.  Bkz.
• API Proxy Grup ekranının kullanıcı deneyimi iyileştirildi. Bkz.
• IP Grup seçimi yapılan dialogun kullanıcı deneyimi geliştirildi.
• Kubernetes Resources ekranında Node'ların listelenmesi sağlandı. Bkz.
• API Proxy Grup ekranına tüm metot/endpoint'leri listeme ve filtreleme ve detaylarını görüntüleme için Endpoints tabı eklendi. Bkz.

HATA DÜZELTMELERI

Versiyon 2022.11.1

Yayınlanma tarihi : 1 Kasım 2022

YENI ÖZELLIK

• Log Ayarının, API Proxy üzerinden ayarlanırsa proje bazındaki log ayarını ezmesi ve ters işletilebilmesi sağlandı. Bkz1. Bkz2.
• Kök dizinden sonra metot adı olmadan path parametresi alan metotların çalışması sağlandı.

ÖNEMLI DEĞIŞIKLIKLER VE IYILEŞTIRMELER

• Db-2-API'nin metodu test edildiğinde dönen yanıtın düzenlenebilir olması sağlandı. Böylelikle, kullanıcı örnek yanıt bilgisini değiştirebilir ve ya gizli bilgileri kaldırabilir ve bu bilgilerin API tanım dosyasında doğru gözükmesi sağlar. Bkz.  
• Ortam (Environment) yeniden yayınlandıktan (republish) sonra podların otomatik olarak yeniden başlatılması sağlandı.
• Management API'lerinde API Proxy reparse ve soapToRest ifadelerine bağlı alanların kullanılma zorunluluklarında değişiklik yapıldı. Bkz. 
• Kubernetes Resources sayfasında ortama ait tüm namespace'ler ve bunlara bağlı podların görüntülenmesi, silinmesi ve log bilgisinin görüntülenmesi sağlandı.
• API Proxy metotunun Tanım Dosyasında Saklama (Hide in Spec File) özelliği aktifleştirildiğinde, metodun içerisindeki kullandığı Veri Modeli (Data Model) diğer metotlar tarafından kullanılmıyorsa tanım dosyasından bu model saklanır.
• Kubernetes Resources ekranını üzerinden pod silme imkanı getirildi. Bkz.
• Sorgular (Queries) ve Rapor Üretici (Report Generator) ekranlarında sorgu sonuçlarını excel formatında dışa aktarılması ve sorgu test edildiğinde mesaj bölgelerine ait verilerin (parametre, başlık, gövde) görünümü dialog üzerinden erişme imkanı verildi. Bkz1. Bkz2.
• API Proxy detay sayfasından Hepsini Yükle (Deploy All) seçeneği kaldırdı. Bu işlem, kontrollü olarak ortam bazında yapılmalıdır.
• Proje seçimi yapılan dialogun kullanıcı deneyimi iyileştirildi. Bkz.
• API Trafik (API Traffic) ekranındaki filtre alanına Gelişmiş (Advanced) bölümü eklenerek, kişiselleştirilmiş sorgu filtresi kullanılabilmesi sağlandı. Bkz.
• Proje bazında yer alan API Trafik ekranında API Proxy adına tıklandığında ilgili API Proxy'nin detay sayfasına yönlendirilmesi sağlandı.

HATA DÜZELTMELERI

Versiyon 2022.10.1

Yayınlanma tarihi : 1 Ekim 2022

YENI ÖZELLIK

• Ortak Sorgu Modeli (Data Model) Oluşturma

Ortak Sorgu Modeli, mesajın içerisinde (genellikle gövde bölümündeki) ne tipte verinin olduğunu tarif eden metadata bilgisidir. Global bazlı oluşturulan modeller, API tanım dosyası tasarlanırken kullanılır.

Detaylı bilgi için Tasarım -> Ortak Sorgu Modeli sayfasına bakınız. 

• Kubernetes Resources Yönetimi

Apinizer Platformu'nun Ortamlarıyla ilgili genel ayarları yapma, Pod Security Context tanımlama, sunucuları (Yönetim Konsolu, API Integrator ve API Portal) yapılandırma, podlarını yeniden başlatma ve devre dışı bırakma/kaldırma, tüm podları izleme ve loglarına erişme ve Kubernetes kümesini izleme işlemleri arayüz üzerinden yönetilebilir.

Detaylı bilgi için Sunucu Yönetimi -> Kubernetes Resources sayfasına bakınız. 

• ACL Raporu (ACL Report)

ACL Raporu, hangi API Proxy'ye hangi kurumdaki kullanıcıların erişebildiği ya da hangi kurumdaki kullanıcıların hangi API Proxy'lere erişebildiği bilgisine ulaşılmasını sağlayan rapor ekranıdır. Erişim bilgisine ait Yönlendirme Adresi ve Veri Modeline gibi veriler, filtrelenerek görüntülenebilir. Ek olarak, oluşturulan raporun çıktısı Excel olarak alınabilir.

Detaylı bilgi için Rapor -> ACL Raporu sayfasına bakınız. 

• ACL  Denetim Kayıtları (ACL Audit Records)

ACL Denetim Kayıtları, API Proxy ya da API Proxy Grup'a erişim için onay verilen ya da onayı kaldırılan kimlik bilgilerinin (credential) işlemlerine ait kayıtlar görüntülenir. İşlem tarihi, işlem tipi, sebebi, hangi kullanıcı için geçerli olduğu, hangi API Proxy/API Proxy Grup ve metot için geçerli olduğu gibi bilgiler listelenir ve detaylı filtreleme seçenekleri yer alır.

Detaylı bilgi için Denetim -> ACL Denetim Kayıtları sayfasına bakınız. 

• Yönetim API (Management API)

Apinizer Yönetim API'leri, ekran uygulamasına gerek olmadan API Parse, ReParse, Deploy vb. bir çok işlemin yapılmasını sağlar. Böylelikle, Apinizer, DevOps ortamına entegre edilebilir. 

Detaylı bilgi için Yönetim API sayfasına bakınız. 

• Spec Tasarım Editörünün (Spec Designer) Arayüzü Yenilendi

Spec Tasarım Editörü, arayüz üzerinden form doldurarak yeni bir API Tanım Belgesi oluşturulmasına ya da var olan API Tanım Belgelerinin içe aktarılarak kullanılmasına izin verir. Bu arayüz, kullanıcı deneyiminin iyileştirilmesi için revize edilmiştir.

Detaylı bilgi için Tasarım -> Spec Tasarım Editörü sayfasına bakınız. 

• Giriş Ekranında Captcha Doğrulamasının Yapılması

Apinizer Yönetim Konsoluna art niyetli giriş yapılması önlemek için kullanıcıya belirli sayı da yanlış giriş yapabilme kısıtı getirilmiştir. Kullanıcı ilk aşama da izin verilen yanlış giriş sayısını aştıktan sonra captcha doğrulması aktifleşerek belirlenen giriş denemesinde bulunur. Eğer kullanıcı toplam olarak izin verilen hatalı giriş sayısını aşmış ise kilitlenir (locked) ve artık uygulamaya girişine izin verilmez.

Detaylı bilgi için Sistem Genel Ayarları sayfasına bakınız. 

Kilitlenmiş kullanıcının, tekrar uygulamaya giriş yapabilmesi için Kullanıcılar (User) sayfasından Admin tarafından bu kilidin kaldırılması gereklidir. 

• Idle Zaman Aşımında Kullanıcın Sistemden Çıkarılması

Apinizer Yönetim Konsolunda kullanıcı, belirlenen süre boyunca uygulama üzerinde işlem yapmaması sonucunda oturumu kapatılır.

Detaylı bilgi için Sistem Genel Ayarları sayfasına bakınız. 

• WS-Security STS Token Politikası

Apinizer üzerinden SOAP tipinde olan backend web servisinin Security Token Servisinden Token alınması ihtiyacı bu politika ile giderilir.

Detaylı bilgi için WS-Security STS Token (WS-Security STS Token) sayfasına bakınız. 

• API Proxy Uç Noktalarının Gizlenebilmesi

Rest tipindeki API Proxyler için API Proxy bazında gizleme yapılarak tüm API Tanım Dosyasına erişilmesi ya da metot bazında gizleme yapılarak belirlenen metotların API Tanım Dosyasından erişimi kısıtlanabilir.

API Proxy bazlı erişim kısıtlaması için Ayarlar (Settings) Sekmesi ya da metot bazlı gizleme yapmak için Geliştirme (Development) sekmesine bakınız.

ÖNEMLI DEĞIŞIKLIKLER VE IYILEŞTIRMELER

• API Proxy Grup'un Swagger UI bilgisi görüntülenirken tüm metot sekmelerinin açık gelmesi, API Proxy kriterlerine göre filtreleme yapılabilmesi, metot gruplandırmasının kaldırılması ve alfabetik olarak sıralanması sağlandı. Bkz.
• API Proxy sayfasında Kategori listesine yeni girdinin eklenmesi için Enter tuşu aktifleştirildi.

• API Portal de, anahtara (key) ait Shared Secret bilgisi değiştirebilir ve üretilebilir yapıldı.

• Rapor ve Analitik menüsündeki yer alan ekranın tarih bazlı filtre alanına zaman seçeneği de eklendi.
• Uygulama ekranlarında kod girişi yapılan alanların yeniden boyutlanabilir olması sağlandı.
• Denetim Kayıtları (Audit Records) ekranına Object ID filtresi getirildi. Bkz.
• API Proxy'e ait Yönlendirme (Routing) ayarlarının Bağlantı Ayarları bölümüne, Hata Alınması Durumunda Deneme Sayısı (Error Handling Type) ve buradaki tipe göre Koşul (Condition) girdileri eklendi. Bkz.
• API Proxy'e ait Yönlendirme (Routing) ayarlarının yer aldığı sekmede, yanıttaki hata mesajını özelleştirebilme özelliği eklendi. Bkz.
• API Proxy'yi dışa aktarma linki, API Proxy'nin listelenme ekranındaki açılabilir menüden de ulaşılması sağlandı.
• API Proxy düzenleme sayfasında kullanıcı deneyimi iyileştirmek için, Genel Bakış (Overview), Ayarlar (Settings), Tasarım (Design) ve Yönlendirme (Routing) sekmeleri yenilendi. Bkz (Genel Bakış). Bkz (Ayarlar). Bkz (Tasarım). Bkz (Yönlendirme).
• API Proxy Group düzenleme sayfasında kullanıcı deneyimi iyileştirmek için, Genel Bilgi (Overview) ve Ayarlar (Settings) sekmeleri yenilendi. Bkz.
• Gövde (Body) tipindeki değişkenin tanımlarkeni gövde tipine göre ön tanımlı değerlerle gelmesi sağlandı.  
• Yeni bir kullanıcı (user) eklerken, Kullanıcı Giriş Tipi (Login Type) değeri LDAP ise Apinizer LDAP Giriş sayfasında tanımlanan ayar baz alınarak bilgilerin LDAP'dan sorgulanması uygulandı. Bkz.

HATA DÜZELTMELERI

Versiyon 2022.06.1

Yayınlanma tarihi : 1 Haziran 2022

YENI ÖZELLIK

• Elasticsearch Snapshot Ayarları (Backup Settings)

Tanımlı Elasticsearch Kümesindeki indekslerin belirlenen zaman aralığında otomatik olarak snapshot yani yedeklemesi (backup) yapılabilir. Bu ayar konfigüre edildiğinde küme üzerinden Snapshot Lifecycle Management (SLM) poliçesi tanımlanmış olur. Dolayısıyla başka bir eklentiye ihtiyaç duymadan kümede yedek ayarları yönetilebilir ve çalıştırılan yedeklerin sonuç bilgilerini içeren geçmiş bilgileri izlenebilir. İstendiği zaman snapshot alımı manuel olarak başlatılabilir. Detaylı bilgi ve kullanım için Elasticsearch Yedekleme Politikası sayfasına bakınız.

• API Portal Ayarlarını/Sayfalarını Kişiselleştirme

API Developer Portal üzerindeki genel ayarlar (logo, başlık) ve sayfaların içerikleri veya bazı alanları(How It Works, SSS, Login, Register) isteğe bağlı olarak özelleştirilebilir. Bu sayede, Portal Yöneticisi istemcilerin kullanacağı içeriklerini kişiselleştirebilir. Böylelikle market dinamikleri ve ihtiyaçları göre içerik yönetimi yapılabilir.  

ÖNEMLI DEĞIŞIKLIKLER VE IYILEŞTIRMELER

• Kimlik Bilgisi (Credential) sayfasına Token Ayarları (Token Settings) eklenerek, kimlik doğrulama ayarlarının Kimlik Bilgisi bazında da yönetilebilmesi sağlandı. Bkz.
• API Proxy içerisinde metot/endpoint düzenleme dialoguna yanıt içeriğine yapılacak işlemi yönetmek için "İndirmeyi Etkinleştir (Enable Download)" alanı ve "Sıkıştırılmış yanıt için (Accept-Encoding değerine göre) Text/ByteArray tipini kullan (Use Base64 Encoded Text/Byte Array For Compressed Response(by Accept-Encoding value))" seçeneği geldi. Bkz.
• API Proxy ekranında Routing Adresine göre arama filtresi eklendi. Bkz.
• API Proxy bazında log4j ayarına ait seviyenin değiştirilmesi sağlandı. Bkz.
• Kimlik Doğrulama (Authentication) Politikaları'nın kolay kullanımı için ekran iyileştirmeleri gerçekleştirildi. Bkz1. Bkz2. Bkz3
• Test Konsolu üzerinden API Tanım dosyasından alınan örnek gövde (body) gösterimi iyileştirildi. 
• API Call Politikasının, İstek (Request) ve Original Message (Orijinal Message) alanlarına ait tüm bölümlerin görünümü düzenlendi. Gövde (Body) bölümlerinin kullanımı iyileştirildi. Bkz.
• API Call Politikasının İstek (Request) bölümüne Cache ayarları getirilerek, seçilen değişkene göre istek sonucunun önbellekten getirilmesini sağlandı. Bkz.
• API Proxy, Trace modda iken API Çağrısı (API Call) politikasının bilgilerinin loglanması sağlandı.
• API Proxy içerisinde XML/JSON Hata Yanıt Şablonu (Error Response Template) ile hata mesajı veya API'den Dönen yanıt mesajı karakterlerini sınırlama yapan yeni değişken tanımları getirildi. Bkz.
• API Proxy ve API Proxy Grup ekranlarındaki deployment bilgilerinin gösterimi geliştirildi. Bkz.
• API Bazlı Kota (Quota) ve API Bazlı Daraltma (Throttling) ekranlarına "Apply by" değeri getirilerek, belirli bir değişken üzerinden bu politikaların çalışması sağlandı. Bkz1. Bkz2.
• Değişkenler (Variables) ekranına "Context Value" tipi ve değerleri ile Parametre tipi için "Form" seçeneği eklendi. Bkz1. Bkz2.
• Ağ Geçidi Ortam (Gateway Environment) ayarlarına, dosya yüklemeleri için multi-part HTTP isteklerine ait ayarları konfigüre etmek için yeni anahtar kavramlar eklendi. Bkz.
• Projeler sayfasındaki üyelerin ve rollerin görünümü yenilendi. Bkz.
• XML Transformer ve JSON Transformer ekranlarına ait hata mesajlarının gösterimi iyileştirildi.
• LDAP bağlantı tanımı ve LDAP Identity Provider ekranlarındaki hata mesajlarının gösterimi iyileştirildi.
• API Proxy'nin Geliştirme (Development) tabında endpointler/metotlar bölümüne hızlı arama özelliği getirildi. Bkz.
• Uygulama Logları (Application Logs) ekranındaki Gateway Engine'e ait loglar üzerinde "Correlation ID"ye göre filtreleme seçeneği eklendi. Bkz.
• Token Requests ekranında Username or Key bilgisinin görüntülenmesi sağlandı. Filtreleme seçeneklerine API Proxy, Username or Key ve Status Code Bigger Than alanları eklendi. Bkz.
• Deployment adres bilgisi üzerinden Swagger ve OpenAPI tanım dosyalarına erişim için yeni metotlar eklendi. Bkz.
• API Proxy Grup'un API tanım dosyasına (API Definition Document) ve API tanım bilgisinin arayüzünü  görüntüleme özellikleri eklendi.
• SOAP2Rest dönüşümlerinin konfigürasyonlarının yapıldığı ekranda ayarlara göre oluşan Yanıt Mesajının görüntülenebilmesi sağlandı.
• Ortam ayarlarında HTTPs sonlandırma için kullanılacak olan keystore dosya tiplerine PKCS12 tipinde olup PFX uzantısına sahip olan dosyalar için de izin verildi. Bkz.
• Key Stores ekranındaki eklenmiş konfigürasyonlarının düzenlenmesi sağlandı. Bkz.
• "isByteArrayContent" değerlerini yönetmek için Ön Tanımlı Değerler (Predefined Variables) menüsüne Byte Array Content Types sayfası yapıldı. Bkz.
• Önbellek Monitörü (Cache Monitoring) ekranında API Proxy Grup ve API Çağrısı için gerekli seçenekler eklendi. Bkz.
• Swagger ve Open API formatındaki API Specification bilgilerine kimlik doğrulama (authentication) bilgisi eklendi.
• API Proxy ayrıştırıldığında (reparsing), ad ve açıklama bilgileri artık original API Proxy'den getirildi.
• Seçili API Proxy Group sayfası üzerinden, tüm API'lerin endpoint'lerini swagger arayüzünde görüntüleme imkanı verildi.
• API Proxy Grup ile API Product oluşturma imkanı verildi.
• API Proxy Grup ayarlarının API Proxy'lere uygula özelliği aktifleştirilse, içerisindeki tüm API Proxy'lere uygulanacak olarak ayarların (CORS, Log Settings, XML/JSON Error Response Template, Forwarded IP Header Parameter ve Log Settings) API Proxy Grup ekranından yönetme olanağı sağlandı.
• API Proxy, API Proxy Grup olarak eklendiyse ilgili API Proxy deployment bilgilerine ek olarak API Proxy Gruba ait deployment bilgilerininde listelenmesi sağlandı.  
• Gateway Instance oluştururken, ilgili ortamın hangi Kubernetes worker sunucusu üzerinde çalışacağı seçimi eklendi.
• Mock API tanımı düzenlenirken bir endpoint'e birden fazla örnek yanıt (example response) ekleme özelliği geliştirildi.
• Proje bazında çalışan ve Kimlik Yönetimi (Identity Management) bölümünü yönetmek için API Security rolü eklendi.
• API Trafik loglarını gösteren listeler ve log detaylarının görüntülendiği dialog alanlarına yenileri eklendi. Filtreleme kriterlerine metot adı eklendi.

• WS-Security to Target poliçesinde Signature bölümüne "Signature Digest Algorithm, Use Single Certificate" alanları ve Encryption bölümüne "Key Identifier Type, Custom Identifier Type, Custom Identifier Type Value Type" alanları eklendi.

• Silinen Elasticsearch Cluster tanımının ILM Poliçe ve Template bilgileri başka bir küme içinde de kullanılabilir hale getirilmesi için "Log Key" alanı düzenlenebilir yapıldı. Bunun dışında, kümelerin listelendiği ekran üzerindeki ILM ve Template durumlarını gösteren kutulara tıklandığında ilgili ILM ya da Template durumu güncellenebilir hale getirildi.

• Sadece local bazlı oluşturulan API Bazlı Kota ve Backend API Authentication politikaları Global Polices menüsü üzerinden global bazlı olarak oluşturulabilir.

• Yedekleme yapılırken seçilen MongoDb koleksiyonları hariç tutulabilir. Böylece log için tutulan kayıtların yedek dosyasına alınmaması sağlanarak yedek dosyası büyüklüğü kontrol edilebilir.

• Ortam Ayarları (Environment Settings) sayfasındaki JWT bilgisinin üretilmesiyle ilgili 2 işlem eklendi; token'ı yeniden oluşturup yükleme ve private key bilgisini dosyadan alıp token'ı üretip yükleme.
• SOAP türündeki API Proxy için metot bazında güncellenebilecek WSA ayarına "SOAP Action" alanı eklendi. 
• Privacy Management üzerindeki genel ayarların API Proxy dışında gelen isteklere de uygulanması sağlandı. Böylece istekler yanlış adrese gönderilse bile sahip olduğu hassas veriler korunmaktadır.

HATA DÜZELTMELERI

Versiyon 2022.02.1

Yayınlanma tarihi : 1 Şubat 2022

ÖNEMLI DEĞIŞIKLIKLER VE IYILEŞTIRMELER

• Kimlik Bilgisi için API Proxy Grup erişim listesi oluşturma imkanı verildi.
• Uygulama Logları ekranında detay ve stack trace bilgilerinin görünümleri düzenlendi.
• Log4J'den kaynaklanan güvenlik açığı kalıcı olarak giderildi.
• Hassas Veri Yönetimi üzerinde oluşturulan tanımlar form-data tipindeki verilere uygulanabilmesi sağlandı.

HATA DÜZELTMELERI