Kısıtlama Ayarları

Kısıtlama Ayarları, Mirket API Gateway sistemi genelinde API trafiğini belirli zaman aralıklarında geçici olarak kısıtlamanıza olanak tanıyan güçlü bir özelliktir. Bu fonksiyon, 4.9.X versiyonu ile sisteme eklenmiştir ve özellikle bakım çalışmaları, güncelleme süreçleri veya acil durum müdahaleleri sırasında sistem yöneticilerine esneklik sağlar.

Sistem Geneli Kısıtlama Ayarları
Figure 1. Sistem Geneli Kısıtlama Ayarları

Genel Bakış

Zamansal kısıtlama özelliği, tanımladığınız başlangıç ve bitiş zamanları arasında tüm API trafiğini engelleyerek, sistemde yapılacak değişikliklerin güvenli bir şekilde uygulanmasına olanak tanır. Kısıtlama aktif olduğunda, tüm API istemcileri aşağıdaki standartlaştırılmış hata yanıtını alır:

{
    "error": "GW-ERR-055",
    "message": "ERR_TIME_RESTRICTION"
}

Kısıtlama Ayarlarının Yapılandırılması

Kısıtlama oluşturmak ve yönetmek için aşağıdaki adımları izleyin:

  1. Sol menüden Ayarlar → Kısıtlama Ayarları bölümüne gidin.

  2. Zaman Bazlı Erişim Kısıtlaması seçeneğini aktif edin. (onay kutusunu işaretleyin.)

  3. Başlangıç Tarihi alanından kısıtlamanın başlayacağı tarih ve saati seçin

    • Tarih seçmek için takvim simgesine tıklayın.

    • Saat ve dakika değerlerini doğru şekilde ayarlayın.

  4. Bitiş Tarihi alanından kısıtlamanın sona ereceği tarih ve saati seçin.

    • Bitiş tarihi, başlangıç tarihinden sonra olmalıdır.

  5. Kaydet butonuna tıklayarak ayarları uygulayın

Bir kez kaydedildikten sonra, kısıtlama belirlenen zamanda otomatik olarak devreye girer ve bitiş zamanında otomatik olarak devre dışı kalır.

Kullanım Senaryoları

Kısıtlama Ayarları özelliği aşağıdaki durumlarda özellikle faydalıdır:

  • Planlı Bakım Çalışmaları: Sistem bakımı sırasında API trafiğini geçici olarak durdurmak için

  • Veritabanı Operasyonları: Yedekleme veya şema değişiklikleri gibi kritik veritabanı işlemleri sırasında

  • Yük Testi Hazırlığı: Performans testleri öncesi sistemi izole etmek için

  • Acil Durum Müdahaleleri: Güvenlik olayları veya kritik hatalar sırasında trafiği hızla kısıtlamak için

En İyi Uygulamalar

Kısıtlama Ayarları’nı etkili bir şekilde kullanmak için aşağıdaki önerileri dikkate alın:

  • Önceden Bildirin: Kısıtlama oluşturmadan önce tüm API kullanıcılarını ve paydaşları bilgilendirin.

  • Zaman Aralığını Dikkatli Planlayın: Gereken minimum süreyi belirleyin ve ekstra zaman ekleyin.

  • Saat Dilimini Doğrulayın: Sistem saatinin doğru zaman diliminde olduğundan emin olun.

  • Test Edin: Kritik sistemlerde uygulamadan önce kısıtlama özelliğini test ortamında deneyin.

  • İzleyin: Kısıtlama süresi boyunca sistem günlüklerini ve metrikleri takip edin.

Kısıtlamanın Manuel Olarak Kaldırılması

Planlanan bitiş zamanından önce kısıtlamayı kaldırmanız gerekirse, Kısıtlama Ayarları sayfasına geri dönün, onay kutusundaki işareti kaldırın ve Kaydet butonuna tıklayın. Bu işlem kısıtlamayı anında devre dışı bırakır ve normal API trafiği hemen yeniden başlar.