İçeriğe geç
Teknoaktif
Son haberler
Genel

API Gateway Mimarisi: Kong, Envoy ve Traefik ile Hız Sınırlama (Rate Limiting) ve Kimlik Doğrulama

Yayın:

Bölüm 1: Bu Nedir ve Neden Hayati Önem Taşır?

Hayatınızın en yoğun anında, kapınızı çalan herkesin içeri girmesine izin verir misiniz? Elbette vermezsiniz. Kapıda bir güvenlik görevlisi, bir de misafir listesi bulundurursunuz. İşte API Gateway (API Ağ Geçidi), mikro servis mimarisinin o kapıdaki güvenlik görevlisidir. Kong, Envoy veya Traefik gibi araçlar, sistemlerinize gelen her isteği (request) karşılayan, kimliğini kontrol eden, “Sen kimsin? Nereye gitmek istiyorsun? Daha önce kaç kez geldin?” diyen o kritik kontrol noktasıdır.

Eğer bu kapıyı zayıf kurarsanız; sisteminiz birden fazla kötü niyetli istekle (DDoS), yetkisiz veri çalma girişimleriyle veya sadece bir hata sonucu sonsuz döngüye giren bir istemciyle çökebilir. Hız sınırlama (Rate Limiting) “Bir dakikada en fazla 100 kez gelebilirsin” derken, kimlik doğrulama (Authentication) “Geçerli biletin var mı?” der. Bu ikisi bir arada olmazsa, arka plandaki hassas veritabanlarınız ve servisleriniz korumasız kalır. Bu yazıda, bu kapıyı nasıl en sağlam şekilde kurabileceğimizi ve unutulduğunda başımıza ne gelebileceğini anlatacağız.

Bölüm 2: Perde Arkası: Sistem Nasıl Çalışıyor?

Diyelim ki bir e-ticari sitesiniz var. Kullanıcı “Sepete Ekle” butonuna bastığında, bu istek doğrudan “Sepet Servisi”ne gitmez. Önce API Gateway‘e düşer. Gateway, trafiğin polisi gibi davranır. Gelen isteğin başlığında (header) bir token (JWT, API Key vb.) var mı bakar. Yoksa “401 Yetkisiz” cevabı döner, istek asla servise ulaşmaz. Token varsa, imzasını doğrular, süresi dolmuş mu kontrol eder.

Hemen ardından Hız Sınırlama (Rate Limiting) motoru devreye girer. “Bu kullanıcı son 1 dakikada 50 istek attı, limit 100, geçebilir” der veya “Limit aşıldı, 429 Too Many Requests hatası ver, biraz bekle” der. Kong bu işi eklenti (plugin) mimarisiyle, Envoy ise filtre zincirleriyle, Traefik ise middleware’lerle yapar. Hepsi aslında: Kimsin? -> İznin var mı? -> Sıklığın uygun mu? -> Geç, git servise mantığıyla çalışır. Bu akış milisaniyeler sürer ama sistemin hayati kan damarlarını korur.

API Gateway Mimarisi: Kong, Envoy ve Traefik ile Hız Sınırlama ve Kimlik Doğrulama Görsel İncelemesi
Mikro servis mimarisinde API Gateway, trafiğin merkezi kontrol noktasıdır. Kong, Envoy ve Traefik bu kapıdaki farklı “güvenlik ekibi” seçenekleridir; hepsi aynı amaca hizmet eder ama araçları ve felsefeleri farklıdır.

Bölüm 3: Bilim Dünyası ve Uzmanlar Nasıl İnceliyor?

Mühendislik dünyasında “Gateway Pattern” (Ağ Geçidi Deseni) yıllardır standart bir konudur. Ancak son yıllarda CNCF (Cloud Native Computing Foundation) ekosistemi bu alanı olgunlaştırdı. Uzmanlar (örneğin Martin Fowler veya Chris Richardson gibi mimariler) Gateway’i “Akıllı Uç Nokta (Smart Endpoint)” yapmaktan ziyade, “Aptal Boru (Dumb Pipe)” tutup mantığı servislere bırakmaya yakın duruşta olsa da; güvenlik ve trafik şekillendirme (traffic shaping) konusunda Gateway’in vazgeçilmez olduğu konsensüs vardır.

Arastırmacılar özellikle dağıtık hız sınırlama (distributed rate limiting) algoritmaları üzerinde durur. “Token Bucket” (Jeton Kova) veya “Leaky Bucket” (Sıvı Kova) algoritmaları, birden fazla Gateway örneği (replica) çalışırken “Bu kullanıcının toplam hakkı ne?” sorusunu çözmek için Redis gibi merkezi veri yapılarıyla senkronize edilir. Uzmanlar şunu vurgular: Gateway’i sadece bir “reverse proxy” sanıp konfigüre etmek, ileride “Thundering Herd” (İnanılmaz Kova) gibi sorunlara yol açar. Gözlemlenebilirlik (Observability: Log, Metrik, Trace) olmadan bir Gateway kurmak, gözleri kapalı araba kullanmaktır.

Bölüm 4: Önemli Parametreler ve Karşılaştırma Rehberi

Parametre / Ozellik Kong (Konfigürasyon Odaklı) Envoy (Performans / Proxy Odaklı) Traefik (Otomatik Keşif Odaklı) Pratik Anlami / Gunluk Hayata Etkisi
Kimlik Doğrulama Yöntemi Çok zengin Plugin ekosistemi (JWT, OAuth2, Keycloak, LDAP, Basic Auth). Filter zincirleri ile harika; ama her şeyi kod/yaml ile elle yaparsınız. Middleware ile basit; ForwardAuth, BasicAuth, JWT destekler. Kong: Hazır çözüm isteyen ekipler için hayat kurtarıcı. Envoy: Özel mantık yazacak ekip varsa en güçlüsü. Traefik: Kubernetes’te “sadece çalışsın” diyorsanız en pratik.
Hız Sınırlama (Rate Limiting) Stratejisi Local, Redis, Database tabanlı; Fixed Window, Sliding Window, Token Bucket. Global Rate Limit Servisi (RatelimitService gRPC) ile merkezi, çok güçlü. In-memory (tek node) veya Redis backend ile basit middleware. Kong/Envoy: Çoklu veri merkezi, yüksek trafikte tutarlılık sağlar. Traefik: Küçük/orta ölçekte basitlik kazandırır, büyük ölçekte Redis şart.
Performans / Gecikme (Latency) Lua (OpenResty/Nginx) üzerinde çalışır; plugin sayısı arttıkça ms cinsinden artar. C++ çekirdeği, son derece düşük gecikme, yüksek throughput. Go dili, çok hızlı; ancak middleware zinciri uzarsa etkilenir. Envoy: Saniyede milyonlarca istek için kral. Kong: Plugin yükü yönetilmezse “bottleneck” olur.
Yapılandırma Yönetimi Declarative (deck), Admin API, Konfigürasyon veritabanı (Postgres/Cassandra). xDS API (Control Plane – Istio, Consul Connect vb. ile). File, Docker, Kubernetes CRD (IngressRoute), Consul, Etcd. Traefik: K8s’e push ettiğin an çalışır (GitOps dostu). Kong: Merkezi DB/Deck ile kurumsal kontrol. Envoy: Control Plane olmadan yönetimi zordur.
Gözlemlenebilirlik (Observability) Prometheus, Datadog, Zipkin, OpenTelemetry pluginleri hazır. İçinde doğası gereği (statsd, prometheus, tracing) her şey var. Prometheus, OpenTelemetry, Datadog, Jaeger entegrasyonu hazır. Hepsi standartlara uygun; Envoy veri hacmi en yüksek, Traefik kurulumu en kolay.
Öğrenme Eğrisi / Ekip Yeterliliği Orta. Plugin mantığı öğrenilirse hızlı. Lua bilmek ileri seviye için artı. Çok Yüksek. xDS, Filter chain, Bootstrap config bilgisi şart. Düşük. Docker label / K8s annotation ile başlarsınız. Startup/Küçük ekip: Traefik. Kurumsal/Standartlaşma: Kong. Platform Ekibi/Service Mesh: Envoy.
Service Mesh Uyumu Kong Mesh (Kuma tabanlı) ayrı bir ürün. İstio, Linkerd, AWS App Mesh’in beyni. Mesh’in kendisidir. Traefik Mesh (eski), artık Mesh yerine Ingress/Gateway API odaklı. Eğer Service Mesh kuracaksanız Envoy kaçınılmaz. Sadece API Gateway lazımsa Kong/Traefik daha mantıklı.

Bölüm 5: Günlük Hayatta ve Doğada Nerede Karşımıza Çıkar?

Hayatınızdan bir örnek: Akıllı Ev Sisteminiz. Gece yarısı sensörleriniz “Hareket var” der ve ampulleri yakmak için buluttaki “Işık Servisi”ne istek atar. Eğer bir hata olursa ve sensör saniyede 100 istek atarsa? Rate Limiting yoksa, bulut faturanız patlar, servis çöker, eviniz karanlıkta kalır. API Gateway (örneğin Traefik veya Kong) burada “Bu cihaz dakikada en fazla 10 istekte bulunabilir” kuralını koyar, faturanızı ve sisteminizi kurtarır.

Başka bir senaryo: Bankacılık Uygulaması. Giriş yaparken JWT token alırsınız. Bu token 15 dakika geçerlidir. Siz uygulamayı kapatıp 20 dakika sonra açarsınız. Gateway (Envoy veya Kong), tokenın süresinin dolduğunu anlar, “401 Unauthorized” döner, sizi giriş ekranına yönlendirir. Bu arada arka plandaki “Hesap Bakiyesi Servisi” asla rahatsız edilmez.

Doğadan bir benzetme: Arıların petek girişindeki koruma arıları. Her arı, gelenin feromonunu (token/kimlik) kontrol eder. Yabancı bir arı veya sıklıkla gelen bir saldırgan (çarşaf böceği) tespit edilirse girişe izin verilmez. Sistem, “Hız sınırlama” sayesinde petek kaynaklarını (bal, polen, servis CPU/RAM) tüketime karşı korur.

API Gateway Mimarisi: Kong, Envoy ve Traefik ile Hız Sınırlama ve Kimlik Doğrulama Detay Görseli
Gerçek hayattaki bir “Token Bucket” (Jeton Kova) mekanizması görselleştirilmesi. Kullanıcı her istekte bir jeton harcar. Kova boşalırsa istek reddedilir. Kova belirli bir hızda (refill rate) yenilenir. Bu, trafik patlamalarını (burst) emmek için idealdir.

Bölüm 6: Karşılaşılan Zorluklar ve Pratik Çözümler

1. “Çok Katmanlı Kimlik Doğrulama” Tuzağı:
Hem Gateway’de JWT doğruluyorsunuz, hem servis içinde tekrar verify(token) çağırıyorsunuz.
* Çözüm: Gateway tek yetkili olsun. Servisler X-User-ID veya X-Roles header’ını güvenip (Gateway bu header’ları temizleyip yeniden eklerse) tekrar doğrulama yapmasın. Bu “Zero Trust” gibi durur ama performans için “Gateway Trust” şarttır.

2. Dağıtık Rate Limiting’te “Race Condition” (Yarış Durumu):
İki Gateway pod’u aynı anda Redis’e “Sayacı artır” der. Her ikisi de eski değeri okur, 1 artırır, yazar. Sonuç: 2 artmış olur, 1 artmış sayılır. Kullanıcı limiti aşar.
* Çözüm: Redis Lua Script atomik operasyonu kullanın (INCR + EXPIRE tek komutta) veya Kong/Envoy’in yerleşik “Sliding Window” algoritmalarını (Redis tabanlı) kullanın. Elle GET -> SET yapmayın.

3. “Token Bucket” vs “Fixed Window” Kafası:
Sabit pencere (Fixed Window: 00:00-00:01) kullanırsanız, kullanıcı 00:00:59’da 100, 00:01:01’de 100 istek atar. 2 saniyede 200 istek = Sistem çöker.
* Çözüm: Sliding Window Log (hassas ama maliyetli) veya Sliding Window Counter / Token Bucket (dengeli) kullanın. Traefik’te average parametresi, Kong’da policy: sliding bu işi çözer.

4. Gateway Çökerse Her Şey Çöker (Single Point of Failure):
Gateway tek bir makinede veya 1 replikaysa, o makine gittiğinde sistem tamamen kapanır.
* Çözüm: En az 3 replika, arkasındaki Load Balancer (AWS ALB, Cloudflare, MetalLB) ve Health Check endpoint’i (/health veya /ready). Veritabanı (Postgres/Cassandra/Redis) için de HA (High Availability) şart.

5. Gözlemlenebilirlik Olmayan “Kara Kutu”:
“Neden 429 veriyor?” diye log bakarsınız, yok. “Hangi kullanıcı en çok limit yiyor?” metrik yok.
* Çözüm: OpenTelemetry entegrasyonu zorunlu. rate_limit_exceeded_total metrikleri, http.request.rate_limit.remaining header’ları response’a eklensin. Grafana dashboard’ı kurun.

Bölüm 7: Gelecek Perspektifi ve Yeni Gelişmeler

Dünya Kubernetes Gateway API (v1.0+ GA) standardına doğru evriliyor. Artık Ingress nesnesi eskisi gibi değil; Gateway, HTTPRoute, GRPCRoute, ReferenceGrant nesneleriyle çok daha zengin, çok kiracılı (multi-tenant) ve güvenli bir yapı sunuyor. Traefik, Kong (Ingress Controller), Envoy Gateway (yeni proje) hepsi bu standarda uyum sağlıyor. Bu demek oluyor ki; yarın Kong’dan Envoy’e veya Traefik’e geçmek, YAML dosyalarınızı yeniden yazmak değil, sadece GatewayClass değiştirmek kadar basit olacak.

WASM (WebAssembly) ise oyun değiştirici. Envoy zaten WASM filtreleriyle C++/Rust/Go kodunu runtime’a yükleyebiliyor. Kong da WASM desteği getirdi. Artık “Özel bir kimlik doğrulama mantığım var, Lua yazayım mı?” demek yerine, Rust ile yazıp sandbox ortamında güvenle çalıştırıyorsunuz. Performans kaybı minimal, güvenlik maksimum.

AI Trafiği (LLM Gateway) yeni savaş alanı. Kurumlar artık “ChatGPT / Yerel LLM API” trafiğini kontrol etmek için Gateway kullanıyor. “Günlük 1000 token limiti”, “Hassas veri (PII) maskeleme”, “Prompt Injection koruması” gibi yeni plugin’ler (Kong AI Proxy, Envoy AI Filter) piyasaya sürülüyor. API Gateway artık sadece “Yönlendirici” değil, İçerik Denetleyici oluyor.

Bölüm 8: Merak Edilen Sorular ve Cevaplar (SSS)

Soru 1: Benim için hangisini seçmeliyim: Kong, Envoy mu Traefik?

Cevap: Eğer Kubernetes’teyseniz ve “sadece çalışsın, SSL al, yönlendir” diyorsanız Traefik en kolayıdır. Kurumsal bir ekibiniz var, standart plugin’ler (OAuth2, LDAP, Transform) lazımsa ve veritabanı (Postgres) yönetmekten çekinmiyorsanız Kong en rahatınız. Eğer bir Platform/Altyapı ekibisiniz, Service Mesh (Istio) kuracaksınız veya saniyede milyonlarca isteği mikrosaniye gecikmeyle işleyecek “motor” lazımsa Envoy (veya Istio/Envoy Gateway) tek seçenektir.

Soru 2: Rate Limiting’i Gateway’de mi, Uygulama kodunda mı yapmalıyım?

Cevap: Gateway’de yapın. Uygulama kodunuz “İş mantığına” (Business Logic) odaklansın. “Bu kullanıcı kaç kez çağırdı?” saymak, token doğrulamak, IP banlamak altyapı işidir. Gateway bunu merkezi, tutarlı ve dilsiz (polyglot) yapar. Uygulamanız Go, Python, Java olsun; hepsi aynı korumayı alır. Kodunuzda if (rateLimitExceeded) return 429 yazmayın.

Soru 3: JWT token’ı Gateway’de doğrulamak güvenli midir? Public key’i nasıl yönetirim?

Cevap: Çok güvenlidir, hatta önerilir. Public Key (JWKS) için Gateway’iniz bir JWKS URI (örn: https://auth.sirket.com/.well-known/jwks.json) yapılandırır. Gateway bu endpoint’i periyodik olarak (cache ile) çeker, anahtarları bellekte tutar. Token geldiğinde imzayı yerel olarak doğrular, Auth Servisine gitmez. Bu hem hızlı hem de Auth Servisinizi DDoS’ten korur. Private Key asla Gateway’de olmaz, sadece Public Key olur.

Soru 4: “Burst” (Patlama) trafiğini nasıl handle ederim? Kullanıcım aniden 1000 istek atabilir.

Cevap: Token Bucket (Jeton Kova) algoritmasını kullanın. rate: 100 (dakikada 100), burst: 200 (kova kapasitesi 200) ayarlarsınız. Kullanıcı 1 dakika gelmezse kova dolu olur (200 jeton). Aniden gelirse 200 isteği anında işler (burst), sonra dakikada 100’er jeton eklenerek yavaşlar. Bu “Spiky” (buruşuk) trafikler için en adil ve sistem dostu yöntemdir. Fixed Window bunu engeller, Sliding Window Log hafızayı yorar.

Soru 5: Gateway’im çökerse sistemim tamamen mi kapanır? Bunu nasıl önlerim?

Cevap: Evet, tek nokta hatası (SPOF) riski vardır. Çözüm: Gateway’i Stateless (Durumsuz) tutun. Kong’da DB’yi (Postgres) ayırın, Envoy’de Control Plane’i ayırın. Gateway pod’larını HPA (Horizontal Pod Autoscaler) ile CPU/Request metriclerine göre ölçeklendirin. Minimum 3 replika, farklı Availability Zone’larda çalıştırın. Önüne bir Cloud Load Balancer (AWS ALB, GCP LB, Cloudflare) koyun. Gateway çökse bile LB sağlıklı olanı bulur.

Soru 6: Kong’da “Database-less” (DB’siz) mod ne işe yarar? Kullanmalı mıyım?

Cevap: Kesinlikle kullanın (Declarative Config). Veritabanı (Postgres/Cassandra) bir daha az bağımlılık, bir daha az bakım, bir daha az “split-brain” riski demektir. deck sync veya kong config db_import ile YAML dosyalarınızı Gateway’e push edersiniz. GitOps (ArgoCD/Flux) ile tam entegre olur. Canlıya “Config drift” (yapılandırma sapması) olmaz. Sadece çok büyük klusterlarda (10.000+ route) DB modu performans avantajı verebilir, onun dışında DB’siz standarttır.

Bölüm 9: Bilmeniz Gereken Temel Terimler

API Gateway (API Ağ Geçidi): Mikro servislerinizin önüne geçen, tüm trafiği karşılayan, güvenlik, yönlendirme, hız sınırlama gibi ortak işleri yapan tek giriş kapısı. Kapıdaki güvenlik görevlisi.

Rate Limiting (Hız Sınırlama): Belirli bir sürede (örn: 1 dakika) bir istemcinin (kullanıcı/IP/API Key) yapabileceği maksimum istek sayısını kısıtlama mekanizması. Trafik şamandırası.

Authentication vs Authorization (Kimlik Doğrulama vs Yetkilendirme): Authentication: “Sen kimsin?” (Token/Şifre kontrolü). Authorization: “Sen buna girmeye yetkili misin?” (Rol/İzin kontrolü). Gateway genelde ilkiyi yapar, ikincisini servise bırakır veya basit rol kontrolü yapar.

JWT (JSON Web Token): İki taraf arasında güvenli bir şekilde bilgi (kimlik, yetki, süre) taşiyan, imzalı (signed) bir dijital kimlik kartı. Gateway bunu açar, imzasını kontrol eder, içindekileri okur.

Token Bucket / Leaky Bucket (Jeton Kova / Sıvı Kova): Hız sınırlama algoritmaları. Token Bucket: Kova doluysa aniden gelen patlama trafiğine (burst) izin verir, sonra yavaşlatır. Leaky Bucket: Sürekli sabit hızda sızdırır, patlamayı tamamen engeller, kuyruk oluşturur.

Sidecar Proxy (Yan Proxy): Uygulamanızın yanında, aynı Pod içinde çalışan küçük bir proxy (genelde Envoy). Uygulama “localhost:8080” der, Sidecar müdahale eder, şifreler, loglar, yönlendirir. Service Mesh’in yapı taşı.

Gateway API (Kubernetes Gateway API): Kubernetes’te Ingress’in yerini alacak, çok daha güçlü, rol tabanlı (Infrastructure Provider, Cluster Operator, Developer), protokol bağımsız (HTTP, TLS, TCP, GRPC) yeni standart yönetim arayüzü.

Observability (Gözlemlenebilirlik): Sistemin içini görmek için Log (Olaylar), Metrik (Sayılar), Trace (Yol Haritası) üçgenini toplamak. Gateway olmadan bunu her serviste ayrı yaparsınız; Gateway’de merkezi toplarsınız.

Bölüm 10: Ozet ve Cikarilmasi Gereken Dersler

API Gateway, mikro servis mimarinizin kalbidir, beynidir ve derisidir. Kong, Envoy veya Traefik aracı seçimi, ekibinizin yetkinliğine, ölçeğinize ve mimari hedeflerinize (Service Mesh mi, sadece Ingress mi?) göre değişir; ama prensipler asla değişmez.

Altın Kurallar:
1. Kimlik Doğrulama ve Hız Sınırlamayı Gateway’e taşıyın. Uygulama kodunuzu bu yükten arındırın.
2. Dağıtık Rate Limiting için Redis + Atomik Operasyon (Lua/Sliding Window) şart. Basit sayaç yazmayın.
3. Stateless (Durumsuz) Gateway kurun. Veritabanı bağımlılığını (Kong DB-less, Envoy xDS) minimize edin. GitOps ile yönetin.
4. Gözlemlenebilirlik (Metrics/Logs/Traces) olmadan canlıya çıkmayın. “Neden 429 verdin?” sorusuna cevap veremiyorsanız sisteminiz “kara kutu”dur.
5. Kubernetes Gateway API standardını takip edin. Yarın aracı değiştirmek (Kong -> Envoy Gateway) YAML değiştirmek kadar kolay olmalı.

Unutmayın: En iyi Gateway, varlığını hissettirmeyen,

Bir yanıt yazın

E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir

Ağ Bağlantıları:İşlemci • Donanım Forumu • Bilim Haberleri • Oyun İnceleme • Donanım Rehberi
\n\n