4단계: 대상 엔드포인트 변경

이 페이지는 ApigeeApigee Hybrid에 적용됩니다.

Apigee Edge 문서 보기

이제 새 프록시를 테스트했으므로 프록시에 정책을 추가할 준비가 거의 다 되었습니다. 하지만 그 전에 프록시의 대상 엔드포인트를 일부 데이터를 반환하는 엔드포인트로 변경하세요.

1단계: API 프록시 만들기에서 대상 엔드포인트(기존 API 필드에 있음)를 https://mocktarget.apigee.net로 설정했음을 확인합니다. 엔드포인트가 관심 있는 데이터를 반환하지 않았다고 가정해 보겠습니다. 그러면 엔드포인트를 유용한 XML을 반환하는 엔드포인트로 변경할 수 있습니다. 이 섹션은 이를 수행하는 방법을 설명합니다.

새 프록시 편집기

프록시 편집기의 개발 보기에서 프록시의 대상 엔드포인트를 변경할 수 있습니다. 개발 보기를 열려면 다음 안내를 따르세요.

  1. 개발 > API 프록시를 선택하고 프록시 창에서 프록시 환경을 선택합니다.

  2. 프록시 목록에서 1단계: API 프록시 만들기에서 만든 프록시 myproxy를 선택합니다.
  3. 개발 탭을 클릭하여 개발 뷰를 표시합니다.

    프록시 편집기의 개발 보기

개발 뷰

개발 뷰의 왼쪽 창에서 다음을 수행할 수 있습니다.

  • 프록시 검색 필드의 프록시에서 텍스트를 검색합니다.
  • 새 정책을 추가합니다.
  • 프록시 및 대상 엔드포인트를 추가합니다.
  • 다른 리소스를 추가합니다.

왼쪽 창을 표시하지 않으려면 닫기 버튼 검색 창 닫기 버튼을 클릭하여 접을 수 있습니다.

개발 뷰의 오른쪽 창에는 프록시에 대한 비주얼 및 텍스트 편집기가 표시됩니다.

  • 비주얼 편집기에서는 요청 및 응답 흐름의 그래픽 뷰를 제공합니다.
  • 텍스트 편집기를 사용하여 프록시 또는 대상의 XML을 수정할 수 있습니다.

선택 가능한 구분선이 있는 비주얼 및 텍스트 편집기

참고:

  • 두 편집기의 구분선을 클릭하고 드래그하여 위 또는 아래로 편집기의 표시 영역을 확장할 수 있습니다.
  • 텍스트 편집기의 오른쪽에 있는 전환 버튼을 클릭하여 텍스트 편집기 창을 닫고 시각적 편집기의 표시 영역을 확장할 수 있습니다. 전환 버튼을 다시 클릭하여 텍스트 편집기 창을 다시 엽니다.

대상 엔드포인트 변경

프록시의 대상 엔드포인트를 변경하려면 다음 안내를 따르세요.

  1. 프록시 버전 창에서 대상 엔드포인트 > 기본값을 선택합니다.

    프록시 탐색기에서 선택된 대상 엔드포인트

    그러면 비주얼 편집기에 대상 엔드포인트의 다이어그램이 표시됩니다.

    프록시 탐색기에서 선택된 대상 엔드포인트

    비주얼 편집기 아래의 텍스트 편집기에 대상 엔드포인트의 XML 코드가 표시됩니다.

    텍스트 편집기에 표시되는 대상 엔드포인트의 XML

  2. 텍스트 편집기에서 <URL>https://mocktarget.apigee.net/xml로 변경합니다. 기존 URL에 '/xml'을 추가합니다.

    새 URL이 아래에 표시됩니다.

    ...
    <HTTPTargetConnection>
      <Properties/>
      <URL>https://mocktarget.apigee.net/xml</URL>
    </HTTPTargetConnection>
    ...
  3. 프록시 편집기 오른쪽 상단의 저장 옆에 있는 화살표를 클릭하고 새 버전으로 저장을 선택합니다.
  4. 변경사항을 배포하려면 배포를 클릭합니다.
  5. 배포 대화상자에서 배포할 버전 및 환경을 선택하고 배포를 클릭합니다.

기본 프록시 편집기

프록시의 대상 엔드포인트를 변경하려면 다음 안내를 따르세요.

  1. Apigee UI에 로그인합니다.
  2. 개발 > API 프록시를 선택합니다.
  3. 목록에서 프록시를 선택하여 API 프록시 세부정보를 표시합니다. 목록에 프록시가 표시되지 않으면 조직 간 전환에 설명된 대로 올바른 조직을 선택했는지 확인하세요.
  4. 개발 탭을 클릭합니다.

    개발 탭

    그러면 API 프록시 편집기로 이동합니다. 프록시 편집기에서는 API 프록시 구조를 보고 흐름을 구성할 수 있습니다. 흐름은 API 프록시 요청이 Apigee 플랫폼을 통해 거치는 단계별 경로입니다. 다른 튜토리얼에서는 흐름 개념을 다룹니다.

  5. 탐색기 창에서 대상 엔드포인트 > 기본값 > PreFlow를 선택합니다.

    Apigee는 코드 창에 엔드포인트 설정을 표시합니다.

    <TargetEndpoint name="default">
      <Description/>
      <FaultRules/>
      <PreFlow name="PreFlow">
        <Request/>
        <Response/>
      </PreFlow>
      <PostFlow name="PostFlow">
        <Request/>
        <Response/>
      </PostFlow>
      <Flows/>
      <HTTPTargetConnection>
        <Properties/>
        <URL>https://mocktarget.apigee.net</URL>
      </HTTPTargetConnection>
    </TargetEndpoint>

    대상 엔드포인트는 <HTTPTargetConnection> 요소에 의해 정의됩니다.

  6. URL을 "https://mocktarget.apigee.net/xml"로 변경합니다. 기존 URL에 '/xml'을 추가합니다.

    새 URL이 응답 본문에 XML의 작은 블록을 반환합니다.

    이제 엔드포인트 구성이 다음과 같이 표시됩니다.

    ...
    <HTTPTargetConnection>
      <Properties/>
      <URL>https://mocktarget.apigee.net/xml</URL>
    </HTTPTargetConnection>
    ...
  7. 프록시 구성에 대한 변경사항을 저장하려면 저장 버튼을 클릭합니다.

    Apigee는 변경사항을 새 프록시 버전에 저장합니다.

  8. 새 버전을 배포하려면 배포 대상: 테스트를 선택하고 배포 2를 클릭합니다.
  9. 확인 대화상자에서 배포를 클릭합니다.

    오류가 발생한 경우 Apigee는 변경사항을 저장하지만 프록시는 배포하지 않습니다. 오류가 발생하면 다음 안내를 따르세요.

    1. 프록시 구성을 수정합니다. Apigee는 팝업으로 구문 안내를 제공할 수 있습니다.
    2. Apigee가 자동으로 배포하지 않는 경우 배포 > 테스트를 클릭하여 test 환경에 변경사항을 수동으로 배포합니다.

    배포 드롭다운 옆에 있는 배포 버전 상태를 확인하여 프록시 버전이 성공적으로 배포되었는지 확인할 수 있습니다. 예를 들면 다음과 같습니다.

프록시 테스트

API 프록시 호출에서와 같이 프록시에 요청을 전송하여 변경사항을 테스트할 수 있습니다. 다음 예시에서는 프록시 이름이 myproxy라고 가정합니다.

curl https://YOUR_ENV_GROUP_HOSTNAME/myproxy

여기서 YOUR ENV_GROUP_HOSTNAME은 환경 그룹 호스트 이름입니다. 환경 그룹 호스트 이름 찾기를 참조하세요.

이번에는 mocktarget 엔드포인트가 응답의 본문에 XML을 반환합니다.

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <city>San Jose</city>
  <firstName>John</firstName>
  <lastName>Doe</lastName>
  <state>CA</state>
</root>

이제 API 프록시가 XML 데이터를 반환하였으므로 다음 단계에서는 XML을 JSON으로 변환하는 정책을 추가합니다.

1 2 3 4 (다음) 5단계: 정책 추가