Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

4.2. 3scale 표준 정책의 정책 체인

각 API 제품에 대해 정책 체인을 지정할 수 있습니다. 정책 체인은 다음을 수행합니다.

  • APIcast가 요청에 적용하는 정책을 지정합니다.
  • 해당 정책에 대한 구성 정보를 제공합니다.
  • APIcast가 정책을 적용하는 순서를 결정합니다.

체인에서 정책을 올바르게 주문하려면 APIcast가 API 소비자 요청에 정책을 적용하는 방법을 이해하는 것이 중요합니다.

4.2.1. APIcast NGINX 단계에서 3scale 정책을 처리하는 방법
링크 복사

3scale API 게이트웨이 또는 APIcast는 NGINX 프록시 웹 서버를 사용하여 정책을 적용합니다. APIcast가 API 소비자로부터 요청을 수신하면 APIcast는 일련의 NGINX 단계에서 요청을 처리합니다. 각 NGINX 단계에서 APIcast는 다음 정책을 적용하여 원래 요청을 수정할 수 있습니다.

  • 업스트림 API 정책 체인의 정책입니다. 정책 체인은 순서가 지정된 정책 목록입니다. 기본적으로 업스트림 API의 정책 체인에는 3scale APIcast 정책이 포함됩니다. API 공급자는 3scale 제품의 정책 체인에 정책을 추가할 수 있습니다. APIcast는 업스트림 API로만 전송된 API 소비자 요청에 업스트림 API 정책 체인의 정책을 적용합니다.
  • 글로벌 3scale 정책 체인의 정책 API 공급자는 3scale 환경 변수를 설정하여 글로벌 정책 체인을 업데이트할 수 있습니다. APIcast는 글로벌 정책 체인의 정책을 모든 API 소비자 요청에 적용합니다.

동일한 정책이 업스트림 API 정책 체인 및 글로벌 정책 체인에 있는 경우 업스트림 API 정책 체인의 정책 구성이 우선합니다.

APIcast가 모든 NGINX 단계에서 필요한 처리를 수행한 후 APIcast는 업스트림 API에 요청을 보냅니다. 따라서 원하는 동작을 달성하기 위해 처리에서 API 소비자 요청을 수정할 수 있으므로 NGINX 단계 정책의 순서를 이해하는 것이 중요합니다.

NGINX 단계에 대한 순서 및 설명

APIcast가 API 소비자로부터 요청을 수신하면 APIcast는 업스트림 API 정책 체인과 글로벌 정책 체인에 정책을 적용하여 요청을 처리합니다. 각 3scale 정책은 하나 이상의 함수를 정의합니다. APIcast는 일련의 NGINX 단계에서 정책 기능을 실행합니다. 각 단계에서 NGINX는 적용되는 정책에 정의된 모든 기능을 실행하고 해당 단계에서 실행을 지정합니다. 다음 표에는 정책 기능을 실행하는 NGINX 단계가 나열되어 있습니다. 이 표에 나열되지 않은 추가 NGINX 단계는 정책 체인의 정책 순서에 의해 영향을 받지 않는 처리를 수행합니다.

Expand
NGINX 순서에 따른 단계이 단계에서 처리 설명

재작성

요청의 대상 URI를 수정하는 모든 함수를 실행합니다.

액세스

클라이언트의 권한을 확인하여 요청을 수행하는 모든 함수를 실행합니다.

내용

업스트림 API로 보낼 요청 콘텐츠를 생성합니다.

NGINX는 콘텐츠 단계에 하나의 정책만 적용합니다. 정책 체인의 두 개 이상의 정책이 요청 콘텐츠에서 작동하는 경우 NGINX는 체인에서 가장 빠른 정책만 적용합니다. 내장 3scale APIcast 정책은 항상 정책 체인에 있으며 콘텐츠 단계에서 NGINX 처리가 필요하기 때문에 이해하는 것이 중요합니다.

예를 들어 3scale APIcast 정책과 Upstream 정책 모두 요청을 업데이트하여 업스트림 API의 경로를 지정합니다. NGINX는 이러한 기능을 콘텐츠 단계에서 처리합니다. 3scale APIcast 정책이 Upstream 정책 앞에 있는 경우 NGINX는 업스트림 API 구성을 사용하여 수정된 요청에 경로를 추가합니다. Upstream 정책이 3scale APIcast 정책 앞에 있는 경우 NGINX는 Upstream 정책 표현식을 평가합니다. 일치 항목이 있는 경우 NGINX는 수정된 요청에서 그에 따라 업스트림 API 경로를 변경합니다.

balancer

모든 로드 밸런싱 기능을 실행합니다.

header_filter

요청 헤더를 처리하는 함수를 실행합니다.

body_filter

요청 본문을 처리하는 모든 함수를 실행합니다.

post_action

NGINX가 실행된 후 요청을 처리하는 모든 함수를 헤더 및 본문에서 실행합니다.

log

요청에 대한 로그 정보를 생성합니다.

메트릭

Prometheus 끝점에서 수신한 모든 데이터에서 작동합니다.

정책 순서의 영향을 받지 않는 처리를 수행하는 NGINX 단계의 예:

  • APIcast가 시작되면 NGINX는 init 단계와 관련된 작업을 실행합니다.
  • APIcast 작업자가 시작되면 NGINX는 init_worker 단계와 관련된 작업을 실행합니다.
  • APIcast가 HTTPS 연결을 종료하면 NGINX는 ssl_certificate 단계와 관련된 작업을 실행합니다.

NGINX가 정책 기능을 실행하는 순서

API 공급자는 3scale 제품에 하나 이상의 정책을 추가하여 정책 체인을 형성할 수 있습니다. 각 단계에서 NGINX는 해당 단계에서 실행을 지정하는 정책 기능만 처리합니다. 각 정책 함수는 하나의 NGINX 단계에서 처리 중에 APIcast가 기본 동작을 변경하는 방법을 지정합니다. 예를 들어 header_filter 단계에서 NGINX는 header_filter 를 지정하는 기능을 처리하고 요청 헤더에서 제대로 작동합니다. 각 단계에서 NGINX는 정책 체인에 있는 순서대로 관련 기능을 처리합니다.

정책은 컨텍스트 오브젝트를 통해 데이터를 공유할 수 있습니다. 정책은 각 단계에서 컨텍스트 오브젝트를 읽고 수정할 수 있습니다.

NGINX가 정책 기능을 실행하는 순서는 다음에 따라 달라집니다.

  • 정책 체인의 정책 위치
  • 특정 정책 기능을 처리하는 NGINX 단계

원하는 동작을 얻으려면 정책 변경 결과가 정책 체인의 위치에 따라 달라질 수 있으므로 정책 체인 주문을 올바르게 지정해야 합니다. 다음 다이어그램에서는 NGINX가 정책을 적용하는 순서의 예를 보여줍니다.

APIcast NGINX 실행 단계 및 3scale 정책 체인
View larger image
APIcast NGINX 실행 단계 및 3scale 정책 체인

이전 그림에서 정책 A 는 먼저 정책 체인에서입니다. 그러나 NGINX는 해당 함수가 NGINX의 첫 번째 단계인 재작성 단계와 관련되어 있기 때문에 먼저 정책 B 의 함수를 처리합니다.

이제 다음 기능을 사용하여 정책 A 및 정책 B 가 포함된 제품의 정책 체인을 고려합니다.

  • 정책 A 는 다음을 지정합니다.

    • Features A1 for NGINX to run in the access phase
    • function A2 for NGINX to run in the header_filter phase

  • 정책 B 는 다음을 지정합니다.

    • NGINX용 B1 함수 B1는 재작성 단계에서 실행
    • NGINX에 대한 B2 함수 헤더_filter 단계에서 실행

다음 그림은 NGINX가 제품의 정책 기능을 실행하는 순서를 보여줍니다.

APIcast NGINX 실행 단계 및 샘플 3scale 정책 체인
View larger image
APIcast NGINX 실행 단계 및 샘플 3scale 정책 체인

APIcast가 이 제품에서 노출된 업스트림 API에 대한 액세스 요청을 수신하면 APIcast는 제품의 정책 체인을 확인하고 다음 표에 설명된 대로 기능을 실행합니다.

Expand
NGINX 순서에 따른 단계이 단계에서 NGINX가 실행되는 함수

재작성

B1 에서 다시 쓰기 단계를 지정하는 B 1 함수 를 실행합니다.

액세스

A1에서 정책 A 1 을 실행하여 액세스 단계를 지정합니다.

내용

정책 또는 정책 B 는 콘텐츠 단계에서의 실행을 위한 함수를 지정하지 않습니다.

balancer

정책 A 또는 정책 B 는 밸런서 단계에서의 실행을 위한 기능을 지정하지 않습니다.

header_filter

정책 체인은 정책 A 를 지정한 다음 정책 B 를 지정합니다. 결과적으로 이 단계는 정책 A 가 header_filter 단계에 대해 지정하는 함수 A2 를 실행한 다음, B 가 header_filter 단계에 지정하는 함수 B2 를 실행합니다.

body_filter

정책 A 또는 정책 B 는 이 단계에서의 실행을 위한 기능을 지정하지 않습니다.

post_action

정책 A 또는 정책 B 는 이 단계에서의 실행을 위한 기능을 지정하지 않습니다.

log

정책 A 또는 정책 B 는 이 단계에서의 실행을 위한 기능을 지정하지 않습니다.

이 예에서 정책 A 는 정책 체인에서 먼저 있지만 정책 B 의 함수는 NGINX가 실행하는 첫 번째 기능입니다. 이는 정책 B 가 다른 단계보다 먼저 제공되는 재작성 단계에서 NGINX 프로세스에서 처리하는 함수 B1 을 지정하기 때문입니다.

또 다른 예로 이 정책 체인을 고려하십시오.

  1. URL 재작성
  2. 3scale APIcast (모든 제품에 할당된 기본 정책)

URL 재작성 정책 은 요청의 대상 경로를 수정합니다. APIcast는 재작성 단계에서 URL 재작성 기능을 실행합니다. 3scale APIcast 정책은 APIcast가 재작성 단계에서 실행되는 기능과 APIcast가 다른 세 단계로 실행되는 기능을 정의합니다. URL 재작성 정책이 우선되면 3scale APIcast 정책은 매핑 규칙을 다시 작성한 경로에 적용합니다. 3scale APIcast 정책이 먼저 있고 URL 재작성 정책이 두 번째이면 3scale APIcast 정책은 매핑 규칙을 원 래 경로에 적용합니다.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat