Apigee Edge 문서입니다.
Apigee X 문서로 이동 정보
확장 프로그램을 사용하여 외부 리소스를 API 프록시에 통합할 수 있습니다. 예를 들어 Google Cloud Storage와 같은 Google Cloud Platform 서비스를 통합할 수 있습니다. 런타임 시 API 프록시는 확장 프로그램을 사용하여 외부 리소스와 요청 및 응답을 교환합니다.
확장 프로그램 런타임 프레임워크
런타임 시 확장 프로그램은 API 프록시와 외부 리소스 간의 요청과 응답을 처리하는 중간 역할을 합니다.
다음은 런타임에 확장 프로그램을 통한 처리가 작동하는 방식에 관한 개요입니다.
- 클라이언트 요청이 API 프록시에 도달하고 요청 흐름이 프록시의 정책을 통해 진행됩니다.
- 요청 흐름은 환경에 배포된 확장 프로그램에 데이터를 전달하도록 구성된 프록시의 확장 프로그램 호출 정책에 도달합니다. 이 데이터에는 확장 프로그램이 나타내는 외부 리소스에 요청을 전송하는 데 필요한 값이 포함됩니다.
- 확장 프로그램이 외부 리소스에 요청을 전송한 후 응답을 수신합니다.
- 확장 프로그램은 응답을 확장 프로그램 콜아웃 정책으로 다시 전달하고 여기서 프록시 코드로 처리됩니다.
- 요청 흐름은 프록시가 클라이언트에 응답을 반환할 때까지 프록시를 통해 계속됩니다.
확장 프로그램 작업
각 확장 프로그램은 특정 외부 리소스를 염두에 두고 개발 및 구성됩니다. 확장 프로그램을 사용하려면 Apigee Edge 관리자와 API 프록시 개발자가 다음과 같은 대략적인 단계를 따릅니다.
- Apigee Edge 조직 관리자가 확장 프로그램을 구성하고 배포합니다. 비즈니스 요구사항에 맞는 값으로 구성합니다. 이 구성은 API 프록시 개발자가 사용할 수 있도록 설계된 확장 프로그램 인스턴스를 만듭니다. 예를 들어 필요한 인증 사용자 인증 정보를 포함하여 Google Cloud Storage의 특정 버킷에 액세스하도록 확장 프로그램을 구성할 수 있습니다.
- API 프록시 개발자는 프록시에 Extension Callout 정책을 추가하여 API 프록시에서 구성된 확장 프로그램을 사용합니다. 정책 구성은 다음을 지정합니다.
- 사용할 구성된 확장 프로그램입니다.
- 호출할 확장 프로그램 작업 (확장 프로그램의 함수 호출이라고 생각)
- 작업 호출과 함께 전달할 작업 매개변수입니다. 런타임 시 정책은 확장 프로그램을 사용하여 프록시 흐름의 일부로 외부 리소스에 액세스합니다.
확장 프로그램에 관한 문서
다음 주제에서는 확장 프로그램에 관해 자세히 설명합니다.
- 확장 프로그램에 관한 실습 소개는 튜토리얼: 확장 프로그램 추가 및 사용을 참고하세요.
- Apigee Edge에 포함된 확장 프로그램에 관한 참조는 확장 프로그램 참조 개요를 참고하세요.
- 확장 프로그램을 추가, 삭제, 배포하는 데 사용할 수 있는 관리 API에 관한 참조는 Extensions API를 참고하세요.