4장. APIcast 네이티브 배포와 정책 체인 통합

일부 표준 정책은 일반 문자열 값뿐만 아니라 요청 컨텍스트에서 존재하는 변수도 사용할 수 있는 Liquid templatelating을 지원합니다.

컨텍스트 변수를 사용하려면 해당 이름을 {{ 및 }} 로 래핑합니다(예: {{ uri }} ). 변수가 오브젝트인 경우 해당 속성에 액세스할 수도 있습니다(예: {{ some somevar.attr }} ).

다음은 모든 정책에서 사용할 수 있는 표준 변수입니다.

이러한 표준 변수는 요청 컨텍스트에서 사용되지만 정책은 컨텍스트에 더 많은 변수를 추가할 수 있습니다. 단계는 APIcast의 모든 실행 단계를 나타냅니다. 다음과 같은 경우 정책 체인의 모든 정책에서 변수를 사용할 수 있습니다.

다음은 표준 3scale APIcast 정책이 컨텍스트에 추가하는 변수의 몇 가지 예입니다.

컨텍스트에서 사용 가능한 전체 오브젝트 및 값 목록은 Liquid 컨텍스트 디버그 를 참조하십시오.

변수는 Liquid 템플릿의 도움말과 함께 사용됩니다. 예: {{ remote_addr }}, {{ headers['ECDHE-Header'] }}, {{ jwt.aud }}. 값에 대한 변수를 지원하는 정책에는 일반적으로 _type 접미사가 있는 특수 매개변수(예: value_type,name_type. 즉 일반 텍스트에 "plain", "liquid")가 있습니다.

APIcast는 변수 값에 적용할 수 있는 Liquid 필터도 지원합니다. 필터는 Liquid 변수의 값에 NGINX 함수를 적용합니다.

필터는 변수 출력 태그 {{ }}; 변수 이름 또는 파이프 문자 | 및 필터 이름에 따라 리터럴 값에 따라 배치됩니다. 예:

일부 필터에는 매개변수가 필요하지 않으므로 변수 대신 빈 문자열을 사용할 수 있습니다. 예: {{ '' | utctime }} 는 현재 시간을 UTC 표준 시간대로 반환합니다.

필터는 다음과 같이 연결할 수 있습니다: {{ variable | function1 | function2 }} }} 예: {{ '' | utctime | escape_uri }} }}

다음은 사용 가능한 함수 목록입니다.