Bu ekranda, uygulama bazında API Proxy'ler için erişim adresi tanımlama, API Trafik Günlüklerinin Konnektöre gönderilmesi, Captcha ve Idle zaman aşımı ayarları, uygulama ve token log ayarları gibi genel ayarlar yapılır.  

Yönetim → Sistem Ayarları → Genel Ayarlar yolunu izleyerek Genel Ayarlar ekranına erişilir.

Değişikliklerinizi kaydetmek için Değişiklikleri Uygula (Apply Changes) butonuna tıklayınız.


Genel Ayarlar ekranını içeren görsele aşağıda yer verilmiştir:


Genel Ayarlar konfigürasyonu için kullanılan alanlar aşağıdaki tabloda görülmektedir.

Alan

Açıklama

API Root ContextAPI Proxy'e erişim için gerekli olan Root Context'in girildiği alandır. Sadece / şeklinde bırakılabilir. Varsayılan değeri: apigateway/.

Kubernetes Namespace ve Resource'ların Apinizer ile yönetilmesini etkinleştir

(Enable the management of Kubernetes Namespace and Resources with Apinizer)

Bu ayar açık ise (varsayılan değer); Gateway ve Cache Server'ların için gerekli olan Namespace, Deployment ve Servis bilgilerinin tümünü API Manager ekranı üzerinden Apinizer'ın standart olarak tanımladığı bilgiler kullanılarak oluşur ve sadece API Manager üzerinden izin verilen kubernetes tanımları yapılır. Güncelleme vs işlemlerini API Manager üzerinden yapılır.

Bu ayar kapalı ise; Gateway ve Cache Server'ların için gerekli olan Namespace, Deployment ve Servis bilgilerinin tümünü API Manager ekranı üzerinden Apinizer'ın standart olarak tanımladığı bilgiler kullanılarak oluşur ve sadece API Manager üzerinden izin verilen kubernetes tanımları yapılır. Güncelleme vs işlemlerini API Manager üzerinden yapılır.
İsteğin politika tarafından engellenmesi durumunda, log ayarları kapalı olsa bile logu etkinleştir.

(Enable logging disabled fields in case request is blocked by policy)

Bu ayar açık ise (varsayılan değer); Politika, isteğin arka uca yönlendirilmesini engelliyorsa, ilgili API Proxy'sine ilişkin log seçenekleri kapalı olsa bile tüm istek ve yanıt alanları Log Konnektörüne gönderilir.

Örneğin mesaj, yetkilendirme politikası tarafından engellendiğinde, ve gelen mesajın log kaydı kapalı olduğunda kimin yetkisiz erişim yapmaya çalıştığı bilinemez. Bu ayarın açık olması durumunda yetkisiz erişimlerde log kaydı kapalı olan alanlar için dahi log tutularak isteğin kimin tarafından geldiğinin bulunması sağlanabilir. Bu özellik normal durumlarda log ayarı kapalı olan alanları saklamayarak sadece özel durumlarda özel durumu anlamak için log kaydını aktifleştiren etkin bir yöntemdir.

Herhangi bir politikada hata olması durumunda, log ayarları kapalı olsa bile logu etkinleştir.

(Enable logging disabled fields in case of Failure or Error at any policy)

Bu ayar açık ise (varsayılan değer); istek veya yanıt hattında herhangi bir hata olması durumunda, ilgili API Proxy'sine ilişkin log seçenekleri kapalı olsa bile tüm istek ve yanıt alanları Log Konnektörüne gönderilir.

Örneğin mesaj, script politikasında scriptin içeriğinden dolayı bir hata aldığında, ve gelen isteğin log kaydı kapalı olduğunda mesajdaki hangi verinin bu hataya yol açtığı bilinemez. Bu ayarın açık olması durumunda hata alınan durumlarda log kaydı kapalı olan alanlar için dahi log tutularak mesajdaki hangi durumun bu sonuca yol açtığının bulunması sağlanabilir. Bu özellik normal durumlarda log ayarı kapalı olan alanları saklamayarak sadece özel durumlarda özel durumu anlamak için log kaydını aktifleştiren etkin bir yöntemdir.

API Trafik Log Kayıtlarında Hızlı Testi Etkinleştir

(Enable Quick Test on API Traffic Log Records)

Bu ayar açık ise (varsayılan değer); API Trafik günlükleri sayfasında istemcinin gönderdiği istek mesajı ile tekrar istek yapmanızı sağlayan özellik etkinleştirilir.

Yönetim API'lerini Etkinleştir 

(Enable Management APIs)

Bu seçenek etkinleştirildiğinde (varsayılan olarak etkindir); Yönetim API'leri ile ekran uygulamasına gerek olmaksızın bir çok işlemi yapabilir, Apinizer'ı Devops ortamınıza entegre edebilirsiniz.

Çoklu Login Ayarı 

(Multi Login Settings)
Kullanıcıların farklı lokasyonlardan ve tarayıcılarının farklı sekmelerinden giriş yapmasına izin vermek için bu ayar aktif hale getirilir.

Güvenli Bağlantılarda Hostname Doğrulamasını Etkinleştir

(Enable Hostname Verification For Secure Connections)
Etkinleştirilirse, SSL/TLS Bağlantılarında ana bilgisayar adının eşleştiğinden emin olmak için sunucu sertifikasının ortak adını (CN) ve konu alternatif adlarını (SAN'lar) kontrol eder, aksi takdirde SSL/TLS bağlantılarında ana bilgisayar adı doğrulaması devre dışı bırakılır.

Captcha Doğrulaması için İzin Verilen Toplam Yanlış Giriş Sayısı

(Total Incorrect Logins Allowed for Captcha Validation)

Yönetim konsoluna giriş sırasında Captcha doğrulamasının aktif olması için kullanıcının öncesinde kaç tane hatalı giriş işlemi yapması gerektiği girilir. Varsayılan değeri 3 olarak ayarlanmıştır.

Girişi Kilitlemek için Captcha Doğrulama ile İzin Verilen Toplam Yanlış Giriş Sayısı

(Total Number of Incorrect Logins Allowed with Captcha Verification to Lock Login)

Yönetim konsoluna giriş sırasında kullanıcı girişini kilitlemek için kaç adet yanlış Captcha doğrulaması yapılabileceğinin sayısı girilir. Varsayılan değeri 7 olarak ayarlanmıştır.

Oturum Boşta Kalma Süresi

(Idle Time)

Yönetim konsoluna giriş sırasında kullanıcının uygulamaya giriş yapıp etkin bir işlem (click, scroll vs.) yapmadan uygulamada kalabileceği süredir. Saniye cinsindedir. Varsayılan değeri 235 olarak ayarlanmıştır.

Oturum Boşta Kalma Süresi Zaman Aşımı

(Idle Timeout)

Oturum boşta kalma zamanı bittiğinde, kullanıcıya Kal (Stay) ya da Çıkış Yap (Log Out) seçeneklerinin sunulduğu dialogun bekleme süresidir. Saniye cinsindedir. Varsayılan değeri 5 olarak ayarlanmıştır.

Navbar Rengi 

(Navbar Color)

Apinizer navbar rengi buraya girilen hex koduna göre belirlenebilir. Bu özellikle birden fazla Apinizer Yönetim Konsolu kullananların ortamları ayırt etmesinde kolaylık sağlamaktadır. 

API Proxy'nin Tutulacak Geçmiş Revizyon Bilgisi Sayısı

(Total History Count of API Proxy's Revision)

API Proxy, her deploy veya undeploy yapıldığında, kaç tane deployment bilgisinin veri tabanında saklanacağı bilgisi girilir. API Proxy bazında, deployment history üzerinden rollback yapmak için kullanılır. Sabitlenen geçmiş değerleri bu sayıya dahil değildir. Varsayılan değeri 6 olarak ayarlanmıştır.

XML içindeki oluşturulacak maksimum element sayısı

(Maximum number of elements to be created in XML)

WSDL'den örnek XML üretilirken oluşturulacak olan XML'in sahip olabileceği maksimum element sayısı girilir.

XML içindeki oluşturulacak elementlerin iç içe kaç seviye olabileceği sayısı

(The depth number of nested levels of elements to be created in XML)

WSDL'den örnek XML üretilirken oluşturulacak olan XML'in sahip olabileceği elementlerin iç içe kaç seviye olabileceği sayısı girilir.

Üretilen XML'in mesaj boyutu olarak maksimum kaç KB olabileceği bilgisi

(Maximum message size of the generated XML in KB)

WSDL'den örnek XML üretilirken oluşturulacak olan XML'in mesaj boyutu olarak maksimum kaç KB olabileceği girilir.

Uygulama logları Apinizer konfigürasyon veritabanına kaydedilsin

(Write application logs to the Apinizer configuration database)

Api Manager uygulamasındaki loglama ayarlarına göre uygulamayla ilgili loglar uygulama konteynırında akmaktadır ve ilgili konteynır kapatıldığında veya baştan başlatıldığında silinmektedir. Bu ayar ile birlikte bu loglanan verilerin Apinizer'ın konfigürasyon veritabanında tutulup tutulmayacağı ayarlanır.

  • Bu ayarı açık seçerseniz (varsayılan  değer);  İlgili loglar Apinizer konfigürasyon veritabanında tutulup Uygulama Logları (Application Logs) sayfasında görüntülenebilir olacaktır.
  • Bu ayarı kapalı seçerseniz; İlgili loglar Apinizer konfigürasyon veritabanında tutulmayacak ve Uygulama Logları sayfasında görüntülenebilir olmayacaktır.

Uygulama logları diğer hedeflere kaydedilsin

(Write application logs to other targets)

Uygulama loglarının Apinizer konfigürasyon veritabanına yazımından bağımsız olarak bu logların belirli bir konnektör yardımıyla başka bir uygulamaya gönderilmesi için bu alanda konnektör seçimi yapılabilir.

Token logları Apinizer konfigürasyon veritabanına kaydedilsin

(Write token logs to the Apinizer configuration database)

Api Manager uygulamasındaki loglama ayarlarına göre veriler uygulama konteynırında akmaktadır ve ilgili konteynır kapatıldığında veya baştan başlatıldığında silinmektedir. Bu ayar ile birlikte bu loglanan verilerin Apinizer'ın konfigürasyon veritabanında tutulup tutulmayacağı ayarlanır.

  • Bu ayarı açık seçerseniz (varsayılan değer);  İlgili loglar Apinizer konfigürasyon veritabanında tutulup Token Logları (Token Logs) sayfasında görüntülenebilir olacaktır.
  • Bu ayarı kapalı seçerseniz; İlgili loglar Apinizer konfigürasyon veritabanında tutulmayacak ve Token Logları sayfasında görüntülenebilir olmayacaktır.

Token logları diğer hedeflere kaydedilsin

(Write token logs to other targets)

Token loglarının Apinizer konfigürasyon veritabanına yazımından bağımsız olarak bu logların belirli bir konnektör yardımıyla başka bir uygulamaya gönderilmesi için bu alanda konnektör seçimi yapılabilir.

Audit logları Apinizer konfigürasyon veritabanına kaydedilsin

(Write audit logs to the Apinizer configuration database) 

API Manager uygulamasındaki loglama ayarlarına göre veriler uygulama konteynırında akmaktadır ve ilgili konteynır kapatıldığında veya baştan başlatıldığında silinmektedir. Bu ayar ile birlikte bu loglanan verilerin Apinizer'ın konfigürasyon veritabanında tutulup tutulmayacağı ayarlanır.

  • Bu ayarı açık seçerseniz (varsayılan değer);  İlgili loglar Apinizer konfigürasyon veritabanında tutulup Audit Logları (Audit Logs) sayfasında görüntülenebilir olacaktır.
  • Bu ayarı kapalı seçerseniz; İlgili loglar Apinizer konfigürasyon veritabanında tutulmayacak ve Audit Logları sayfasında görüntülenebilir olmayacaktır.

Audit logları diğer hedeflere kaydedilsin

(Write audit logs to other targets)

Audit loglarının Apinizer konfigürasyon veritabanına yazımından bağımsız olarak bu logların belirli bir konnektör yardımıyla başka bir uygulamaya gönderilmesi için bu alanda konnektör seçimi yapılabilir.

Toplam yanlış giriş hakkı için belirlenen değer aşıldığında, kullanıcı artık kilitli (locked) duruma getirilir ve bir daha uygulamaya giriş yapamaz. Kilitli kullanıcının erişim iznini açmak için, Sistem Yöneticisi tarafından Kullanıcılar sayfası kullanılmalıdır.