SOAP API를 API Management로 가져오기

적용 대상: 모든 API Management 계층

이 문서에서는 SOAP API의 표준 XML 표시인 WSDL 사양을 가져오는 방법을 보여 줍니다. 이 문서에서는 API Management에서 API를 테스트하는 방법도 보여 줍니다.

이 문서에서는 다음 방법을 설명합니다.

• SOAP API 가져오기
• Azure 포털에서 API 테스트하기

참고

API Management에 대한 WSDL 가져오기에는 특정 제한 사항이 적용됩니다. wsdl:import, xsd:import 및 xsd:include 지시문이 있는 WSDL 파일은 지원되지 않습니다. WSDL 파일에서 이러한 종속성을 확인하고 병합하기 위한 오픈 소스 도구는 이 GitHub 리포지토리를 참조하세요.

사전 준비 사항

• API Management 인스턴스. 아직 없는 경우 Azure API Management 인스턴스 만들기 빠른 시작을 완료합니다.
• Azure 명령줄 인터페이스 (CLI)

  • Azure Cloud Shell에서 Bash 환경을 사용합니다. 자세한 내용은 Azure Cloud Shell 시작을 참조하세요.

    

  • CLI 참조 명령을 로컬에서 실행하려면 Azure CLI를 설치 합니다. Windows 또는 macOS에서 실행 중인 경우 Docker 컨테이너에서 Azure CLI를 실행하는 것이 좋습니다. 자세한 내용은 Docker 컨테이너에서 Azure CLI를 실행하는 방법을 참조하세요.

    • 로컬 설치를 사용하는 경우 az login 명령을 사용하여 Azure CLI에 로그인합니다. 인증 프로세스를 완료하려면 터미널에 표시되는 단계를 수행합니다. 다른 로그인 옵션은 Azure CLI를 사용하여 Azure에 인증을 참조하세요.

    • 메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 확장에 대한 자세한 내용은 Azure CLI로 확장 사용 및 관리를 참조하세요.

    • az version 을 실행하여 설치된 버전과 종속 라이브러리를 찾습니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.

• Azure PowerShell
  • Azure PowerShell을 로컬로 사용하도록 선택하는 경우:
    • 최신 버전의 Az PowerShell 모듈을 설치합니다.
    • Connect-AzAccount cmdlet을 사용하여 Azure 계정에 로그인합니다.
  • Azure Cloud Shell을 사용하도록 선택하는 경우:
    • 자세한 내용은 Azure Cloud Shell 개요를 참조하세요.

백 엔드 API 가져오기

Portal

1. Azure Portal에서 API Management 인스턴스로 이동합니다.

2. APIs>+ API 추가를 왼쪽 메뉴에서 선택합니다.

3. 정의에서 만들기에서 WSDL을 선택합니다.

   

4. WSDL 사양에서 SOAP API에 대한 URL을 입력하거나 파일 선택을 선택하여 로컬 WSDL 파일을 선택합니다.

5. 가져오기 방법에서는 SOAP 통과가 기본적으로 선택됩니다.

   이 항목을 선택하면 API가 SOAP로 노출되고 API 소비자는 SOAP 규칙을 사용해야 합니다. SOAP API를 가져온 후 REST 형태로 변환하는 절차를 수행하면 API를 "restify" 방식으로 전환할 수 있습니다.

   

6. 표시 이름, 이름, 설명 API 설정은 SOAP API의 정보를 기반으로 자동 입력됩니다. 시스템은 자동으로 생성된 이름을 작업에 부여하며, 자동으로 표시 이름, URL, 설명 등의 정보를 입력합니다.

7. 다른 API 설정값을 입력하세요. 만들기 과정에서 바로 API 값을 설정하거나, 이후 설정 탭에서 구성할 수 있습니다.

   API 설정에 관한 자세한 내용은 첫 번째 API 가져오기 및 게시 자습서를 참조하세요.

8. 만들기를 선택합니다.

Azure CLI

다음 예제에서는 az apim api import 명령을 사용하여 지정된 URL에서 apim-hello-world라는 API Management 인스턴스로 WSDL 사양을 가져옵니다. URL 대신 사양 경로를 사용해 가져오려면 --specification-path 매개 변수를 사용합니다.

이 예제 WSDL에서는 서비스 이름이 OrdersAPI이고 사용 가능한 엔드포인트(인터페이스) 중 하나가 기본입니다.

# 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

다음 예제에서는 Import-AzApiManagementApi Azure PowerShell cmdlet을 사용하여 지정된 URL에서 apim-hello-world라는 API Management 인스턴스로 WSDL 사양을 가져옵니다. URL 대신 사양 경로를 사용해 가져오려면 -SpecificationPath 매개 변수를 사용합니다.

이 예제 WSDL에서는 서비스 이름이 OrdersAPI이고 사용 가능한 엔드포인트(인터페이스) 중 하나가 기본입니다.

# 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

포털에서 새 API 테스트

API의 작업을 보고 테스트하는 편리한 방법을 제공하는 Azure Portal에서 직접 작업을 호출할 수 있습니다.

1. 이전 단계에서 생성한 API를 선택합니다.

2. 테스트 탭을 선택합니다.

3. 작업을 선택합니다.

   쿼리 매개 변수와 헤더에 대한 입력 필드가 이 페이지에 표시됩니다.

   참고

   테스트 콘솔에서 API Management는 Ocp-Apim-Subscription-Key 헤더를 자동으로 채우고 기본 제공된 모든 액세스 구독의 구독 키를 구성합니다. 이 키를 사용하면 API Management 인스턴스의 모든 API에 액세스할 수 있습니다. 선택적으로 HTTP 요청 옆에 있는 "눈" 아이콘을 선택하여 Ocp-Apim-Subscription-Key 헤더를 표시합니다.

4. 작업에 따라 쿼리 매개 변수 값, 헤더 값 또는 요청 본문을 입력합니다. 보내기를 선택합니다.

   테스트가 성공할 경우 백엔드는 성공 상태의 HTTP 응답 코드와 및 일부 데이터를 반환합니다.

   팁

   먼저 API Management의 CORS 프록시를 거쳐 테스트 콘솔에서 보낸 요청이 API Management 인스턴스로 전달되고, 최종적으로 백 엔드에 도달하게 됩니다. 이 프록시는 공용 IP 주소 13.91.254.72를 사용하며, 공용 엔드포인트로의 연결만 가능합니다.

   CORS 프록시 무시 옵션을 선택해야 API Management 서비스에 브라우저에서 직접 요청을 보낼 수 있습니다. 테스트 콘솔 사용이 네트워크 격리로 인해 제한되거나 CORS 프록시 트래픽을 API Management 게이트웨이가 차단하는 환경의 경우, 이 옵션을 사용하세요.

API를 디버그하려면 자습서: 요청 추적을 사용하여 API 디버그를 참조하세요.

와일드카드 SOAP 작업

API에 정의된 전용 작업이 없는 SOAP 요청을 전달해야 하는 경우 와일드카드 SOAP 작업을 구성할 수 있습니다. 와일드카드 작업은 API에 정의되지 않은 SOAP 요청과 일치합니다.

와일드카드 SOAP 작업을 정의하려면:

1. Azure Portal에서 이전 단계에서 만든 API를 선택합니다.
2. 디자인 탭에서 + 작업 추가를 선택합니다.
3. 작업의 표시 이름을 입력합니다.
4. URL에서 POST를 선택하고 리소스에 /?soapAction={any}를 입력합니다. 중괄호 내의 템플릿 매개 변수는 임의적이며 실행에 영향을 주지 않습니다.

참고

디자인 탭의 OpenAPI 사양 편집기는 SOAP API 수정에 사용하지 마십시오.

다른 API 추가

다음을 포함하여 다양한 서비스에서 노출되는 API에서 API를 작성할 수 있습니다.

• OpenAPI 사양
• SOAP 기반 API
• GraphQL API
• Azure App Service에서 호스트되는 웹앱
• Azure Functions (애저 펑션)
• Azure 논리 앱
• Azure 서비스 패브릭

참고

API를 가져올 때 작업은 현재 API에 추가됩니다.

기존 API에 API를 추가하려면 다음을 수행합니다.

1. Azure Portal에서 Azure API Management 인스턴스로 이동합니다.

   

2. 개요 페이지에서 API를 선택하거나 왼쪽 메뉴에서 API API>를 선택합니다.

   

3. 다른 API를 추가할 API 옆에 있는 줄임표(...)를 선택합니다.

4. 상황에 맞는 메뉴에서 가져오기 를 선택합니다.

   

5. API를 불러올 서비스를 선택합니다.

관련 콘텐츠

• API 가져오기 제한 사항
• OpenAPI 사양 가져오기
• SOAP API 가져오기
• SOAP API 가져오기 및 REST로 변환
• App Service API 가져오기
• 컨테이너 앱 API 가져오기
• WebSocket API 가져오기
• GraphQL API 가져오기
• GraphQL 스키마 가져오기 및 필드 확인자 설정
• 함수 앱 API 가져오기
• 논리 앱 API 가져오기
• Service Fabric 서비스 가져오기
• Microsoft Foundry API 가져오기
• Azure OpenAI API 가져오기
• LLM API 가져오기
• OData API 가져오기
• REST API를 MCP 서버로 내보내기
• 기존 MCP 서버 노출
• A2A 에이전트 API 가져오기
• SAP OData 메타데이터 가져오기
• gRPC API 가져오기
• API 편집