흐름 후크를 사용하여 공유 흐름 연결

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

공유 흐름에서 상용구 요청 사전 처리 또는 여러 API 집합에 대한 응답 후 처리를 수행하도록 할 수 있습니다. 흐름 후크를 사용하면 특정 환경에 배포된 모든 API 프록시에 대해 동일한 위치에서 실행되도록 공유 흐름을 연결할 수 있습니다. 이렇게 하면 별도로 구현되고 프록시 구현 코드의 일부가 아닌 로직 시퀀스로 배포됩니다.

흐름 후크에 연결된 코드는 API 프록시 핵심 로직의 컨텍스트 외부에 있으므로 일부 동작이 API 프록시와 다릅니다. 다음 사항에 유의하세요.

흐름 후크에 공유 흐름을 연결할 수 있는 권한이 있어야 합니다. 조직 관리자여야 합니다.
각 흐름 후크에는 공유 흐름 하나만 연결할 수 있습니다.
동일한 공유 흐름을 여러 흐름 후크에 연결할 수 있습니다.
흐름 후크에 연결된 공유 흐름으로 인해 결함이 발생하거나 공유 흐름 실행 중에 오류가 발생하면 메시지가 거부되고 호출자에게 결함이 전송됩니다.
흐름 후크 실행 중에 메시지가 거부되면 호출된 프록시 컨텍스트의 세부정보가 분석에 기록됩니다. 또한 공유 흐름에서 맞춤 코드 및 오류 메시지와 함께 결함이 발생할 수 있습니다.

다음 동영상은 Apigee UI에서 공유 흐름을 흐름 후크에 연결한 다음 이를 추적하는 방법을 보여줍니다.

흐름 후크를 통해 프록시에 연결된 공유 흐름은 광범위한 정책 요구사항을 적용하는 로직에 좋은 공간을 제공합니다. 예를 들어 한 팀이 여러 비즈니스 부서(LOB)를 나타내는 여러 팀에 대한 단일 보안 요구사항 집합을 관리하는 경우를 생각해 보겠습니다. 각 LOB팀은 자체 요구사항에 따라 API를 개발할 수 있으며 광범위한 보안 요구사항을 고려할 필요가 없습니다. 보안팀은 공유 흐름에서 이러한 보안 요구사항을 구현한 후 흐름 후크를 사용하여 Apigee 환경에 흐름을 연결할 수 있습니다. 공유 흐름은 프록시 코드의 일부가 아니므로 보안팀은 LOB 코드를 간섭하지 않고 필요에 따라 수정할 수 있습니다.

흐름 후크를 통해 연결된 공유 흐름은 프록시 후크 환경에 배포된 모든 API 프록시의 해당 위치에서 실행됩니다. 따라서 흐름 후크를 사용할 수 있는 기능은 Apigee 조직의 관리자에게만 제공됩니다.

공유 흐름에 대한 자세한 내용은 재사용 가능한 공유 흐름 만들기를 참조하세요.

Apigee UI 또는 Flowhooks API를 사용하여 흐름 후크에 공유 흐름을 연결합니다. 다음 위치에서 각각 최대 1개의 공유 흐름을 흐름 후크에 연결할 수 있습니다.

프록시 엔드포인트가 실행되기 전에 적용해야 하는 로직에 대한 Pre-proxy 흐름 후크.

예를 들어 환경의 모든 API에 보안을 적용하기 위한 로직이 있을 수 있습니다.
대상 엔드포인트가 실행되기 전에 적용해야 하는 로직에 대한 Pre-target 흐름 후크.

예를 들어 요청이 백엔드에 도달하기 전에 로깅을 구현할 수 있습니다. 요청에서 특정 필드를 삭제하여 미디에이션을 적용할 수도 있습니다.
대상 응답이 실행된 후 적용해야 하는 로직에 대한 Post-target 흐름 후크.

이는 응답이 백엔드에서 다시 돌아오는 즉시 적용됩니다. 이것을 사용하여 백엔드 응답을 로깅하거나 백엔드 응답에서 민감한 필드를 삭제하여 일부 미디에이션을 수행할 수 있습니다.
프록시 엔드포인트 이후에, 그리고 클라이언트에 응답을 보내기 직전에 적용해야 하는 로직에 대한 사후 프록시 흐름 후크.

여기에는 CORS에 대한 적용 로직, 응답 로깅 또는 일부 매시업이나 형식 지정이 포함될 수 있습니다.

흐름 후크에 공유 흐름 연결

공유 흐름을 흐름 후크에 연결하려면 공유 흐름이 포함된 조직의 관리자여야 합니다.

Cloud 콘솔의 Apigee

공유 흐름을 흐름 후크에 추가하려면 다음 안내를 따르세요.

브라우저에서 Cloud 콘솔의 Apigee UI를 엽니다.
공유 흐름을 포함하는 조직을 선택합니다. 조직 간 전환을 참조하세요.
공유 흐름은 이 조직의 환경에 배포된 모든 API 프록시 및 공유 흐름에서 사용할 수 있습니다. 이 조직 외부에서는 사용할 수 없습니다.
왼쪽 탐색창에서 관리 > 환경을 클릭합니다.
사용 가능한 환경 목록에서 수정할 환경을 선택합니다.
환경 세부정보 페이지에서 흐름 후크 탭을 클릭합니다.
흐름 후크 뷰가 표시됩니다.

흐름 후크 목록에서 공유 흐름을 연결할 흐름 후크를 식별합니다. 선택한 흐름 후크는 공유 흐름을 실행할 위치에 따라 다릅니다.

흐름 후크 위치	설명
Pre-proxy	프록시 엔드포인트가 실행되기 전에 실행됩니다.
Pre-target	대상 엔드포인트가 실행되기 전에 실행됩니다.
Post-target	대상 응답이 실행된 후에 실행됩니다.
Post-proxy	프록시 엔드포인트 이후와 응답을 클라이언트에 전송하기 직전에 실행됩니다.

선택한 흐름 후크의 목록 상자에서 연결하려는 공유 흐름을 선택합니다.
필요에 따라 공유 흐름을 다른 흐름 후크에 연결합니다.
저장을 클릭하여 선택한 공유 흐름을 흐름 후크에 연결합니다.

기본 Apigee

공유 흐름을 흐름 후크에 추가하려면 다음 안내를 따르세요.

Apigee UI에 로그인합니다.
공유 흐름을 포함하는 조직을 선택합니다. 조직 간 전환을 참조하세요.
공유 흐름은 이 조직의 환경에 배포된 모든 API 프록시 및 공유 흐름에서 사용할 수 있습니다. 이 조직 외부에서는 사용할 수 없습니다.
왼쪽 탐색 메뉴에서 관리 > 환경 > 흐름 후크를 선택합니다.
흐름 후크 뷰에는 다음이 표시됩니다.
환경 드롭다운 목록에서 수정할 환경을 선택합니다.

흐름 후크 목록에서 공유 흐름을 연결할 흐름 후크를 식별합니다. 선택한 흐름 후크는 공유 흐름을 실행할 위치에 따라 다릅니다.

흐름 후크 위치	설명
Pre-proxy	프록시 엔드포인트가 실행되기 전에 실행됩니다.
Pre-target	대상 엔드포인트가 실행되기 전에 실행됩니다.
Post-proxy	프록시 엔드포인트 이후와 응답을 클라이언트에 전송하기 직전에 실행됩니다.
Post-target	대상 응답이 실행된 후에 실행됩니다.

목록의 흐름 후크 위에 커서를 놓으면 작업 열이 표시됩니다.
수정을 클릭합니다.
공유 흐름 대화상자의 공유 흐름 메뉴에서 연결하려는 공유 흐름을 선택합니다.
확인을 클릭합니다.
필요에 따라 공유 흐름을 다른 흐름 후크에 연결합니다.