SOAP 서비스 프록시

<ph type="x-smartling-placeholder"></ph> 현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서. 정보

학습할 내용

이 가이드에서는 다음 방법을 배웁니다.

  • WSDL 파일에서 Edge API 프록시를 생성합니다.
  • RESTful SOAP 프록시 유형과 패스스루 SOAP의 차이점 이해 사용할 수 있습니다

이 튜토리얼에서는 SOAP 기반 웹 앞에 Edge API 프록시를 배치하는 방법을 알아봅니다. 있습니다.

이 가이드는 SOAP 기반 데이터베이스 앞에서 새로운 RESTful API를 생성하는 방법을 있습니다. 여기서는 자세히 설명하지 않지만 패스 스루 프록시를 생성할 수도 있습니다. 백엔드 서비스로 전달하는 역할을 합니다.

필요한 항목

프록시 만들기

여기에서 Edge가 SOAP 서비스 앞에 배치될 프록시를 생성하도록 합니다. SOAP API 프록시에는 다음과 같은 두 가지 유형이 있습니다.

  • REST-SOAP-REST 프록시 유형은 변환이 포함된 새 RESTful API를 생성합니다. SOAP에 적용하는 것입니다 클라이언트는 다른 RESTful 서비스와 마찬가지로 이를 호출하여 매개변수입니다. Edge는 이를 SOAP 페이로드로 변환합니다. 나타냅니다
  • 패스 스루 프록시 프록시 유형을 사용하면 클라이언트가 SOAP 페이로드를 간단히 전달할 수 있습니다. 이렇게 하면 SOAP 서비스 호출이 에지 관리 기능의 이점을 누릴 수 있습니다.

에지

Edge UI를 사용하여 SOAP 서비스를 프록시하려면 다음 안내를 따르세요.

  1. apigee.com/edge에 로그인합니다.
  2. 왼쪽 탐색 메뉴에서 개발 > API 프록시를 선택합니다.
  3. +프록시를 클릭합니다.
  4. SOAP 서비스를 클릭합니다.
  5. 프록시 세부정보 페이지에서 다음을 입력합니다.

    필드 설명
    WSDL 소스

    URL을 선택합니다.

    다음 WSLD URL을 복사하여 URL 입력 필드에 붙여넣습니다.

    https://ws.cdyne.com/delayedstockquote/delayedstockquote.asmx?wsdl

    확인을 클릭합니다.

    Apigee Edge가 WSDL 파일을 가져온 후 읽고 작업 목록을 탐색합니다. SOAP 서비스를 지원합니다.
    이름

    그대로 유지: delayedstockquote

    만들려는 API 프록시의 이름입니다.
    기본 경로 그대로 유지: /delayedstockquote
    설명 원하는 경우 주가 WSDL API 프록시와 같은 설명을 추가합니다.
  6. 다음을 클릭합니다.
  7. 일반 정책 페이지의 보안: 승인에서 통과 (승인 없음)를 선택합니다.
  8. 다음을 클릭합니다.
  9. WSDL 작업 페이지에서 REST to SOAP to REST(SOAP에서 REST로 REST)를 선택합니다.

    프록시 유형을 선택하면 Edge에 REST API 경로가 생성됩니다 이 목록을 사용하면 WSDL에 있는 작업 중에서 선택합니다 (특정 작업이 있는 경우). 설정합니다. 표에는 REST 클라이언트가 백엔드 SOAP 서비스를 호출하는 데 사용할 수 있습니다.

    페이지의 다른 모든 선택 항목은 그대로 둡니다.

  10. 다음을 클릭합니다.
  11. Next를 클릭하여 가상 호스트 기본값을 수락합니다.
  12. 요약 페이지의 선택적 배포 아래에서 테스트를 클릭하고 만들기 및 배포를 클릭합니다.

    Edge는 RESTful API 프록시를 생성하여 test 환경에 배포합니다. WSDL에서 서비스의 지정할 수 있습니다. Edge에서 사용할 HTTP 메서드 추천 확인할 수 있습니다 일반적으로 Edge는 작업을 GET 요청으로 변환하고 캐시할 수 있다는 장점이 있습니다. 또한 Edge는 백엔드 대상 엔드포인트를 설정하며 SOAP 작업에 따라 다를 수 있습니다.

    이 튜토리얼을 진행하지 않고 새 API 프록시를 맞춤설정하는 경우가 아니라면 있습니다. 새 API 프록시를 테스트하는 단계로 넘어갈 수 있습니다.

를 통해 개인정보처리방침을 정의할 수 있습니다.

Classic Edge (Private Cloud)

기본 Edge UI를 사용하여 SOAP 서비스를 프록시하려면 다음 단계를 따르세요.

  1. http://ms-ip:9000에 로그인합니다. 여기서 ms-ip는 관리 서버 노드의 IP 주소 또는 DNS 이름입니다.
  2. API > API 프록시를 선택합니다.
  3. + API 프록시를 클릭합니다.
  4. SOAP 서비스를 클릭합니다.
  5. 프록시 세부정보 페이지에서 다음을 입력합니다.

    필드 설명
    WSDL

    예시 URL을 선택합니다.

    그런 다음
    를 선택합니다. ...delayedstockquote.asmx?WSDL

    확인을 클릭합니다.

    Apigee Edge가 WSDL 파일을 가져온 후 읽고 작업 목록을 탐색합니다. SOAP 서비스를 지원합니다.
    Proxy Name

    delayedstockquote 입력

    만들려는 프록시의 이름입니다.
    프록시 기본 경로 및 설명 그대로 둡니다.
  6. 다음을 클릭합니다.
  7. WSDL 페이지에서 다음을 선택합니다.
    필드 작업
    API 프록시 유형

    REST에서 SOAP to REST를 선택합니다.

    프록시 유형을 선택하면 Edge에 아래와 같이 REST API 경로가 생성됩니다. 이 목록을 통해 WSDL에 있는 작업 중에서 선택합니다 (특정 작업이 있는 경우). 설정합니다. 표에는 REST 클라이언트가 백엔드 SOAP 서비스를 호출하는 데 사용할 수 있습니다.

    지금은 첫 번째 작업 세트를 선택된 상태로 둡니다.
    포트 유형: DelayedStockQuoteSoap 세 개의 WSDL 작업을 모두 선택합니다. 다른 설정은 그대로 둡니다.

  8. 다음을 클릭합니다.
  9. 보안 페이지에서 통과 (없음)을 선택합니다.
  10. 다음을 클릭합니다.
  11. 가상 호스트 기본값을 그대로 두고 Next를 클릭합니다.
  12. 빌드 페이지에서 기본값을 수락하고 Build and Deploy(빌드 및 배포)를 클릭하여 다음을 수행합니다. Edge가 프록시를 생성하기 시작하도록 합니다.

    Edge는 RESTful API 프록시를 생성합니다. WSDL에서 서비스의 지정할 수 있습니다. Edge에서 사용할 HTTP 메서드 추천 확인할 수 있습니다 일반적으로 Edge는 작업을 GET 요청으로 변환하고 캐시할 수 있다는 장점이 있습니다. 또한 Edge는 백엔드 대상 엔드포인트를 설정하며 SOAP 작업에 따라 다를 수 있습니다.

    이 튜토리얼을 진행하지 않고 새 프록시를 맞춤설정하는 경우가 아니라면 있습니다. 새 프록시를 테스트하는 단계로 넘어갈 수 있습니다.

를 통해 개인정보처리방침을 정의할 수 있습니다.

프록시 테스트

만든 프록시를 사용해 보려면 명령 프롬프트를 열고 cURL을 사용하세요. 명령어 입력 각 항목의 의미는 다음과 같습니다.

  • ORG는 프록시를 만든 Edge 조직의 이름입니다.
  • ENV는 프록시가 배포된 환경입니다.
  • 도메인(DOMAIN)은 사용 중인 Edge 인스턴스에 해당합니다.
curl "https://{ORG}-{ENV}.{DOMAIN}/delayedstockquote/quote?StockSymbol=GOOG&LicenseKey=0"

예를 들어 조직이 docfood인 경우 환경은 다음과 같습니다. test를 실행하며 Edge 엔터프라이즈 클라우드를 사용하는 경우 다음과 같은 명령어를 실행합니다. 다음과 같습니다.

curl "https://docfood-test.apigee.net/delayedstockquote/quote?StockSymbol=GOOG&LicenseKey=0"
드림

StockSymbol 쿼리 매개변수에 GOOG을 입력하면 다음과 같이 표시됩니다. Alphabet Inc. 클래스 C 주식의 현재 가격입니다. 예를 들면 다음과 같습니다.

{  
   "GetQuoteResponse":{  
      "GetQuoteResult":{  
         "StockSymbol":"GOOG",
         "LastTradeAmount":819.55,
         "LastTradeDateTime":"2017-02-13T14:33:00",
         "StockChange":5.88,
         "OpenAmount":816.0,
         "DayHigh":820.96,
         "DayLow":815.49,
         "StockVolume":785064,
         "PrevCls":813.67,
         "ChangePercent":"+0.72%",
         "FiftyTwoWeekRange":"663.28 - 841.95",
         "EarnPerShare":27.88,
         "PE":29.4,
         "CompanyName":"Alphabet Inc.",
         "QuoteError":false
      }
   }
}

자동 생성된 OpenAPI 가져오기 사양

“REST에서 SOAP로, REST에서 REST로”를 사용하여 SOAP 서비스를 프록시하면 Edge는 자동으로 OpenAPI 사양. 이 API용 API 문서를 생성하기 위한 OpenAPI 사양입니다.

OpenAPI 사양을 가져오려면 다음 URL을 방문하세요.

curl https://{ORG}-{ENV}.{DOMAIN}/delayedstockquote/openapi.json

추가 크레딧: 방법 사용해야 할 리소스, 동사, 쿼리 매개변수를 알 수 있나요?

테스트 API 호출에서는 cURL 호출에 특정 리소스와 쿼리 매개변수를 사용했습니다. 백엔드 SOAP 서비스로 전달됩니다 하지만 어떻게 직접 알아낼 수 있을까요?

리소스 및 동사

프록시를 생성할 때 API 프록시 마법사에서 SOAP 작업이 어떻게 API 동사와 리소스에 매핑됩니다 하지만 적어 두지 않았다면 다음과 같은 방법으로 확인할 수 있습니다.

API 프록시의 개발 탭에 있는 탐색기 창에 프록시 엔드포인트의 흐름 목록입니다. 원하는 흐름을 클릭합니다. 예를 들어 GetQuote 흐름을 따르는 것이 좋습니다. 그런 다음 Code 창에서 XML을 봅니다. <Condition> 요소의 다음 속성을 사용합니다. /quote 및 GET

쿼리 매개변수

GetQuote 흐름을 선택한 상태에서 그래픽 패널에서 첫 번째 정책을 클릭합니다. 흐름 뷰입니다. 올바른 쿼리 매개변수를 캡처하는 변수 추출 정책이어야 합니다. StockSymbol 및 LicenseKey가 전달될 것으로 예상됩니다. (웹에서 SOAP 서비스를 검색하면 LicenseKey에 대해 무엇을 전달해야 하는지 알려줍니다.)

캡처된 쿼리 매개변수는 변수로 저장되고 다음 정책에서 SOAP 메시지를 구성해야 합니다.