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

Log ayarları kapalı olsa bile hatalı yanıt durumunda API Trafik Loglarının Konnektöre gönderilmesini etkinleştir

(Enable sending API Traffic Logs to Connector in case of failure in response even if log settings are disabled)

İlgili API Proxy'ye ait loglar kapalı durumda iken ve bu ayar açık olduğunda (varsayılan olarak etkindir), Apinizer'da çalıştırılan politikanın veya backend'den dönen mesajın durumu "Hata" ise; istek ve yanıtın başlık, parametre ve gövdesi loglama durumu kapalı olmasına rağmen yine de ilgili API Trafik Konnektörlere gönderilir. Mesajın durumunun "Blok" veya "Başarılı" olması durumunda API Proxy'nin varsayılan log ayarı geçerli olur.

Bu ayar kapalı olduğunda, API Proxy'nin varsayılan log ayarı geçerli olur.


Mesaj durumu "Hata" Örneği;

  1. Log ayarları kapalı bir API Proxy'de, Script politikası eklenmiş olsun.
  2. Bu politikadaki scripte yanlış yazımdan dolayı API Proxy'e gönderilen istekler hata alıyor olsun.
  3. Bu durumda;
    1. Bu ayar etkin ise, log ayarları API proxy özelinde kapalı olmasına rağmen istek ve yanıtın başlık, parametre ve gövdesi loglanır.
    2. Bu ayar etkin değil ise, log ayarları API proxy özelinde kapalı olduğundan sadece metrik bilgisi loglanır.

Mesaj durumu "Blok" Örneği;

  1. Log ayarları kapalı bir API Proxy'de, throttling politikası eklenmiş olsun.
  2. API Proxy'e gönderilen istekler throttling politikasında sınırın geçilmesi sebebiyle hata alıyor olsun.
  3. Bu durumda mesajın durumu "blok" olduğundan bu ayara bakılmaksızın API proxy log ayarı geçerli olur ve API proxy özelinde kapalı olduğundan istek ve yanıtın başlık, parametre ve gövdesi loglanmaz.

Mesaj durumunun "Hata veya Blok" olması dönülen hata tipinden anlaşılır. Daha fazla bilgi için bu sayfayı ziyaret edebilirsiniz.

API Trafik günlükleri sayfasında istemcinin gönderdiği istek mesaj ile tekrardan istek gönderimini etkinleştirin (Hızlı Test)

(Enable resending requests with the request message sent by the client on the API Traffic logs page (Quick Test))

Bu seçenek etkinleştirildiğinde (varsayılan olarak etkindir); API Trafik günlükleri sayfasında istemcinin gönderdiği istek mesajı ile tekrar istek yapmanızı sağlayan özellik etkinleştirilir.

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ına gidilmelidir.