현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보
HTTP 사양 RFC 7230, 섹션 3.2.2: 필드 순서에 따라 Apigee Edge는 클라이언트의 HTTP 요청 또는 백엔드 서버의 HTTP 응답에 같거나 다른 값으로 두 번 이상 전달되는 동일한 헤더가 포함되어 있지 않을 것으로 예상합니다. 단, 특정 헤더에 예외가 있고 중복이 허용되는 경우는 예외입니다.
기본적으로 Apigee Edge에서는 중복 및 여러 값을 대부분의 HTTP 헤더에 전달할 수 있습니다. 그러나 중복 및 여러 값을 가질 수 없는 헤더에 나열된 특정 헤더는 허용하지 않습니다. 따라서 날짜는 다음과 같이 계산합니다.
- 클라이언트에서 특정 헤더와 함께 HTTP 요청을 2회 이상 전송하거나 Apigee Edge에서 중복 또는 여러 값을 가질 수 없는 HTTP 헤더 값이 여러 개 포함된 HTTP 요청을 전송하면
400 Bad Request이 발생합니다.protocol.http.DuplicateHeader - 마찬가지로 백엔드 서버에서 특정 헤더가 포함된 HTTP 응답을 2회 이상 전송하거나 Apigee Edge에서 중복 또는 여러 값을 가질 수 없는 여러 HTTP 헤더 값이 포함된 HTTP 응답을 전송하는 경우 마찬가지로
502 Bad Gateway이 발생합니다.protocol.http.DuplicateHeader
이러한 오류를 해결하기 위한 권장 솔루션은 중복 헤더를 전송하지 않도록 클라이언트 애플리케이션과 백엔드 서버를 수정하고 다음 문제 해결 플레이북에 설명된 대로 RFC 7230, 섹션 3.2.2: 필드 순서 사양을 준수하는 것입니다.
하지만 경우에 따라 일부 HTTP 헤더에 대해 중복 값과 여러 값을 포함하도록 예외를 추가할 수 있습니다. 이 경우 메시지 프로세서 수준에서 속성 HTTPHeader.HEADER_NAME를 설정하여 중복 헤더와 특정 HTTP 헤더에 대한 여러 값을 허용할 수 있습니다.
이 문서에서는 이 속성에 관한 정보를 제공하고, 이 속성을 사용 설정하여 위에 언급된 오류를 방지하는 방법을 설명하고, 이와 관련된 권장사항을 공유합니다.
중복 및 여러 값을 허용하는 HTTP 헤더 속성
Apigee Edge는 다음 두 속성을 제공하여 HTTP 헤더에 대한 중복 및 여러 값을 허용하는 동작을 제어합니다. 이는 Edge 구성 방법에 설명된 토큰 구문을 사용하여 메시지 프로세서에서만 구성할 수 있습니다.
| 속성 이름 | 설명 | 허용되는 값 |
|---|---|---|
HTTPHeader.ANY |
이 속성은 클라이언트에서 보낸 HTTP 요청의 일부로 전송된 커스텀 헤더 또는 백엔드 서버에서 Apigee Edge로 보낸 HTTP 응답의 일부로 전송된 커스텀 헤더를 포함한 모든 HTTP 헤더에 중복 또는 여러 값이 허용되는지 여부를 나타냅니다. 기본값:
|
|
|
이 속성은 |
위와 동일 |
중복 및 여러 값을 가질 수 없는 헤더
앞에서 설명한 것처럼 Apigee Edge는 기본적으로 대부분의 HTTP 헤더에 대한 중복 및 여러 값을 허용합니다. 이는 HTTPHeader.ANY 속성이 multivalued, allowDuplicate. 값으로 구성되었기 때문입니다.
구성을 덮어씀
일부 특정 헤더의 경우 다음 방법 중 하나를 사용하여 기본 구성을 덮어씁니다.
HTTPHeader.HEADER_NAME=multivalued, allowDuplicate이 구성은 기본 동작을 변경하지 않습니다. 즉, 특정 헤더에 중복된 여러 개의 값을 가질 수 있습니다.
.HTTPHeader.HEADER_NAME=이 구성은 기본 동작을 변경합니다. 즉, 특정 헤더에 중복되는 값과 여러 값을 가질 수 없습니다.
중복 및 여러 값을 가질 수 없는 헤더 확인
이 섹션에서는 다음을 식별하는 방법을 설명합니다.
- Apigee Edge 프라이빗 클라우드 설정에서 중복 및 여러 값을 가질 수 없는 특정 헤더
- 기존 구성이 있는 특정 헤더
메시지 프로세서 시스템의
/opt/apigee/edge-message-processor/conf디렉터리에서 다음과 같이 속성HTTPHeader.를 검색합니다.grep -ri "HTTPHeader." /opt/apigee/edge-message-processor/conf
샘플 출력:
# grep -ri "HTTPHeader" /opt/apigee/edge-message-processor/conf /opt/apigee/edge-message-processor/conf/http.properties:HTTPHeader.ANY=allowDuplicates, multiValued /opt/apigee/edge-message-processor/conf/http.properties:HTTPHeader.Connection=allowDuplicates, multiValued … <snipped> /opt/apigee/edge-message-processor/conf/http.properties:HTTPHeader.Host= /opt/apigee/edge-message-processor/conf/http.properties:HTTPHeader.Expires= /opt/apigee/edge-message-processor/conf/http.properties:HTTPHeader.Date=allowDuplicates … <snipped>
- 덮어쓴 구성 섹션에 설명된 대로 위의 샘플 출력에서 다음 정보를 확인합니다.
- HTTP 헤더
Connection를 덮어쓰지만 중복 및 여러 값을 가질 수 있습니다. - HTTP 헤더
Host와Expires을 덮어쓰게 되며 중복 및 여러 값을 가질 수 없습니다. - HTTP 헤더
Date을 덮어쓰게 되며 중복 값을 가질 수 있지만 여러 값을 가질 수 없습니다. - 여기에 표시된 모든 헤더 (위 샘플의
Connection,Host,Expires,Date)는 이 문서에서는 기존 구성이 있는 헤더라고 합니다.
- HTTP 헤더
Apigee Edge의 동작
다음 표에서는 헤더가 중복으로 전송되었을 때의 Apigee Edge 동작을 메시지 프로세서에서 HTTPHeader 속성이 구성된 방식에 따라 여러 개의 값(예: HTTPHeader test-header)을 사용하여 설명합니다.
| 요청 | conf/http.properties+HTTPHeader.test-header=의 값을 기준으로 한 발신 HEADERS | |||
|---|---|---|---|---|
| <내용 없음> | allowDuplicate | multiValued | allowDuplicate, multiValued (기본값) | |
test‑header=a,b |
test‑header=a,b |
test‑header=a,b |
내부적으로
|
내부적으로
원래 양식이 타겟으로 전송됩니다 |
test‑header=atest‑header=b |
protocol.http. |
test‑header=atest‑header=b |
protocol.http. |
test‑header=atest‑header=b |
시작하기 전에
이 문서의 단계를 사용하려면 먼저 에지 구성 방법에 설명된 대로 Private Cloud의 Edge 속성 구성을 이해해야 합니다.
allowDuplicates 및 헤더의 여러 값 구성
중복 및 여러 값을 허용하는 HTTP 헤더 속성에서 설명한 대로 HTTPHeader.ANY = allowDuplicates,
multivalued 속성의 값은 Apigee Edge에서 모든 헤더에 중복과 여러 값이 허용될 수 있음을 의미합니다. 하지만 HTTPHeader.HEADER_NAME 속성을 사용하여 중복 헤더 또는 여러 값을 허용하지 않도록 명시적으로 값을 덮어쓰는 특정 헤더도 있습니다.
이 섹션에서는 Edge 구성 방법에 설명된 구문에 따라 해당 토큰을 사용하여 메시지 프로세서에서 이러한 HTTP 헤더에 대한 중복 및 여러 값을 허용하도록 속성 HTTPHeader.HEADER_NAME를 구성하는 방법을 설명합니다.
이 섹션에서는 아래에 설명된 대로 중복 및 여러 값을 허용하고자 하는 예시 헤더로 Expires (및 myheader)를 사용합니다.
HTTPHeaderHEADER_NAME속성의 현재 값을 확인하여 다음 명령어를 사용하여 중복 및 여러 값을 허용하도록 이미 사용 설정되지 않았는지 확인합니다.grep -ri "HTTPHeader.HEADER_NAME" /opt/apigee/edge-message-processor/conf
예를 들어
Expires헤더의 속성을 설정하려면 메시지 프로세서에서 속성HTTPHeader.Expires토큰의 현재 값을 확인합니다.grep -ri "HTTPHeader.Expires" /opt/apigee/edge-message-processor/conf
위 명령어를 실행하면 다음 중 하나가 출력됩니다.
- 속성이 공백으로 설정된 경우 중복 헤더 및 여러 값을 허용하지 않도록 값을 덮어쓰게 되며 (이는 기존 구성이 있는 헤더임) 이를 암시합니다. 즉, HTTP 요청 또는 HTTP 응답의 일부로
Expires헤더를 Apigee에 두 번 이상 전송할 수 없습니다. - 특정 속성에 대한 적중 항목이 없으면 값을 덮어쓸 수 없습니다 (또한 기존 구성이 있는 헤더가 아닙니다). 즉, Apigee Edge에 대한 HTTP 요청 또는 HTTP 응답의 일부로 특정 헤더를 두 번 이상 전송할 수 있습니다 (중복 허용).
- 속성이
allowDuplicates, multivalued값으로 설정되면 값이 명시적으로 덮어씌워집니다 (이는 기존 구성이 있는 헤더입니다). 즉, 특정 헤더를 Apigee에 대한 HTTP 요청 또는 HTTP 응답의 일부로 두 번 이상 전송할 수 있습니다 (중복 허용).
검색 명령어의 샘플 출력:
/opt/apigee/edge-message-processor/conf/http.properties:HTTPHeader.Expires=
위의 샘플 출력에서는
HTTPHeader.Expires속성이 공백으로 설정된 것을 보여줍니다. 즉, 헤더Expires에 중복되거나 여러 개의 값을 허용하지 않도록 속성을 덮어쓰게 됩니다.- 속성이 공백으로 설정된 경우 중복 헤더 및 여러 값을 허용하지 않도록 값을 덮어쓰게 되며 (이는 기존 구성이 있는 헤더임) 이를 암시합니다. 즉, HTTP 요청 또는 HTTP 응답의 일부로
- 특정 헤더에 해당하는 속성이 위의 출력 예와 같이 중복 또는 여러 값을 허용하지 않도록 명시적으로 덮어쓴 것을 확인한 경우만 다음 단계를 수행합니다. 명시적으로 덮어쓰지 않은 경우 이 섹션의 나머지 단계를 건너뜁니다.
- 수정을 클릭합니다. 존재하지 않으면 다음과 같이 만들 수 있습니다.
/opt/apigee/customer/application/message-processor.properties
예를 들어 vi를 사용하여 파일을 열려면 다음을 입력합니다.
vi /opt/apigee/customer/application/message-processor.properties
- 다음 형식으로 줄을 추가합니다.
conf_http_HTTPHeader.Expires=allowDuplicates, multiValued
- 변경사항을 저장합니다.
속성 파일을
apigee사용자가 소유하고 있는지 확인합니다. 그렇지 않은 경우 다음 명령어를 실행합니다.chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
메시지 프로세서를 다시 시작합니다.
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
트래픽에 영향을 미치지 않고 다시 시작하려면 트래픽 영향 없이 메시지 프로세서 순차적 재시작을 참조하세요.
- 메시지 프로세서가 2개 이상 있으면 모든 메시지 프로세서에서 위 단계를 반복합니다.
중복 및 여러 값을 포함하도록 헤더가 구성되었는지 확인
이 섹션에서는 메시지 프로세서에서 중복을 허용하도록 특정 헤더의 HTTPHeader.HEADER_NAME 속성이 성공적으로 업데이트되었는지 확인하는 방법을 설명합니다.
Expires를 헤더로 사용하고 상응하는 속성 HTTPHeader.Expires가 업데이트되었는지 확인합니다.
conf_http_HTTPHeader.Expires 토큰을 사용하여 메시지 프로세서의 값을 업데이트하더라도 실제 속성 HTTPHeader.Expires가 새 값으로 설정되었는지 확인해야 합니다.
- 메시지 프로세서 시스템의
/opt/apigee/edge-message-processor/conf디렉터리에서HTTPHeader.HEADER_NAME속성을 검색하고 아래와 같이 새 값으로 설정되어 있는지 확인합니다.grep -ri "HTTPHeader.HEADER_NAME" /opt/apigee/edge-message-processor/conf
예를 들어
HTTPHeader.Expires속성이 새 값으로 설정되어 있는지 확인하려면 다음 명령어를 실행합니다.grep -ri "HTTPHeader.Expires" /opt/apigee/edge-message-processor/conf
- 메시지 프로세서에서
HTTPHeader.HEADER_NAME에 새 값이 성공적으로 설정되면 위 명령어는http.properties파일에 새 값을 표시합니다. allowDuplicates및multiValued를 구성한 후 위 명령어를 실행하면 샘플 결과는 다음과 같습니다./opt/apigee/edge-message-processor/conf/http.properties:HTTPHeader.Expires=allowDuplicates, multiValued
- 위의 출력 예에서
HTTPHeader.Expires속성은http.properties의 새 값allowDuplicates, multiValued로 설정되어 있습니다. 이는 중복 및HTTPHeader의 여러 값을 허용하는 동작이 메시지 프로세서에 성공적으로 구성되었음을 나타냅니다. HTTPHeader.HEADER_NAME속성의 이전 값이 계속 표시되면 allowDuplicates 및 헤더의 여러 값 구성에 설명된 모든 단계를 올바르게 수행했는지 확인합니다. 누락된 단계가 있으면 모든 단계를 다시 올바르게 반복합니다.특히 프록시에서 헤더를 가져오고 설정하는 기능 로직이 있는 경우 프록시가 예상대로 작동하는지 확인합니다.
- 여전히 속성을 수정할 수 없는 경우 Apigee Edge 지원팀에 문의하세요.
헤더의 allowDuplicates 사용 중지
이 섹션에서는 Edge 구성 방법에 설명된 구문에 따라 해당 토큰을 사용하여 메시지 프로세서의 특정 HTTP 헤더에 대해 중복 및 여러 값을 허용하지 않도록 속성 HTTPHeader.{Headername}를 구성하는 방법을 설명합니다.
이 섹션에서는 아래에 설명된 대로 중복을 허용하지 않는 예시 헤더로 Expires (및 myheader)를 사용합니다.
- 다음 명령어를 사용하여
HTTPHeaderHEADER_NAME속성의 현재 값을 확인하여 중복 및 여러 값을 허용하도록 이미 사용 중지되지 않았는지 확인합니다.grep -ri "HTTPHeader.HEADER_NAME" /opt/apigee/edge-message-processor/conf
예를 들어
Expires헤더의 속성을 설정하려면 메시지 프로세서에서 속성HTTPHeader.Expires토큰의 현재 값을 확인합니다.grep -ri "HTTPHeader.Expires" /opt/apigee/edge-message-processor/conf
위 명령어를 실행하면 다음 중 하나가 출력됩니다.
- 속성이 공백으로 설정된 경우 중복 헤더와 여러 값을 허용하지 않도록 하기 위해 값을 덮어쓰지 않음을 의미합니다. 즉, HTTP 요청 또는 HTTP 응답의 일부로
Expires헤더를 Apigee에 두 번 이상 전송할 수 없습니다. - 특정 속성에 대한 적중 항목이 없으면 값을 덮어쓰지 않으며 이는 기존 구성이 있는 NOT 헤더입니다. 즉, Apigee Edge에 대한 HTTP 요청 또는 HTTP 응답의 일부로 특정 헤더를 두 번 이상 전송할 수 있습니다 (중복 허용).
- 속성이
allowDuplicates, multivalued값으로 설정되면 해당 값이 명시적으로 덮어써지고 이는 기존 구성이라는 의미입니다. 하지만 HTTP 요청 또는 HTTP 응답의 일부로 특정 헤더를 Apigee에 두 번 이상 전송할 수 있습니다 (중복 허용).
샘플 출력 #1
검색 명령어의 샘플 출력 #1:
/opt/apigee/edge-message-processor/conf/http.properties:HTTPHeader.Expires=allowDuplicates, multiValued
샘플 출력에서
HTTPHeader.Expires속성이allowDuplicates, multiValued로 설정되었음을 알 수 있습니다. 즉, 헤더Expires에 중복 또는 여러 값을 허용하도록 속성을 덮어쓰게 됩니다.샘플 출력 #2
샘플 명령어 및 검색 명령어의 출력 #2
grep -ri "HTTPHeader.myheader" /opt/apigee/edge-message-processor/conf
샘플 출력에 출력이 표시되지 않습니다. 즉,
HTTPHeader.myheader속성이 기본적으로allowDuplicates, multiValued로 설정되었음을 의미합니다. 이는 또한 헤더 myheader, 즉 - 속성이 공백으로 설정된 경우 중복 헤더와 여러 값을 허용하지 않도록 하기 위해 값을 덮어쓰지 않음을 의미합니다. 즉, HTTP 요청 또는 HTTP 응답의 일부로
- 다음 중 하나가 표시되면 이 섹션의 나머지 단계를 수행합니다.
- 위의 샘플 출력 #1 (기존 구성이 있는 헤더)에서와 같이 특정 헤더에 해당하는 속성은 중복 및 여러 값을 허용하도록 덮어써집니다.
- 위의 샘플 출력 #2와 같이 특정 헤더에 해당하는 속성에 대한 적중 항목이 없습니다 (기존 구성이 있는 헤더가 아님).
그 외의 경우에는 이 섹션의 나머지 단계를 건너뜁니다.
- 다음 파일을 수정합니다. 존재하지 않으면 만들 수 있습니다.
/opt/apigee/customer/application/message-processor.properties
예를 들어 vi를 사용하여 파일을 열려면 다음을 입력합니다.
vi /opt/apigee/customer/application/message-processor.properties
- 다음 형식의 줄을 속성 파일에 추가합니다.
기존 구성
시나리오 #1: 기존 구성이 있는 헤더:
conf_http_HTTPHeader.Expires=
기존 구성 없음
시나리오 #2: 기존 구성이 포함된 헤더가 아님:
conf/http.properties+HTTPHeader.myheader=
- 변경사항을 저장합니다.
- 속성 파일을
apigee사용자가 소유하고 있는지 확인합니다. 그렇지 않은 경우 다음을 실행합니다.chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
- 메시지 프로세서를 다시 시작합니다.
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
트래픽에 영향을 미치지 않고 다시 시작하려면 트래픽 영향 없이 메시지 프로세서 순차적 재시작을 참조하세요.
- 메시지 프로세서가 두 개 이상 있으면 모든 메시지 프로세서에서 위 단계를 반복합니다.
중복 및 여러 값을 허용하지 않도록 헤더가 구성되었는지 확인
이 섹션에서는 메시지 프로세서에 중복을 허용하지 않도록 특정 헤더의 HTTPHeader.HEADER_NAME 속성이 성공적으로 업데이트되었는지 확인하는 방법을 설명합니다.
Expires (및 myheader)를 헤더 예시로 사용하고 해당하는 속성 HTTPHeader.Expires (및 HTTPHeader.myheader)가 업데이트되었는지 확인합니다.
메시지 프로세서 시스템의
/opt/apigee/edge-message- processor/conf디렉터리에서HTTPHeader.HEADER_NAME속성을 검색하여 아래와 같이 새 값으로 설정되어 있는지 확인합니다.grep -ri "HTTPHeader.HEADER_NAME" /opt/apigee/edge-message-processor/conf
예를 들어
HTTPHeader.Expires속성이 새 값으로 설정되어 있는지 확인하려면 다음 명령어를 실행하면 됩니다.기존 구성
grep -ri "HTTPHeader.Expires" /opt/apigee/edge-message-processor/conf
기존 구성 없음
grep -ri "HTTPHeader.myheader" /opt/apigee/edge-message-processor/conf
- 메시지 프로세서의
HTTPHeader.HEADER_NAMEI에 새 HTTP 헤더 값이 성공적으로 설정되면 위 명령어는http.properties파일에 새 값을 표시합니다. allowDuplicates를 사용 중지한 후 위 명령어를 실행할 때의 샘플 결과는 다음과 같습니다.기존 구성
시나리오 #1: 만료 헤더 (기존 구성 포함)
/opt/apigee/edge-message-processor/conf/http.properties:HTTPHeader.Expires=
기존 구성 없음
시나리오 #2: myheader 헤더 (기존 구성이 있는 헤더가 아님)
/opt/apigee/edge-message-processor/conf/http.properties:HTTPHeader.myheader=
- 위의 출력 예에서 속성
HTTPHeader.Expires( 및HTTPHeader.myheader)가http.properties의 새 값 {blank}으로 설정되었습니다. 이는 메시지 프로세서에서 특정 HTTP 헤더Expires(및myheader)의 중복 및 여러 값을 허용하는 동작이 성공적으로 사용 중지되었음을 나타냅니다. HTTPHeader.Expires (or HTTPHeader.myheader)속성의 이전 값이 계속 표시되면 allowDuplicates 및 헤더의 여러 값 구성에 설명된 모든 단계를 올바르게 수행했는지 확인합니다. 누락된 단계가 있으면 모든 단계를 다시 올바르게 반복합니다.특히 프록시에서 헤더를 가져오고 설정하는 기능 로직이 있는 경우 프록시가 예상대로 작동하는지 확인합니다.
- 여전히 속성을 수정할 수 없는 경우 Apigee Edge 지원팀에 문의하세요.