Bir acente yazılımı platformu büyüdükçe dış dünyaya açılan kapılarının sayısı da artar. Web paneli, iOS ve Android uygulamaları, acentelerin kendi web sitelerinden gelen form entegrasyonları, ödeme altyapısının bildirimleri ve iş ortağı sistemleri farklı yollardan farklı servislere ulaşmak ister. Her servis kimlik doğrulamayı, hız sınırlamayı, loglamayı ve güvenlik kontrollerini ayrı ayrı uygularsa hem emek tekrarlanır hem de tutarsızlıklar oluşur. API ağ geçidi, bu ortak sorumlulukları tek bir giriş noktasında toplayan mimari katmandır.
API ağ geçidi ne iş yapar?
Ağ geçidi, istemciler ile arka uç servisleri arasında duran bir ters vekil sunucudur. Gelen her istek önce ağ geçidine ulaşır. Ağ geçidi isteği inceler, gerekli kontrolleri yapar ve uygun arka uç servisine yönlendirir. Yanıt da aynı yoldan geri döner. İstemciler, arka planda kaç servis olduğunu veya bu servislerin nerede çalıştığını bilmek zorunda kalmaz; yalnızca tek bir adresle konuşur.
Temel sorumluluklar
Kimlik doğrulama
Ağ geçidi, gelen isteğin geçerli bir kimlik bilgisi taşıyıp taşımadığını kontrol eder. Erişim jetonunun imzası, süresi ve kapsamı burada doğrulanır. Geçersiz istekler arka uç servislerine hiç ulaşmadan reddedilir. Doğrulanmış kullanıcının kimliği, acente kimliği ve rolleri güvenilir başlıklar olarak arka uca iletilir. Bu sayede arka uç servisleri jeton doğrulama mantığını tekrar uygulamak zorunda kalmaz.
Burada önemli bir ayrım yapılmalıdır: Ağ geçidi kimlik doğrulamayı üstlenir ama ayrıntılı yetkilendirmeyi genellikle üstlenmez. Bir kullanıcının belirli bir müşteri kaydını görüp göremeyeceği, şube ve rol kurallarına bağlı bir iş mantığıdır ve ilgili servisin sorumluluğunda kalmalıdır.
Yönlendirme
İsteğin adresine, yöntemine veya başlıklarına göre hangi servise gideceği belirlenir. Teklif motoruna ait uç noktalar motor servisine, müşteri yönetimi uç noktaları ana uygulamaya, webhook uç noktaları ise ayrı bir alım servisine yönlendirilebilir. Yönlendirme kuralları, monolitten servislere kademeli geçişte de kritik rol oynar: Bir uç nokta yeni servise taşındığında yalnızca ağ geçidindeki kural değişir, istemciler hiçbir şey fark etmez.
Hız sınırlama
Kullanıcı, acente ve uç nokta bazlı hız sınırları ağ geçidinde merkezi olarak uygulanabilir. Aşırı istekler arka uca ulaşmadan durdurulduğu için servisler gereksiz yükten korunur.
Gözlemlenebilirlik
Her isteğin giriş noktası ağ geçidi olduğu için korelasyon kimliğinin üretilmesi veya doğrulanması, erişim loglarının tutulması ve temel metriklerin toplanması için doğal bir yerdir. Hangi uç noktanın ne sıklıkla çağrıldığı, yanıt sürelerinin dağılımı ve hata oranları tek bir kaynaktan izlenebilir.
Protokol ve biçim dönüşümü
Bazı durumlarda istemcinin beklediği biçim ile arka uç servisinin sunduğu biçim farklıdır. Ağ geçidi, basit başlık dönüşümleri, sıkıştırma ve eski bir istemcinin beklediği alan adlarına uyarlama gibi işlemleri üstlenebilir. Ancak bu yetenek dikkatli kullanılmalıdır.
Tasarım tuzakları
Ağ geçidi güçlü bir araçtır; yanlış kullanıldığında ise sistemin en kırılgan parçasına dönüşebilir.
- İş mantığını ağ geçidine taşımak: Teklif hesaplama, branş kuralları veya müşteri doğrulama gibi iş mantığı ağ geçidinde yer almamalıdır. Ağ geçidi akıllı bir yönlendirici olmalı, iş mantığı servislerde kalmalıdır. Aksi halde ağ geçidi, herkesin değiştirmek zorunda kaldığı ve kimsenin tam sahiplenmediği yeni bir monolite dönüşür.
- Tek arıza noktası: Bütün trafik ağ geçidinden geçtiği için ağ geçidinin çökmesi bütün platformu erişilemez kılar. Ağ geçidi birden fazla örnekle, yük dengeleyici arkasında ve otomatik sağlık kontrolleriyle çalıştırılmalıdır.
- Aşırı dönüşüm: Ağ geçidinde karmaşık yanıt birleştirmeleri ve veri dönüşümleri yapmak, hata ayıklamayı zorlaştırır ve performansı düşürür.
- Zaman aşımı uyumsuzluğu: Ağ geçidinin zaman aşımı, arka uç servislerinin beklenen işlem sürelerinden kısa olursa istekler arka uçta tamamlansa bile istemciye hata döner. Uzun süren teklif işlemleri için asenkron desenler kullanılmalı, ağ geçidi zaman aşımları da buna göre ayarlanmalıdır.
İstemciye özel arka uç deseni
Web paneli ile mobil uygulamanın ihtiyaçları farklıdır. Mobil uygulama daha az veri, daha az istek ve bağlantı kopmalarına dayanıklı yanıtlar ister. Web paneli ise geniş tablolar ve ayrıntılı filtreler kullanır. Tek bir genel ağ geçidi yerine her istemci türü için ince bir arka uç katmanı tanımlamak, istemciye özgü veri birleştirmelerini ana servislerden ayırır. Bu desen, mobil ekranların birden fazla servisten veriyi tek istekte almasını sağlar.
Güvenlik katmanı olarak ağ geçidi
Ağ geçidi aynı zamanda ilk savunma hattıdır. İstek boyutu sınırları, izin verilmeyen HTTP yöntemlerinin reddi, güvenlik başlıklarının eklenmesi, bilinen kötü niyetli kalıpların filtrelenmesi ve şifrelenmemiş bağlantıların reddi burada uygulanabilir. Webhook uç noktaları için imza doğrulamanın ilk adımları da ağ geçidi düzeyinde yapılabilir. Yine de ağ geçidi güvenliğin tamamı değildir; servislerin kendi içindeki doğrulamalar devre dışı bırakılmamalıdır.
Ne zaman ağ geçidine ihtiyaç vardır?
Tek bir uygulama sunucusu ve tek bir istemciden oluşan küçük bir sistemde ayrı bir ağ geçidi katmanı gereksiz bir karmaşıklık olabilir. Ağ geçidi, şu koşullardan birkaçı bir arada olduğunda anlam kazanır: Birden fazla arka uç servisi, birden fazla istemci türü, dış iş ortaklarına açılan API'ler ve merkezi güvenlik ile izleme ihtiyacı.
Yapılandırmanın sürüm kontrolü
Ağ geçidi kuralları, kod kadar kritik bir yapılandırmadır. Yönlendirme, hız sınırı ve güvenlik kuralları elle bir yönetim ekranından değiştirilmek yerine sürüm kontrolündeki dosyalarda tutulmalı ve kod incelemesinden geçerek yayına alınmalıdır. Böylece hangi kuralın ne zaman ve neden değiştiği izlenebilir, hatalı bir değişiklik hızla geri alınabilir.
InsureHub ağ geçidi katmanının rolü
InsureHub, sigorta acentelerine yazılım sağlayan bir platform olarak web paneli, mobil uygulamalar ve teklif motoru gibi farklı bileşenlere giden trafiği tutarlı güvenlik ve izleme kurallarıyla yönetmeyi önemser. Bu yaklaşım, mobil sigorta uygulaması ve sigorta teklif programı kullanıcılarına aynı güvenlik standartlarının uygulanmasını sağlar. Platformun teknik yapısını kendi senaryolarınızla incelemek için demo talebi oluşturabilirsiniz.