Importeer SAP OData-metadata als een API

Van toepassing op: Alle API Management-lagen

In dit artikel wordt beschreven hoe u een OData-service (Open Data Protocol) importeert in Azure API Management met behulp van OData-metagegevens. In het volgende voorbeeld wordt SAP Gateway Foundation gebruikt.

In dit artikel leert u het volgende:

• Haal OData-metadata op van uw SAP-service
• OData-metagegevens importeren in Azure API Management, rechtstreeks of na het converteren naar een OpenAPI-specificatie
• Voltooi API-configuratie
• De API testen in de Azure-portal

Vereiste voorwaarden

• Maak een API Management-exemplaar.

• Een SAP-systeem en -service die beschikbaar worden gesteld als OData v2 of v4.

• Als uw SAP-back-end gebruikmaakt van een zelfondertekend certificaat (voor testen), moet u mogelijk de verificatie van de vertrouwensketen voor SSL uitschakelen. Om dit te doen, configureer een backend in uw API Management-instantie.

  1. Selecteer in de Azure portal, onder API's, Backends>+ Nieuwe back-end maken.
  2. Voeg een aangepaste URL toe die verwijst naar de SAP-back-endservice.
  3. Vouw de sectie Geavanceerd uit en schakel de selectievakjes Certificaatketen valideren en Certificaatnaam valideren uit.

  Opmerking

  Gebruik in productiescenario's de juiste certificaten voor end-to-end SSL-verificatie.

  Aanbeveling

  Voor het volledige functiebereik van API Management converteert u de SAP OData-API naar openAPI-specificatie voordat u zich registreert.

Haal OData-metadata op van uw SAP-service

Gebruik een van de volgende methoden om XML-metagegevens op te halen uit uw SAP-service. Als u van plan bent de metadata XML naar een OpenAPI-specificatie om te zetten, sla het bestand dan lokaal op.

• Gebruik de SAP Gateway-client (transactie /IWFND/GW_CLIENT).
• Maak een directe HTTP-aanroep om de XML op te halen: http://<OData server URL>:<port>/<path>/$metadata.
• Gebruik indien van toepassing de SAP Business Accelerator Hub .

Ga naar je API Management-instantie

1. Zoek en selecteer API Management-services in Azure Portal:

   

2. Selecteer op de pagina API Management-services uw API Management-exemplaar:

   

Een API importeren in API Management

Kies een van de volgende methoden om uw API te importeren in API Management:

• Converteer het XML-bestand met metagegevens naar een OpenAPI-specificatie (aanbevolen).
• Importeer het XML-bestand met metagegevens rechtstreeks als een OData-API.

OpenAPI-specificatie (aanbevolen)

OData-metagegevens converteren naar OpenAPI JSON

1. Gebruik de Microsoft converter gebouwd bovenop de open-source tool OASIS.

   In het volgende voorbeeld wordt OData v2 XML geconverteerd voor de testservice epm_ref_apps_prod_man_srv:

   oasis-converter convert epm_ref_apps_prod_man_srv.xml api.json
   

   Opmerking

   Voor het testen met één XML-bestand kunt u de webervaring gebruiken.

2. Sla het openapi-spec.json bestand lokaal op voor import naar API Management.

OpenAPI-specificatie importeren

1. Selecteer API's in het zijbalkmenu in de sectie API's.

2. Selecteer onder Maken op basis van definitie de Tegel OpenAPI :

   

3. Kies Een bestand selecteren en selecteer vervolgens het openapi-spec.json bestand dat u lokaal in een vorige stap hebt opgeslagen.

4. Voer de API-instellingen in. U kunt deze waarden instellen wanneer u de API importeert of deze later configureert door naar het tabblad Instellingen te gaan.

   • Voor het ACHTERvoegsel van de API-URL raden we u aan hetzelfde URL-pad te gebruiken als dat van de oorspronkelijke SAP-service.

   • Voor meer informatie over API-instellingen, zie de Importeer en publiceer uw eerste API-tutorial.

5. Klik op Creëren.

U moet ook verificatie voor uw back-end configureren met behulp van een geschikte methode voor uw omgeving. Zie Verificatie en autorisatie voor voorbeelden.

Opmerking

Zie API-importbeperkingen en bekende problemen voor informatie over api-importbeperkingen.

Uw API testen

1. Navigeer naar uw API Management-exemplaar.

2. Selecteer API's in> het zijbalkmenu.

3. Selecteer uw geïmporteerde API onder Alle API's.

4. Selecteer het tabblad Testen om toegang te krijgen tot de testconsole.

5. Selecteer een bewerking, voer de vereiste waarden in en selecteer vervolgens Verzenden.

   Test bijvoorbeeld de aanroep om de GET /$metadata verbinding met de SAP-back-end te controleren.

6. Bekijk het antwoord. Als u problemen wilt oplossen, moet u de aanroep traceren .

7. Wanneer u klaar bent met testen, sluit u de testconsole af.

OData-metagegevens

OData-metagegevens importeren

1. Selecteer API's in> het zijbalkmenu en selecteer vervolgens + API toevoegen.

2. Selecteer onder Maken op basis van definitie de tegel OData :

   

3. Voer de API-instellingen in. U kunt uw instellingen later bijwerken door naar het tabblad Instellingen van de API te gaan.

   1. Voer in OData-specificatie een URL in voor een OData-metagegevenseindpunt. Deze waarde is meestal de URL van de hoofdmap van de service, aangevuld met /$metadata. Als alternatief kunt u een lokaal OData XML-bestand selecteren om te importeren.

   2. Voer aanvullende instellingen in om uw API te configureren. Deze instellingen worden uitgelegd in de Importeer en publiceer je eerste API tutorial.

4. Klik op Creëren.

   De API wordt toegevoegd aan de lijst met API's. De entiteitsets en functies die worden weergegeven in de beschrijving van de OData-metagegevens, worden weergegeven op het tabblad Entiteitensets en functies van de API.

   

Werk het OData-schema bij

U kunt toegang krijgen tot een editor in het portaal om het OData-schema van uw API te bekijken. Als de API verandert, kunt u ook het schema bijwerken in API Management vanuit een bestand of een OData-service eindpunt.

1. Selecteer in het zijbalkmenu API's> en selecteer vervolgens uw OData-API.

2. Selecteer op het tabblad Entiteitsets en functies het beletselteken (...) naast een entiteitsset of functie en selecteer vervolgens Bewerken.

   

3. Bekijk het schema. Als u het wilt bijwerken, selecteer dan Bijwerken vanuit bestand of Schema bijwerken vanaf eindpunt.

   

Test uw OData API

1. Selecteer in het zijbalkmenu API's> en selecteer vervolgens uw OData-API.

2. Selecteer op het tabblad Entiteitsets en functies het beletselteken (...) naast een entiteitsset of functie en selecteer vervolgens Testen.

   

3. Voer in de testconsole sjabloonparameters, queryparameters en headers voor uw test in en selecteer vervolgens Testen. Zie De nieuwe API testen in de portal voor meer informatie over het testen van API's in de portal.

Beveilig uw OData API

Beveilig uw OData-API door bestaand verificatie- en autorisatiebeleid en een OData-validatiebeleid toe te passen om te beschermen tegen aanvallen via OData-API-aanvragen.

Aanbeveling

Stel in het portaal beleidsregels in voor uw OData-API op het tabblad API-beleidsregels.

Overwegingen voor productie

• Gebruik Defender voor API's voor volledige levenscyclusbeveiliging, detectie en responsdekking voor API's.
• Bekijk een voorbeeld van een end-to-end scenario voor het integreren van API Management met een SAP-gateway.
• Toegang tot een SAP-back-end beheren met behulp van API Management-beleid. Gebruik bijvoorbeeld de valideer OData-verzoek beleidslijn als de API als een OData API is geïmporteerd. Er zijn ook beleidsfragmenten voor het doorgeven van SAP-principals voor SAP ECC of S/4HANA of SAP SuccessFactors en het ophalen van een X-CSRF-token.
• Zie voor hulp bij het implementeren, beheren en migreren van API's op schaal:
  • geautomatiseerde API-implementaties met APIOps-
  • DevOps en CI/CD gebruiken om API's te publiceren

Verwante inhoud

• Beperkingen bij het importeren van API's
• Een OpenAPI-specificatie importeren
• Een SOAP-API importeren
• Een SOAP-API importeren en deze naar REST converteren
• Een App Service-API importeren
• Een API voor een container-app importeren
• Een WebSocket-API importeren
• Een GraphQL-API importeren
• Importeer een GraphQL-schema en stel veldresolvers in
• Een api voor een functie-app importeren
• Een API voor een logische app importeren
• Een Service Fabric-service importeren
• Een Microsoft Foundry-API importeren
• Importeer een Azure OpenAI-API
• Een LLM-API importeren
• Een OData-API importeren
• Een REST API exporteren als een MCP-server
• Een bestaande MCP-server beschikbaar maken
• Een A2A-agent-API importeren
• SAP OData-metagegevens importeren
• Een gRPC-API importeren
• Een API bewerken