20.04.06 - 퍼블릭 클라우드용 Apigee Edge 출시 노트

Apigee Edge 문서를 보고 있습니다.
Apigee X 문서로 이동하세요. info

다음 날짜에 Apigee Edge for Public Cloud의 구성요소 업데이트가 출시되었습니다.

• 메시지 프로세서: 2020년 5월 1일 금요일
• API 관리: 2020년 4월 20일 월요일
• 수익 창출 관리: 2020년 4월 20일 월요일
• API 관리 패치 출시: 2020년 6월 22일 월요일
• 수익 창출 관리 패치 출시: 2020년 7월 6일 월요일
• 관리 서버 보안 업데이트: 2020년 8월 24일 월요일
• 버그 수정이 포함된 메시지 프로세서 패치 출시: 2020년 9월 24일 목요일
• 버그 수정이 포함된 메시지 프로세서 패치 출시: 2020년 10월 26일 월요일
• 버그 수정이 포함된 메시지 프로세서 패치 출시: 2021년 2월 1일 월요일

새로운 기능 및 업데이트

다음은 이번 출시의 새로운 기능과 업데이트입니다.

JWT 정책

• JWT 암호화

  JWT 정책을 사용하면 암호화된 토큰을 생성, 확인, 디코딩할 수 있습니다. 정책의 새로운 요소는 다음과 같습니다.

  • <Type> - 토큰이 서명되었는지 또는 암호화되었는지 설정할 수 있습니다.
  • <EncryptionAlgorithms> - <Key> 및 <Content> 암호화 알고리즘을 설정할 수 있습니다.

  (67165581)

• 서명된 토큰에서 PSS 알고리즘 지원

  이제 JWT 및 JWS 생성 및 확인 정책이 IETF RFC 7518에 설명된 대로 PS256, PS384, PS512 알고리즘을 지원합니다. (119856499)

• 토큰의 GenerateJWT 상대 시작 시간

  GenerateJWT 정책으로 JWT를 생성할 때 <NotBefore> 요소를 사용하면 토큰이 생성된 시점과 유효해지는 시점 사이의 상대 시간을 지정할 수 있습니다. 예를 들어 <NotBefore> 값이 2h이면 토큰이 생성된 후 2시간이 지나야 유효합니다. <NotBefore> 시간을 밀리초 (ms), 초 (s), 분 (m), 시간 (h), 일 (d), 주 (w)로 설정할 수 있습니다. (126261970)

• VerifyJWT에서 공개 키/인증서 참조

  VerifyJWT 정책에서 <PublicKey>/<Certificate> 요소를 사용하면 수신 JWT 서명을 확인할 PEM 형식 인증서를 참조할 수 있습니다. 예를 들면 다음과 같습니다.

  <PublicKey>
    <Certificate ref='public.certificate_pem'/>
  </PublicKey>

  (132918033)

메시지 템플릿 함수

이번 출시에서 사용할 수 있는 새로운 메시지 템플릿 함수는 다음과 같습니다.

• firstnonull - null이 아닌 첫 번째 (가장 왼쪽) 인수의 값을 반환합니다. (139698514)
• xpath - XML 변수를 파싱하기 위해 XML 경로 (XPath) 표현식을 적용할 수 있습니다. (123246424)

AssignMessage 정책: AssignVariable을 사용하면 메시지 템플릿을 참조할 수 있습니다.

AssignMessage 정책에서 <AssignVariable> / <Template> 요소를 사용하면 ref 속성을 사용할 수 있으므로 정책을 수정하지 않고도 변경할 수 있는 사전 정의된 템플릿을 런타임에 삽입할 수 있습니다. (118396082)

여러 인증서 별칭

TLS를 구성하고 키 저장소에서 서로 다른 별칭이 있는 여러 인증서를 사용하는 경우 Edge에서는 <SSLInfo><KeyAlias> 구성에서 특정 인증서 별칭을 참조할 수 있습니다. 이 업데이트된 동작을 사용 설정하려면 메시지 프로세서의 http.properties 파일에서 새 HTTPClient.choose.alias.by.keyalias 속성을 true로 설정하세요. Edge for Public Cloud 사용자는 지원팀에 문의하여 이 속성을 추가해야 합니다. (142141620)

JSONtoXML 정책: XML 선언 생략, 출력 들여쓰기

JSONtoXML 정책의 두 가지 새로운 불리언 옵션을 사용하면 XML 출력을 더 세부적으로 제어할 수 있습니다.

• <Options> <OmitXmlDeclaration> - true로 설정하면(기본값은 false) <OmitXmlDeclaration> 요소가 정책에서 생성된 기본 <?xml version="1.0" encoding="UTF-8"?> XML 선언을 생략합니다.

• <Options> <Indent> - true로 설정하면(기본값은 false) <Indent> 요소가 XML 출력을 들여씁니다. 예를 들어 다음 출력 대신

  <Array><n>1</n><n>2</n><n>3</n></Array>

  Indent 요소는 다음을 생성합니다.

  <Array>
   <n>1</n>
   <n>2</n>
   <n>3</n>
  </Array>

(65142394)

가상 호스트 검사 응답

Apigee 엔드포인트의 IP 주소에 요청이 이루어진 경우 (가상 호스트가 지정되지 않음) Edge는 해당 IP 주소와 연결된 기본 Apigee 가상 호스트에서 HTTP 200 응답과 빈 HTML 문서를 반환했습니다. 이러한 응답이 악용될 수 있는 잠재적 취약점을 나타낼 수 있다는 잘못된 인상을 주지 않기 위해 연결이 삭제되고 응답이 반환되지 않습니다. (140005396)

문제 해결에 도움이 되는 추적의 타겟 서버 속성

다음 새로운 추적 속성은 타겟 서버의 HTTPClient가 캐시되었는지 여부를 표시하여 타겟 연결 문제를 해결하는 데 도움이 됩니다. isHttpClientCached 및 isFromClientPool (140574604)

MessageLogging 정책: 시스템 로그 메시지

MessageLogging 정책에서 새 <Syslog> / <PayloadOnly> 요소(불리언)를 사용하면 정의한 <Message>에 자동으로 추가되는 항목이 있는지 확인할 수 있습니다. <PayloadOnly>을 true로 설정하면 <FormatMessage> 설정과 관계없이 메시지 정의에 아무것도 추가되지 않습니다. false (기본값)로 설정하면 <FormatMessage> 설정에 따라 로그 메시지에 추가되는 내용이 결정됩니다. (68722102)

캐시 정책 만료

ResponseCache 정책 및 PopulateCache 정책의 새로운 <TimeoutInSeconds> 만료 요소는 기존 <TimeoutInSecs> 요소가 원래 의도한 대로 작동합니다. 새 요소를 사용하세요. 지원 중단된 <TimeoutInSecs> 요소는 이전 버전과의 호환성을 위해 계속 존재합니다. <TimeoutInSecs> 및 <TimeoutInSeconds> 요소가 모두 구성된 경우 Edge는 <TimeoutInSeconds>를 사용합니다. (119172893)

virtualhost.aliases.values 흐름 변수

새로운 읽기 전용 virtualhost.aliases.values 메시지 흐름 변수는 인바운드 요청에서 호출된 가상 호스트에 할당된 모든 별칭의 JSON 형식 배열을 반환합니다. (128453178)

프록시 버전 삭제를 보장하는 새로운 매개변수

새 force 쿼리 매개변수가 API 프록시 버전 삭제에 추가되었습니다. 버전이 API 프록시 나열 API에 나열되지만 실제로 쿼리할 수 없는 경우 이 매개변수는 프록시 버전이 삭제되도록 합니다. (111691721)

예를 들면 다음과 같습니다.

DELETE /v1/organizations/myorg/apis/myproxy/revisions/2?force=true

가상 호스트 별칭 값을 위한 새로운 흐름 변수

새로운 읽기 전용 virtualhost.aliases.values 메시지 흐름 변수는 인바운드 요청에서 호출된 가상 호스트에 할당된 모든 별칭의 JSON 형식 배열을 반환합니다. (128453178)

수정된 버그

다음은 이번 출시 버전에서 수정된 버그입니다. 이 목록은 주로 지원 티켓이 수정되었는지 확인하는 사용자를 위한 것입니다. 모든 사용자에게 자세한 정보를 제공하기 위한 목적은 아닙니다.