SAP OData meta verilerini API olarak içeri aktarma

UYGULANANLAR: Tüm API Management katmanları

Bu makalede, OData meta verilerini kullanarak bir OData (Açık Veri Protokolü) hizmetinin Azure API Management'a nasıl aktarıldığı açıklanır. Aşağıdaki örnekte SAP Gateway Foundation kullanılır.

Bu makalede şunları öğreneceksiniz:

• SAP hizmetinizden OData meta verilerini alma
• OData meta verilerini doğrudan veya bir OpenAPI belirtimine dönüştürdükten sonra Azure API Management'a içeri aktarın.
• API yapılandırmasını tamamlama
• Azure portalında API'yi test edin

Önkoşullar

• Bir API Yönetim örneği oluşturun.

• OData v2 veya v4 olarak kullanıma sunulan bir SAP sistemi ve hizmeti.

• SAP arka ucunuz otomatik olarak imzalanan bir sertifika kullanıyorsa (test için), SSL için güven zinciri doğrulamasını devre dışı bırakmanız gerekebilir. Bunu yapmak için API Management örneğinizde bir arka uç yapılandırın:

  1. Azure portalında , API'ler altında Arka Uçlar>+ Yeni arka uç oluştur'u seçin.
  2. SAP arka uç hizmetine işaret eden bir Özel URL ekleyin.
  3. Gelişmiş bölümünü genişletin, ardından Sertifika zincirini doğrula ve Sertifika adını doğrula onay kutularını temizleyin.

  Not

  Üretim senaryolarında uçtan uca SSL doğrulaması için uygun sertifikaları kullanın.

  İpucu

  API Management'ın tam özellik kapsamı için, kaydetmeden önce SAP OData API'sini OpenAPI belirtimine dönüştürün.

SAP hizmetinizden OData meta verilerini alma

SAP hizmetinizden meta veri XML'sini almak için aşağıdaki yöntemlerden birini kullanın. Meta veri XML'sini bir OpenAPI belirtimine dönüştürmeyi planlıyorsanız, dosyayı yerel olarak kaydedin.

• SAP Gateway İstemcisi'ni (işlem /IWFND/GW_CLIENT) kullanın.
• XML'yi almak için doğrudan bir HTTP çağrısı yapın: http://<OData server URL>:<port>/<path>/$metadata.
• Varsa SAP Business Accelerator Hub'ını kullanın.

API Management örneğinize gidin

1. Azure portalındaAPI Management hizmetlerini arayın ve seçin:

   

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

   

API'yi API Management'a aktarma

API'nizi API Management'a aktarmak için aşağıdaki yöntemlerden birini seçin:

• Meta veri XML'sini OpenAPI belirtimine dönüştürün (önerilir).
• Meta veri XML'sini doğrudan OData API'si olarak içeri aktarın.

OpenAPI belirtimi (önerilen)

OData meta verilerini OpenAPI JSON'a dönüştürme

1. OASIS açık kaynak aracının üzerinde oluşturulan Microsoft dönüştürücü kullanın.

   Aşağıdaki örnek, test hizmeti epm_ref_apps_prod_man_srviçin OData v2 XML'yi dönüştürür:

   oasis-converter convert epm_ref_apps_prod_man_srv.xml api.json
   

   Not

   Tek bir XML dosyasıyla test için web tabanlı deneyimi kullanabilirsiniz.

2. API Management'a aktarmak için openapi-spec.json dosyasını yerel olarak kaydedin.

OpenAPI belirtimlerini içeri aktarma

1. Kenar çubuğu menüsünde, API'ler bölümünde API'ler'i seçin.

2. Tanımdan oluştur'un altında OpenAPI kutucuğunu seçin:

   

3. Dosya seç'i seçin ve ardından önceki adımda yerel olarak kaydettiğiniz openapi-spec.json dosyasını seçin.

4. API ayarlarını girin. Bu değerleri API'yi içeri aktarırken ayarlayabilir veya daha sonra Ayarlar sekmesine giderek yapılandırabilirsiniz.

   • API URL'sinin son eki için, geçerli SAP hizmetiyle aynı URL yolunu kullanmanızı öneririz.

   • API ayarları hakkında daha fazla bilgi için, İlk API'nizi İçe Aktarma ve Yayımlama kılavuzuna bakın.

5. Oluştur'i seçin.

Ortamınız için uygun bir yöntem kullanarak arka ucunuzda kimlik doğrulamasını da yapılandırmanız gerekir. Örnekler için bkz . Kimlik doğrulaması ve yetkilendirme.

Not

API içeri aktarma sınırlamaları hakkında bilgi için bkz. API içeri aktarma kısıtlamaları ve bilinen sorunlar.

API’nizi test etme

1. API Management örneğine gidin.

2. Kenar çubuğu menüsünde API API'leri'ni> seçin.

3. Tüm API'ler'in altında içeri aktarılan API'nizi seçin.

4. Test konsoluna erişmek için Test sekmesini seçin.

5. Bir işlem seçin, gerekli değerleri girin ve gönder'i seçin.

   Örneğin, SAP arka sistemine bağlantıyı doğrulamak için GET /$metadata çağrıyı test edin.

6. Yanıtı görüntüleyin. Sorun gidermek için aramayı izleyin.

7. Testi tamamladığınızda test konsolundan çıkın.

OData meta verileri

OData meta verilerini içeri aktarma

1. Kenar çubuğu menüsünde API API'leri'ni> ve ardından + API Ekle'yi seçin.

2. Tanımdan oluştur'un altında OData kutucuğunu seçin:

   

3. API ayarlarını girin. Daha sonra API'nin Ayarlar sekmesine giderek ayarlarınızı güncelleştirebilirsiniz.

   1. OData belirtiminde, OData meta veri uç noktası için bir URL girin. Bu değer, genellikle hizmet köküne eklenen /$metadata ile URL'dir. Alternatif olarak, içeri aktaracak yerel bir OData XML dosyası seçin.

   2. API'nizi yapılandırmak için ek ayarlar girin. Bu ayarlar, İlk API'nizi içeri aktarma ve yayımlama öğreticisinde açıklanmıştır.

4. Oluştur'i seçin.

   API, API listesine eklenir. OData meta veri açıklamasında gösterilen varlık kümeleri ve işlevleri, API'nin Varlık kümeleri ve işlevleri sekmesinde görünür.

   

OData şemasını güncelleştirme

API'nizin OData şemasını görüntülemek için portaldaki bir düzenleyiciye erişebilirsiniz. API değişirse, API Management'taki şemayı bir dosyadan veya OData hizmet uç noktasından da güncelleştirebilirsiniz.

1. Kenar çubuğu menüsünde API API'leri> ve ardından OData API'nizi seçin.

2. Varlık kümeleri ve işlevler sekmesinde, bir varlık kümesinin veya işlevin yanındaki üç noktayı (...) ve ardından Düzenle'yi seçin.

   

3. Şemayı gözden geçirin. Güncelleştirmek istiyorsanız Dosyadan güncelleştir'i veya Uç noktadan şemayı güncelleştir'i seçin.

   

OData API'nizi test edin

1. Kenar çubuğu menüsünde API API'leri> ve ardından OData API'nizi seçin.

2. Varlık kümeleri ve işlevler sekmesinde, bir varlık kümesinin veya işlevin yanındaki üç noktayı (...) seçin ve ardından Test'i seçin.

   

3. Test konsolunda, testinizin şablon parametrelerini, sorgu parametrelerini ve üst bilgilerini girin ve ardından Test'i seçin. Portalda API'leri test etme hakkında daha fazla bilgi için bkz. Portalda yeni API'yi test etme.

OData API'nizin güvenliğini sağlama

OData API istekleri aracılığıyla saldırılara karşı koruma sağlamak için mevcut kimlik doğrulama ve yetkilendirme ilkelerini ve OData doğrulama ilkesini uygulayarak OData API'nizin güvenliğini sağlayın.

İpucu

Portalda API ilkeleri sekmesinde OData API'niz için ilkeleri yapılandırın.

Üretimle ilgili dikkat edilmesi gerekenler

• API'ler için tam yaşam döngüsü koruması, algılama ve yanıt kapsamı sağlamak için Defender for APIs kullanın.
• API Management'i SAP ağ geçidiyle bütünleştirmeye yönelik örnek bir uçtan uca senaryoya bakın.
• API Management ilkelerini kullanarak SAP arka ucuna erişimi denetleme. Örneğin, API bir OData API'si olarak içeri aktarıldıysa, OData isteğini doğrulama politikasını kullanın. SAP ECC veya S/4HANA ya da SAP SuccessFactors için SAP asıl yayma ilkesi parçacıkları ve bir X-CSRF token alma işlemine yönelik politika parçacıkları da vardır.
• API'leri büyük ölçekte dağıtma, yönetme ve geçirme konusunda rehberlik için bkz:
  • APIOps ile otomatik API dağıtımları
  • API'leri yayımlamak için DevOps ve CI/CD kullanma

İlgili içerik

• API içeri aktarma sınırlamaları
• OpenAPI belirtimini içeri aktarma
• SOAP API’sini içeri aktarma
• SOAP API'sini içeri aktarma ve REST dönüştürme
• App Service API'sini içeri aktarma
• Kapsayıcı uygulaması API'sini içeri aktarma
• WebSocket API'lerini içeri aktarma
• GraphQL API’sini içeri aktarma
• GraphQL şemasını içeri aktarma ve alan çözümleyicilerini ayarlama
• İşlev uygulaması API'sini içeri aktarma
• Mantıksal uygulama API'sini içeri aktarma
• Service Fabric hizmetlerini içeri aktarma
• Microsoft Foundry API'sini içeri aktarma
• Azure OpenAI API'lerini içeri aktarma
• LLM API'lerini içeri aktarma
• OData API'sini içeri aktarma
• REST API'yi MCP sunucusu olarak dışarı aktarma
• Mevcut bir MCP sunucusunu kullanıma sunma
• A2A aracı API'lerini içeri aktarma
• SAP OData meta verilerini içeri aktarma
• gRPC API'lerini içeri aktarma
• API’yi düzenleme