Azure API Management ilkelerini ayarlama veya düzenleme

Bu makalede, Azure portalında ilke tanımlarını düzenleyerek API Management örneğinizde ilkeleri yapılandırma adımları gösterilmektedir. Her ilke tanımı, BIR API isteği ve yanıtı üzerinde sıralı olarak çalışan gelen ve giden deyimlerinin sırasını açıklayan bir XML belgesidir.

Portaldaki ilke düzenleyicisi, API yayımcılarının ilke tanımlarına ilke eklemesi ve düzenlemesi için kılavuzlu formlar sağlar. XML'yi doğrudan ilke kodu düzenleyicisinde de düzenleyebilirsiniz.

İlkeler hakkında daha fazla bilgi:

Önkoşullar

Api Management örneğine ve arka uç API'nize sahip değilseniz bkz:

API Management örneğinize gidin

  1. Azure portalında API Management hizmetlerini arayın ve seçin.

    Select API Management services

  2. API Management hizmetleri sayfasında API Management örneğinizi seçin.

    Select your API Management instance

Portalda ilkeyi yapılandırma

Aşağıdaki örnekte, portaldaki ilke düzenleyicisinde iki seçenek kullanarak bir ilkenin nasıl yapılandırılır gösterilmektedir:

  • Birçok ilkeyi yapılandırmayı basitleştirmek için kılavuzlu form tabanlı düzenleyici
  • XML'yi doğrudan ekleyebileceğiniz veya düzenleyebileceğiniz bir kod düzenleyicisi

Bu örnekte, ilke belirli gelen IP adreslerinden gelen istekleri filtreler. Kapsamı seçili bir API olarak belirlenmiştir.

Dekont

Tüm API'ler, bir ürün veya tek bir API işlemi gibi diğer kapsamlarda ilkeler yapılandırabilirsiniz. Diğer örnekler için bu makalenin devamında yer alan Kapsamı yapılandırma bölümüne bakın.

İlkeyi yapılandırmak için:

  1. API Management örneğinizin sol gezinti bölmesinde API'ler'i seçin.

  2. Daha önce içeri aktardığınız bir API'yi seçin.

  3. Tasarım sekmesini seçin.

  4. İlkeyi tüm işlemlere uygulamak için Tüm işlemler'i seçin.

  5. Gelen işleme bölümünde + İlke ekle'yi seçin.

    Add policy in API Management

  6. Gelen ilkesi ekle bölümünde eklenecek ilkeyi seçin. Örneğin, IP adreslerini filtrele'yi seçin.

    Filter IP addresses policy

    Bahşiş

    • Gösterilen ilkelerin kapsamı, yapılandırmakta olduğunuz ilke bölümüyle (bu örnekte, gelen işleme için) belirlenmiştir.
    • İstediğiniz bir ilkeyi görmüyorsanız Diğer ilkeler kutucuğunu seçin. Bu işlem XML kod düzenleyicisini açar ve bu bölüm ve kapsam için ilkelerin tam listesini görüntüler.
  7. İzin Verilen IP'ler>+ IP filtresi ekle'yi seçin ve API isteğinde bulunmalarına izin verilen bir dizi gelen adresin ilk ve son IP adreslerini ekleyin. Gerekirse diğer IP adresi aralıklarını ekleyin.

    Configure allowed IP addresses

  8. Değişiklikleri API Management ağ geçidine hemen yaymak için Kaydet'i seçin.

    Ip filtresi ilkesi artık Gelen işleme bölümünde görünür.

İlkeleri farklı kapsamlarda yapılandırma

API Management, ilke bölümlerinin her birinde birden çok kapsamda ilke tanımlarını yapılandırma esnekliği sağlar.

Önemli

Her kapsam veya ilke bölümünde tüm ilkeler uygulanamıyor. Eklemek istediğiniz ilke etkinleştirilmediyse, bu ilke için desteklenen bir ilke bölümünde ve kapsamında olduğunuzdan emin olun. bir ilkenin ilke bölümlerini ve kapsamlarını gözden geçirmek için, İlke başvuru konularının Kullanım bölümünü denetleyin.

Dekont

Arka uç ilkesi bölümü yalnızca bir ilke öğesi içerebilir. Varsayılan olarak, API Management ilkeyi forward-request genel kapsamdaki Arka Uç bölümünde ve base diğer kapsamlardaki öğesinde yapılandırılır.

Genel kapsam

Genel kapsam, API Management örneğinizdeki Tüm API'ler için yapılandırılır.

  1. API Management örneğinizin sol gezinti bölmesinde API'ler Tüm API'ler'i seçin.>

  2. Tasarım sekmesini seçin.

    Configure policy at product scope

  3. İlke bölümünde, form tabanlı bir ilke düzenleyicisi kullanmak için + İlke ekle'yi seçin veya XML'yi doğrudan eklemek ve düzenlemek için /> (kod düzenleyicisi) simgesini seçin<.

  4. Değişiklikleri API Management ağ geçidine hemen yaymak için Kaydet'i seçin.

Ürün kapsamı

Ürün kapsamı seçili bir ürün için yapılandırılır.

  1. Soldaki menüden Ürünler'i ve ardından ilkeleri uygulamak istediğiniz ürünü seçin.

  2. Ürün penceresinde İlkeler'i seçin.

    Configure policy at global scope

  3. İlke bölümünde, form tabanlı bir ilke düzenleyicisi kullanmak için + İlke ekle'yi seçin veya XML'yi doğrudan eklemek ve düzenlemek için /> (kod düzenleyicisi) simgesini seçin<.

  4. Değişiklikleri API Management ağ geçidine hemen yaymak için Kaydet'i seçin.

API kapsamı

API kapsamı, seçilen API'nin Tüm işlemleri için yapılandırılır.

  1. API Management örneğinizin sol gezinti bölmesinde API'leri ve ardından ilkeleri uygulamak istediğiniz API'yi seçin.

  2. Tasarım sekmesini seçin.

  3. Tüm işlemler’i seçin.

    Configure policy at API scope

  4. İlke bölümünde, form tabanlı bir ilke düzenleyicisi kullanmak için + İlke ekle'yi seçin veya XML'yi doğrudan eklemek ve düzenlemek için /> (kod düzenleyicisi) simgesini seçin<.

  5. Değişiklikleri API Management ağ geçidine hemen yaymak için Kaydet'i seçin.

İşlem kapsamı

İşlem kapsamı seçili BIR API işlemi için yapılandırılır.

  1. API Management örneğinizin sol gezinti bölmesinde API'ler'i seçin.

  2. Tasarım sekmesini seçin.

  3. İlkeleri uygulamak istediğiniz işlemi seçin.

    Configure policy at operation scope

  4. İlke bölümünde, form tabanlı bir ilke düzenleyicisi kullanmak için + İlke ekle'yi seçin veya XML'yi doğrudan eklemek ve düzenlemek için /> (kod düzenleyicisi) simgesini seçin<.

  5. Değişiklikleri API Management ağ geçidine hemen yaymak için Kaydet'i seçin.

İlke yapılandırmalarını yeniden kullanma

API Management örneğinizde yeniden kullanılabilir ilke parçaları oluşturabilirsiniz. İlke parçaları, bir veya daha fazla ilke yapılandırmanızı içeren XML öğeleridir. İlke parçaları, ilkeleri tutarlı bir şekilde yapılandırmanıza ve XML kodunu yinelemeye veya yeniden yazmanıza gerek kalmadan ilke tanımlarını korumanıza yardımcı olur.

İlke tanımına ilke parçası eklemek için ilkeyi include-fragment kullanın.

İlke değerlendirme sırasını ayarlamak için öğesini kullanma base

İlke tanımlarını birden fazla kapsamda yapılandırıyorsanız, API isteğine veya yanıtına birden çok ilke uygulanabilir. Farklı kapsamlardaki ilkelerin uygulanma sırasına bağlı olarak, isteğin veya yanıtın dönüşümü farklı olabilir.

API Management'ta, öğesinin her kapsamdaki ilke tanımındaki her bölüme yerleştirilerek base ilke değerlendirme sırasını belirleyin. öğesi, base bir sonraki daha geniş (üst) kapsamda bu bölümde yapılandırılan ilkeleri devralır. base öğesi varsayılan olarak her ilke bölümüne eklenir.

Dekont

Geçerli kapsamdaki geçerli ilkeleri görüntülemek için, ilke düzenleyicisinde Etkin ilkeyi hesapla'yı seçin.

İlke düzenleyicisini kullanarak ilke değerlendirme sırasını değiştirmek için:

  1. Yapılandırdığınız en dar kapsamdaki tanım ile başlayın. İlk olarak hangi API Management'ın uygulanacağı.

    Örneğin, genel kapsamda ve API kapsamında yapılandırılan ilke tanımlarını kullanırken, API kapsamındaki yapılandırmayla başlayın.

  2. Üst kapsamda ilgili bölümden base tüm ilkelerin devralınacağı yeri belirlemek için öğesini bir bölüme yerleştirin.

    Örneğin, API kapsamında yapılandırılan bir inbound bölümde, genel kapsamdaki bölümde yapılandırılan inbound ilkelerin devralınacağı yeri denetlemek için bir base öğe yerleştirin. Aşağıdaki örnekte, genel kapsamdan devralınan ilkeler ilkeden ip-filter önce uygulanır.

    <policies>
      <inbound>
          <base />
            <ip-filter action="allow">
                <address>10.100.7.1</address>
            </ip-filter>
      </inbound>
      [...]
    </policies>
    

    Dekont

    • öğesini bir bölümdeki herhangi bir ilke öğesinin base önüne veya arkasına yerleştirebilirsiniz.
    • İlkelerin üst kapsamdan devralınmasını önlemek istiyorsanız öğesini kaldırın base . Çoğu durumda bu önerilmez.
  3. İlke tanımlarındaki öğesini ardışık olarak daha geniş kapsamlarda yapılandırmaya base devam edin.

    Genel kapsamlı bir ilkenin üst kapsamı yoktur ve içindeki öğesini kullanmanın base hiçbir etkisi yoktur.

Azure için Microsoft Copilot kullanarak ilke oluşturma konusunda yardım alma (önizleme)

Azure için Microsoft Copilot (önizleme), Azure API Management için ilke yazma özellikleri sağlar. Söz dizimini bilmeden belirli gereksinimlerinize uyan veya size açıklanmış ilkeleri önceden yapılandırmış ilkeler oluşturmak için API Management'ın ilke düzenleyicisi bağlamında Azure için Copilot kullanın.

Azure için Copilot'tan ilke tanımları oluşturmasını isteyebilir, ardından sonuçları ilke düzenleyicisine kopyalayabilir ve gerekli ayarlamaları yapabilirsiniz. Farklı seçenekler hakkında içgörü elde etmek, sağlanan ilkeyi değiştirmek veya zaten sahip olduğunuz ilkeyi netleştirmek için sorular sorun. Daha fazla bilgi edinin

Önemli

Azure için Microsoft Copilot (önizleme) için kayıt gerekir ve şu anda yalnızca onaylı kurumsal müşteriler ve iş ortakları tarafından kullanılabilir. Daha fazla bilgi için bkz. Azure için Microsoft Copilot'a sınırlı erişim (önizleme).

İlkelerle çalışma hakkında daha fazla bilgi için bkz: