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

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동
정보

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

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

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

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

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

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

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

공유 흐름에 대한 자세한 내용은 재사용 가능한 공유 흐름을 참고하세요.

Apigee Edge 관리 콘솔을 사용하여 흐름 후크에 공유 흐름을 연결합니다. 다음 위치에서 각각 최대 1개의 공유 흐름을 흐름 후크에 연결할 수 있습니다.

  • 사전 프록시 흐름 후크: 프록시 엔드포인트가 실행되기 전에 적용해야 하는 로직에 사용합니다.

    예를 들어 환경의 모든 API에 보안을 적용하기 위한 로직이 있을 수 있습니다.

  • 타겟 전 흐름 후크: 타겟이 호출되기 전에 적용해야 하는 로직에 사용합니다.

    예를 들어 요청이 백엔드에 도달하기 전에 로깅을 구현할 수 있습니다. 요청에서 특정 필드를 삭제하여 미디에이션을 적용할 수도 있습니다.

  • 타겟 응답이 실행된 후 적용해야 하는 로직의 대상 후 흐름 후크

    이는 응답이 백엔드에서 다시 돌아오는 즉시 적용됩니다. 이것을 사용하여 백엔드 응답을 로깅하거나 백엔드 응답에서 민감한 필드를 삭제하여 일부 미디에이션을 수행할 수 있습니다.

  • 프록시 후 흐름 후크: 프록시 엔드포인트 이후, 그리고 응답이 클라이언트로 전송되기 직전에 적용해야 하는 로직에 사용합니다.

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

흐름 후크에 공유 흐름 연결

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

  1. 아래에 설명된 대로 Flow 후크 페이지에 액세스합니다.

    에지

    Edge UI를 사용하여 흐름 후크 페이지에 액세스하려면 다음 안내를 따르세요.

    1. apigee.com/edge에 로그인합니다.
    2. 공유 흐름을 포함하는 조직을 선택합니다. 조직 간에 전환하기를 참고하세요.

      공유 흐름은 이 조직에서 환경에 배포된 모든 API 프록시 및 공유 흐름에서 사용할 수 있습니다. 이 조직 외부에서는 사용할 수 없습니다.

    3. 왼쪽 탐색 메뉴에서 관리 > 환경 > 흐름 후크를 선택합니다.

    Classic Edge (Private Cloud)

    기존 Edge UI를 사용하여 Flow 후크 페이지에 액세스하려면 다음 안내를 따르세요.

    1. http://ms-ip:9000에 로그인합니다. 여기서 ms-ip는 관리 서버 노드의 IP 주소 또는 DNS 이름입니다.
    2. 공유 흐름을 포함하는 조직을 선택합니다. 조직 간에 전환하기를 참고하세요.

      공유 흐름은 이 조직에서 환경에 배포된 모든 API 프록시 및 공유 흐름에서 사용할 수 있습니다. 이 조직 외부에서는 사용할 수 없습니다.

    3. 상단 탐색 메뉴에서 API > 환경 구성 > 흐름 후크를 선택합니다.
  2. 흐름 후크 목록에서 공유 흐름을 실행할 위치에 따라 공유 흐름을 연결할 흐름 후크를 식별합니다.
    흐름 후크 위치 설명
    사전 프록시 흐름 후크 프록시 엔드포인트 실행 전
    사전 대상 흐름 후크 대상 엔드포인트 실행 전
    사후 대상 흐름 후크 대상 응답 실행 후
    사후 프록시 흐름 후크 프록시 엔드포인트 뒤와 응답이 클라이언트로 전송되기 직전
  3. 목록에서 흐름 후크 위에 커서를 올려놓으면 작업 열이 표시됩니다.
  4. 를 클릭합니다.
  5. 공유 흐름 대화상자의 공유 흐름 드롭다운에서 연결할 공유 흐름을 선택합니다.
  6. OK(확인)를 클릭합니다.
  7. 필요에 따라 공유 흐름을 다른 흐름 후크에 연결합니다.