API ilkelerini uygulama

Azure API Management

Fiodar Sazanavets

Senior Software Engineer at Microsoft

API ilkelerine giriş

• Kapı görevlisi gibi: kimin gireceğini kontrol eder
• Hız sınırı tabeleleri gibi: trafik akışını yönetir
• Sorun çıkaranları engelleyerek API’leri korur
• İstekleri kısıtlar; kimse sistemi bunaltamaz
• API Gateway’e giren/çıkan her şey ilkelerle kontrol edilir

API Yönetimi ilkelerine genel bakış

• İlkeler, basit XML ile yazılmış güçlü kurallar kümesidir
• Bir istek-yanıt hattı olarak düşünebilirsiniz
• Trafiği şekillendirmek için farklı aşamalara kurallar ekleyebilirsiniz
• En iyi yanı: arka uç kodunuza dokunmanız gerekmez

Örnek: geriye dönük uyumluluk

İlke kapsamları

• İlkeler küresel ve kurum genelinde olabilir
  • Bu kurallar tüm API’leri kontrol eder
• Tekil API’lere uygulanabilir
  • Belirli bir ürünü yönetmemizi sağlar
• Tekil uç noktalara uygulanabilir
  • İnce taneli kontrol için kullanılır

Inbound ilkeler

• İstek geldiğinde APIM önce inbound ilkeleri değerlendirir
• Örnek: Eski uygulama sürümlerini yeni API’lerle uyumlu kılmak için yük verisini zenginleştirme
• Inbound ilkeler kötü niyetli girişimleri engelleyebilir
• Hatalı istekleri veya eksik veriyi saptarlar
• Bu erken koruma, kötü verinin servislere ulaşmasını önler

Güvenlik ve sınırlama

• Bunlar aşırı istemcileri sınırlar; adil kullanım ve arka uç koruması sağlar

• Inbound ilkeler güvenlikten de sorumludur
• Yaygın bir ilke: bir JWT’yi (JSON Web Token) doğrulama
• JWT’yi istemcinin gönderdiği dijital kimlik kartı gibi düşünün
• validate-jwt ilkesi jetonun geçerli, süresi dolmamış ve güvenilir bir sağlayıcıdan (örn. Entra ID) geldiğini kontrol eder
• Daha sıkı kontrol için: hız sınırı ve kota ilkeleri

Outbound ilkeler

• Arka uç işleminden sonra outbound ilkeler yanıtları döndürmeden önce ayarlar
• Restoran benzetmesi: istek -> mutfak (arka uç) -> sunum istasyonu (outbound ilkeler)
• Outbound ilkeler şunları yapabilir:
  • İstenmeyen bölümleri kaldırma (örn. hassas başlıklar)
  • Talimat ekleme (örn. önbellekleme yönergeleri)
  • Biçimi değiştirme (örn. XML’i JSON’a çevirme)

• Yanıtlar, arka ucun hazırlığından bağımsız olarak istemci beklentilerini karşılar

Hadi pratik yapalım!

Azure API Management