Azure API Management nedir?

UYGULANANLAR: Tüm API Management katmanları

Bu makalede Azure API Management'ın yaygın senaryolarına ve temel bileşenlerine genel bir bakış sağlanmaktadır. Azure API Management, tüm ortamlarda API'ler için karma, çoklu bulut yönetim platformudur. Hizmet olarak platform olarak API Management, API yaşam döngüsünün tamamını destekler.

Senaryolar

API'ler dijital deneyimlere olanak tanır, uygulama tümleştirmesini basitleştirir, yeni dijital ürünlerin temellerini oluşturur ve veri ve hizmetleri yeniden kullanılabilir ve evrensel olarak erişilebilir hale getirir. API'lerin yaygınlaşması ve artan bağımlılığıyla birlikte, kuruluşların yaşam döngüleri boyunca bunları birinci sınıf varlıklar olarak yönetmesi gerekir.

Azure API Management, müşterilerin şu zorlukları karşılamalarına yardımcı olur:

• API tüketicilerinden soyut arka uç mimarisi çeşitliliği ve karmaşıklığı
• Azure üzerinde ve dışında barındırılan hizmetleri API'ler olarak güvenli bir şekilde kullanıma sunma
• API'leri koruma, hızlandırma ve gözlemleme
• api bulma ve iç ve dış kullanıcılar tarafından tüketimi etkinleştirme

Yaygın senaryolar şunlardır:

• Eski varlıkların kilidini açma - API'ler eski arka uçları soyutlayıp modernleştirmek ve bunları yeni bulut hizmetlerinden ve modern uygulamalardan erişilebilir hale getirmek için kullanılır. API'ler geçiş riski, maliyeti ve gecikmeleri olmadan yeniliklere olanak sağlar.
• API merkezli uygulama tümleştirmesi - API'ler, verileri, uygulamaları ve işlemleri kullanıma sunmak ve bunlara erişmek için kolayca kullanılabilir, standartlara dayalı ve kendini açıklayan mekanizmalardır. Uygulama tümleştirme maliyetini basitleştirir ve azaltır.
• Çok kanallı kullanıcı deneyimleri - API'ler sıklıkla web, mobil, giyilebilir veya Nesnelerin İnterneti uygulamaları gibi kullanıcı deneyimlerini etkinleştirmek için kullanılır. Geliştirme ve yatırım getirisini hızlandırmak için API'leri yeniden kullanın.
• B2B tümleştirmesi - İş ortaklarının ve müşterilerin kullanımına sunulan API'ler, iş süreçlerini tümleştirme ve iş varlıkları arasında veri alışverişinde bulunma engelini düşürür. API'ler noktadan noktaya tümleştirmenin doğasında bulunan ek yükü ortadan kaldırır. Özellikle self servis bulma ve ekleme etkinleştirildiğinde, API'ler B2B tümleştirmesini ölçeklendirmeye yönelik birincil araçlardır.

API Management bileşenleri

Azure API Management bir API ağ geçidi, bir yönetim düzlemi ve geliştirici portalından oluşur. Bu bileşenler Azure tarafından barındırılan ve varsayılan olarak tamamen yönetilen bileşenlerdir. API Management, kapasite ve özellikler bakımından farklı katmanlarda kullanılabilir.

API ağ geçidi

İstemci uygulamalarından gelen tüm istekler önce API ağ geçidine ulaşır ve ardından bunları ilgili arka uç hizmetlerine iletir. API ağ geçidi, arka uç hizmetlerine yönelik bir cephe işlevi görerek API sağlayıcılarının API uygulamalarını soyutlamalarına ve API tüketicilerini etkilemeden arka uç mimarisini geliştirmelerine olanak sağlar. Ağ geçidi yönlendirme, güvenlik, azaltma, önbelleğe alma ve gözlemlenebilirliğin tutarlı bir şekilde yapılandırılmasını sağlar.

Özellikle ağ geçidi:

• API çağrılarını kabul ederek ve bunları uygun arka uçlara yönlendirerek arka uç hizmetlerine bir cephe görevi görür
• API anahtarlarını ve JWT belirteçleri ve isteklerle sunulan sertifikalar gibi diğer kimlik bilgilerini doğrular
• Kullanım kotalarını ve hız sınırlarını uygular
• İsteğe bağlı olarak, ilke deyimlerinde belirtildiği gibi istekleri ve yanıtları dönüştürür
• Yapılandırıldıysa, yanıt gecikme süresini iyileştirmek ve arka uç hizmetlerindeki yükü en aza indirmek için yanıtları önbelleğe alır
• İzleme, raporlama ve sorun giderme için günlükleri, ölçümleri ve izlemeleri yayar

Şirket içinde barındırılan ağ geçidi

Şirket içinde barındırılan ağ geçidiyle, müşteriler API trafiğini iyileştirmek ve yerel düzenlemelere ve yönergelere uyumluluğu sağlamak için API ağ geçidini API'lerini barındırdıkları ortamlara dağıtabilir. Şirket içinde barındırılan ağ geçidi, hibrit BT altyapısına sahip müşterilerin Azure'daki tek bir API Management hizmetinden şirket içinde ve bulutlar arasında barındırılan API'leri yönetmesini sağlar.

Şirket içinde barındırılan ağ geçidi Linux tabanlı bir Docker kapsayıcısı olarak paketlenir ve Azure Kubernetes Service ve Azure Arc özellikli Kubernetes dahil olmak üzere genellikle Kubernetes'e dağıtılır.

Daha fazla bilgi:

• Azure API Management'ta API ağ geçidi

Yönetim düzlemi

API sağlayıcıları, API Management hizmet özelliklerine tam erişim sağlayan yönetim düzlemi aracılığıyla hizmetle etkileşim kurar.

Müşteriler azure portalı, Azure PowerShell, Azure CLI, Visual Studio Code uzantısı, REST API veya çeşitli popüler programlama dillerindeki istemci SDK'ları gibi Azure araçları aracılığıyla yönetim düzlemiyle etkileşim kurar.

Yönetim düzlemini kullanarak:

• API Management hizmet ayarlarını sağlama ve yapılandırma
• OpenAPI, WSDL ve OData tanımları, Azure işlem hizmetleri ve WebSocket, GraphQL ve gRPC arka uçları dahil olmak üzere çok çeşitli kaynaklardan API şemaları tanımlama veya içeri aktarma
• API'leri ürünlere paketleme
• API'lerde kotalar veya dönüşümler gibi ilkeler ayarlama
• Analizden içgörüler alma
• Kullanıcıları yönet

Geliştirici portalı

Açık kaynak geliştirici portalı , API'lerinizin belgeleriyle otomatik olarak oluşturulmuş, tamamen özelleştirilebilir bir web sitesidir.

API sağlayıcıları özel içerik ekleyerek, stilleri özelleştirerek ve markalarını ekleyerek geliştirici portalının genel görünümünü özelleştirebilir. Kendi kendine barındırarak geliştirici portalını daha da genişletin.

Uygulama geliştiricileri API'leri keşfetmek, kullanmak üzere ekleme yapmak ve uygulamalarda kullanmayı öğrenmek için açık kaynak geliştirici portalını kullanır. (API'ler Vatandaş geliştiriciler tarafından keşfetmek ve kullanmak için Power Platform .)

Geliştiriciler, geliştirici portalını kullanarak şunları yapabilir:

• API belgelerini okuma
• Etkileşimli konsol aracılığıyla API çağırma
• Hesap oluşturma ve API anahtarlarını almak için abone olma
• Kendi kullanımlarında analize erişme
• API tanımlarını indirme
• API anahtarlarını yönetme

API Management katmanları

API Management, farklı müşterilerin ihtiyaçlarını karşılamak için çeşitli fiyatlandırma katmanlarında sunulur. Her katman farklı senaryolar için farklı özellikler, performans, kapasite sınırları, ölçeklenebilirlik, SLA ve fiyatlandırmanın ayrı bir bileşimini sunar. Katmanlar aşağıdaki gibi gruplandırılır:

• Klasik - Geliştirici, Temel, Standart ve Premium katmanları da dahil olmak üzere özgün API Management teklifi. Premium katmanı, özel arka uçlara, gelişmiş güvenlik özelliklerine, çok bölgeli dağıtımlara, kullanılabilirlik alanlarına ve yüksek ölçeklenebilirliğe erişim gerektiren kuruluşlar için tasarlanmıştır. Geliştirici katmanı üretim dışı kullanım için ekonomik bir seçenekken Temel, Standart ve Premium katmanları üretime hazır katmanlardır.
• V2 - Geliştirme ve test için Temel v2 ve üretim iş yükleri için Standart v2 dahil olmak üzere hızlı sağlama ve ölçeklendirme sunan yeni katman kümesi. Standart v2, ağdan yalıtılmış arka uçlara basitleştirilmiş bağlantıyı destekler.
• Tüketim - Tüketim katmanı, isteğe göre ölçeklendirilen ve yürütme başına faturalanan API'leri yönetmek için sunucusuz bir ağ geçididir. Sunucusuz işlem, mikro hizmet tabanlı mimariler ve değişken trafik desenlerine sahip uygulamalar için tasarlanmıştır.

Daha fazla bilgi:

• Azure API Management katmanlarının özelliğe dayalı karşılaştırması
• V2 hizmet katmanları
• API Management fiyatlandırması

Azure hizmetleriyle tümleştirme

API Management, aşağıdakiler dahil olmak üzere kurumsal çözümler oluşturmak için birçok tamamlayıcı Azure hizmetiyle tümleştirilir:

• Api bulma, yeniden kullanma ve idare için kuruluştaki API'lerin türü, yaşam döngüsü aşaması veya dağıtım konumu ne olursa olsun eksiksiz bir envanterini oluşturmak için Azure API Center
• API Management ilkeleri yazmaya veya zaten yapılandırılmış ilkeleri açıklamaya yardımcı olmak için Azure'da Copilot
• İstemci sertifikalarını ve gizli dizilerini güvenli bir şekilde güvende tutma ve yönetme için Azure Key Vault
• Yönetim işlemleri, sistem olayları ve API istekleriyle ilgili günlüğe kaydetme, raporlama ve uyarılar için Azure İzleyici
• Canlı ölçümler, uçtan uca izleme ve sorun giderme için Application Insights
• Ağ düzeyinde koruma için sanal ağlar, özel uç noktalar, Application Gateway ve Azure Front Door
• API'ler için Azure Defender ve kötü amaçlı saldırılara karşı çalışma zamanı koruması için Azure DDoS Koruması
• Geliştirici kimlik doğrulaması ve istek yetkilendirmesi için Microsoft Entra Id
• Akış olayları için Event Hubs
• İşlevler, Logic Apps, Web Apps, Service Fabric ve Azure OpenAI hizmeti dahil olmak üzere Azure'da API'ler oluşturmak ve barındırmak için yaygın olarak kullanılan çeşitli Azure işlem teklifleri.

Daha fazla bilgi:

• Temel kurumsal tümleştirme
• Giriş bölgesi hızlandırıcısı
• API Management'tan API Center'a API'leri içeri aktarma

Temel kavramlar

API'ler

API'ler bir API Management hizmet örneğinin temelini oluşturur. Her API, uygulama geliştiricilerin kullanabileceği bir dizi işlemi temsil eder. Her API, API'yi uygulayan arka uç hizmetine bir başvuru içerir ve işlemleri arka uç işlemleriyle eşler.

API Management işlemleri; URL eşleme, sorgu ve yol parametreleri, istek ve yanıt içeriği ve işlem yanıtını önbelleğe alma üzerinde sahip olunan denetim sayesinde yüksek oranda yapılandırılabilir niteliktedir.

Daha fazla bilgi:

• İlk API’nizi içeri aktarma ve yayımlama
• Sahne API yanıtları

Ürünler

Ürünler API'lerin geliştiricilerin kullanımına nasıl sunulduğudur. API Management'taki ürünler bir veya daha fazla API'ye sahiptir ve açık veya korunabilir. Korumalı ürünler için abonelik anahtarı gerekirken, açık ürünler serbestçe kullanılabilir.

Bir ürün, geliştiriciler tarafından kullanılmaya hazır olduğunda yayımlanabilir. Yayımlandıktan sonra, geliştirici portalı kullanılarak geliştiriciler tarafından görüntülenebilir veya abone olunabilir. Abonelik onayı ürün düzeyinde yapılandırılır ve bir yönetici onayı gerektirebilir ya da otomatik olarak onaylanır.

Daha fazla bilgi:

• Ürün oluşturma ve yayımlama
• API Management'taki abonelikler

Gruplar

Gruplar, ürünlerin geliştiricilere görünürlüğünü yönetmek için kullanılır. API Management, geliştiriciler için aşağıdaki yerleşik gruplara sahiptir:

• Geliştiriciler - API'lerinizi kullanarak uygulama oluşturan kimliği doğrulanmış geliştirici portalı kullanıcıları. Geliştiriciler, geliştirici portalına erişim iznine sahiptir ve bir API’nin işlemlerini çağıran uygulamalar oluşturur.

• Konuklar - Geliştirici portalını ziyaret eden potansiyel müşteriler gibi kimliği doğrulanmamış geliştirici portalı kullanıcıları. Bunlara API’leri görüntüleyebilme ancak çağıramama gibi bazı salt okunur erişimler verilebilir.

API Management hizmet sahipleri ayrıca özel gruplar oluşturabilir veya geliştiricilere API ürünlerine görünürlük ve erişim sağlamak için ilişkili bir Microsoft Entra kiracısında dış gruplar kullanabilir. Örneğin, bir iş ortağı kuruluşundaki geliştiricilerin bir üründeki API'lerin belirli bir alt kümesine erişmesi için özel bir grup oluşturun. Bir kullanıcı birden fazla gruba ait olabilir.

Daha fazla bilgi:

• Grupları oluşturma ve kullanma
• Kullanıcı hesaplarını yönetme

Geliştiriciler

Geliştiriciler API Management hizmet örneğindeki kullanıcı hesaplarını temsil eder. Geliştiriciler yöneticiler tarafından oluşturulabilir veya davet edilebilir ya da geliştirici portalından kaydolabilir. Her geliştirici bir veya daha fazla grubun üyesidir ve bu gruplara görünürlük sağlayan ürünlere abone olabilir.

Geliştiriciler bir ürüne abone olduğunda, ürünün API'lerini çağırırken kullanılacak ürün için birincil ve ikincil anahtar verilir.

Daha fazla bilgi:

• Kullanıcı hesaplarını yönetme

Çalışma Alanları

Çalışma alanları merkezi olmayan API geliştirme ekiplerinin kendi API'lerini yönetmesine ve ürünleştirmesine olanak tanırken, merkezi bir API platformu ekibi API Management altyapısını korur. Her çalışma alanı API'leri, ürünleri, abonelikleri ve yalnızca çalışma alanı ortak çalışanları tarafından erişilebilen ilgili varlıkları içerir. Erişim, Azure rol tabanlı erişim denetimi (RBAC) aracılığıyla denetlenir. Her çalışma alanı, API trafiğini arka uç hizmetlerine yönlendiren bir çalışma alanı ağ geçidiyle ilişkilendirilir.

Daha fazla bilgi:

• API Management'taki çalışma alanları

İlkeler

İlkelerle, API yayımcısı yapılandırma aracılığıyla API'nin davranışını değiştirebilir. İlkeler, bir API isteği veya yanıtı üzerinde sırayla yürütülen deyimlerin bir koleksiyonudur. Popüler deyimler, XML'den JSON'a biçim dönüştürmeyi ve bir geliştiriciden gelen çağrı sayısını kısıtlamak için çağrı hızı sınırlamasını içerir. Tam liste için bkz . API Management ilkeleri.

İlke ifadeleri herhangi bir API Management ilkesinde, ilke aksini belirtmedikçe, öznitelik değerleri ya da metin değerleri olarak kullanılabilir. Akışı denetle ve Değişken ayarla gibi bazı ilkeler ilke ifadelerini temel alır.

İlkeler gereksinimlerinize bağlı olarak farklı kapsamlarda uygulanabilir: genel (tüm API'ler), çalışma alanı, ürün, belirli bir API veya API işlemi.

Daha fazla bilgi:

• API'nizi dönüştürün ve koruyun.
• İlke ifadeleri

Sonraki adımlar

Şu hızlı başlangıcı tamamlayarak Azure API Management'i kullanmaya başlayın: