SOAP-API importeren in API Management

VAN TOEPASSING OP: Alle API Management-lagen

In dit artikel wordt beschreven hoe u een WSDL-specificatie importeert. Dit is een standaard-XML-weergave van een SOAP-API. In het artikel wordt ook beschreven hoe u de API kunt testen in API Management.

In dit artikel leert u het volgende:

• Een SOAP-API importeren
• De API testen in Azure Portal

Notitie

WSDL-import naar API Management is onderhevig aan bepaalde beperkingen. WSDL-bestanden met wsdl:import, xsd:importen xsd:include richtlijnen worden niet ondersteund. Voor een opensource-hulpprogramma om deze afhankelijkheden in een WSDL-bestand op te lossen en samen te voegen, raadpleegt u deze GitHub-opslagplaats.

Vereisten

• Een API Management-exemplaar. Als u nog geen exemplaar hebt, voltooit u de volgende quickstart: Een Azure API Management-exemplaar maken.

• Azure-CLI

  • Gebruik de Bash-omgeving in Azure Cloud Shell. Zie quickstart voor Bash in Azure Cloud Shell voor meer informatie.

    

  • Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.

    • Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht az login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij Azure CLI voor aanvullende aanmeldingsopties.

    • Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.

    • Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.

• Azure PowerShell

  • Als u ervoor kiest om Azure PowerShell lokaal te gebruiken:
    • Installeer de nieuwste versie van de Az PowerShell-module.
    • Maak verbinding met uw Azure-account met de cmdlet Connect-AzAccount.
  • Als u ervoor kiest om Azure Cloud Shell te gebruiken:
    • Raadpleeg Overzicht van Azure Cloud Shell voor meer informatie.

Een back-end-API importeren

Portal

1. Blader in Azure Portal naar uw API Management-exemplaar.

2. Selecteer API's+ API's> toevoegen in het linkermenu.

3. Selecteer WSDL onder Maken op basis van definitie.

   

4. Voer in de WSDL-specificatie de URL naar uw SOAP-API in of klik op Een bestand selecteren om een lokaal WSDL-bestand te selecteren.

5. In de importmethode is SOAP-passthrough standaard geselecteerd. Met deze selectie wordt de API weergegeven als SOAP en moeten API-gebruikers SOAP-regels gebruiken. Als u van de API een REST API wilt maken, volg dan de stappen in Import a SOAP API and convert it to REST (Een SOAP API importeren en converteren naar REST).

   

6. De volgende API-instellingen worden automatisch ingevuld op basis van informatie uit de SOAP-API: Weergavenaam, Naam, Beschrijving. Bewerkingen worden automatisch gevuld met weergavenaam, URL en beschrijving en ontvangen een door het systeem gegenereerde naam.

7. Voer andere API-instellingen in. U kunt de waarden instellen tijdens het maken of later configureren door naar het tabblad Instellingen te gaan.

   Zie de eerste API-zelfstudie importeren en publiceren voor meer informatie over API-instellingen.

8. Selecteer Maken.

Azure-CLI

In het volgende voorbeeld wordt de opdracht az apim api import gebruikt om een WSDL-specificatie te importeren van de opgegeven URL naar een API Management-exemplaar met de naam apim-hello-world. Als u wilt importeren met behulp van een pad naar een specificatie in plaats van een URL, gebruikt u de --specification-path parameter.

Voor dit voorbeeld is WSDL de servicenaam OrdersAPI en is een van de beschikbare eindpunten (interfaces) basis.

# API Management service-specific details
APIMServiceName="apim-hello-world"
ResourceGroupName="myResourceGroup"

# API-specific details
APIId="order-api"
APIPath="order"
SpecificationFormat="Wsdl"
SpecificationURL="https://fazioapisoap.azurewebsites.net/FazioService.svc?singleWsdl"
WsdlServiceName="OrdersAPI"
WsdlEndpointName="basic"

# Import API
az apim api import --path $APIPath --resource-group $ResourceGroupName \
    --service-name $APIMServiceName --api-id $APIId \
    --specification-format $SpecificationFormat --specification-url $SpecificationURL \
    --wsdl-service-name $WsdlServiceName --wsdl-endpoint-name $WsdlEndpointName

Powershell

In het volgende voorbeeld wordt de Cmdlet Import-AzApiManagementApi Azure PowerShell gebruikt om een WSDL-specificatie te importeren van de opgegeven URL naar een API Management-exemplaar met de naam apim-hello-world. Als u wilt importeren met behulp van een pad naar een specificatie in plaats van een URL, gebruikt u de -SpecificationPath parameter.

Voor dit voorbeeld is WSDL de servicenaam OrdersAPI en is een van de beschikbare eindpunten (interfaces) basis.

# API Management service-specific details
$apimServiceName = "apim-hello-world"
$resourceGroupName = "myResourceGroup"

# API-specific det
$apiId = "orders-api"
$apiPath = "orders"
$specificationFormat = "Wsdl"
$specificationUrl = "https://fazioapisoap.azurewebsites.net/FazioService.svc?singleWsdl"
$wsdlServiceName = "OrdersAPI"
$wsdlEndpointName = "basic"

# Get context of the API Management instance. 
$context = New-AzApiManagementContext -ResourceGroupName $resourceGroupName -ServiceName $apimServiceName

# Import API
Import-AzApiManagementApi -Context $context -ApiId $apiId -SpecificationFormat $specificationFormat -SpecificationUrl $specificationUrl -Path $apiPath -WsdlServiceName $wsdlServiceName -WsdlEndpointName $wsdlEndpointName

De nieuwe API testen in de portal

Bewerkingen kunnen rechtstreeks vanuit de portal worden aangeroepen, zodat beheerders de bewerkingen van een API kunnen bekijken en testen.

1. Selecteer de API die u in de vorige stap hebt gemaakt.

2. Selecteer het tabblad Testen.

3. Selecteer een bewerking. De pagina geeft velden weer voor queryparameters en velden voor de headers.

   Notitie

   In de testconsole vult API Management automatisch een Ocp-Apim-Subscription-Key-header in en configureert de abonnementssleutel van het ingebouwde abonnement voor alle toegang. Met deze sleutel hebt u toegang tot elke API in het API Management-exemplaar. U kunt desgewenst de header Ocp-Apim-Subscription-Key weergeven door het pictogram 'oog' naast de HTTP-aanvraag te selecteren.

4. Voer, afhankelijk van de bewerking, queryparameterwaarden, headerwaarden of aanvraagbody in. Selecteer Verzenden.

   Wanneer de test is geslaagd, reageert de back-end met een geslaagde HTTP-antwoordcode en enkele gegevens.

   Tip

   De testconsole verzendt standaard een aanvraag naar de CORS-proxy van API Management, die de aanvraag doorstuurt naar het API Management-exemplaar, dat deze vervolgens doorstuurt naar de back-end. Deze proxy gebruikt openbaar IP-adres 13.91.254.72 en kan alleen openbare eindpunten bereiken. Als u een aanvraag rechtstreeks vanuit de browser naar de API Management-service wilt verzenden, selecteert u CORS-proxy overslaan. Gebruik deze optie als u de testconsole wilt gebruiken en uw API Management-gateway netwerkisoleert of geen verkeer van de CORS-proxy toestaat.

Als u fouten in een API wilt opsporen, raadpleegt u zelfstudie: Fouten opsporen in uw API's met behulp van aanvraagtracering.

SOAP-actie jokerteken

Als u een SOAP-aanvraag moet doorgeven waarvoor geen toegewezen actie is gedefinieerd in de API, kunt u een SOAP-actie met jokertekens configureren. De jokertekenactie komt overeen met een SOAP-aanvraag die niet is gedefinieerd in de API.

Een SOAP-actie met jokertekens definiëren:

1. Selecteer in de portal de API die u in de vorige stap hebt gemaakt.
2. Selecteer op het tabblad Ontwerpen de optie + Bewerking toevoegen.
3. Voer een weergavenaam in voor de bewerking.
4. Selecteer POST en voer /?soapAction={any} de resource in de URL in. De sjabloonparameter binnen de accolades is willekeurig en heeft geen invloed op de uitvoering.

Notitie

Gebruik de OpenAPI-specificatie-editor niet op het tabblad Ontwerpen om een SOAP-API te wijzigen.

Andere API's toevoegen

U kunt een API opstellen van API's die beschikbaar worden gesteld door verschillende services, waaronder:

• Een OpenAPI-specificatie
• Een SOAP-API
• Een GraphQL-API
• Een web-app die wordt gehost in Azure-app Service
• Azure Function-app
• Azure Logic-apps
• Azure Service Fabric

Voeg een andere API toe aan uw bestaande API met behulp van de volgende stappen.

Notitie

Wanneer u een andere API importeert, worden de bewerkingen toegevoegd aan uw huidige API.

1. Ga naar uw Azure API Management-exemplaar in de Azure-portal.

   

2. Selecteer API's op de pagina Overzicht of in het menu aan de linkerkant.

   

3. Selecteer het beletselsteken (... ) naast de API waaraan u een andere API wilt toevoegen.

4. Selecteer Importeren in de vervolgkeuzelijst.

   

5. Selecteer de service waaruit een API moet worden geïmporteerd.

   

Verwante onderwerpen

• Beperkingen bij het importeren van API's
• Een OpenAPI-specificatie importeren
• Een SOAP-API importeren
• Een SOAP-API importeren en deze converteren naar REST
• Een App Service-API importeren
• Een Container App-API importeren
• Een WebSocket-API importeren
• Een GraphQL-API importeren
• Een GraphQL-schema importeren en veldoplossers instellen
• Een Azure-functie-app importeren
• Een logische Azure-app importeren
• Een Service Fabric-service importeren
• Een Azure OpenAI-API importeren
• Een OData-API importeren
• SAP OData-metagegevens importeren
• Een gRPC-API importeren
• Een API bewerken

Volgende stappen

Een gepubliceerde API transformeren en beveiligen