4.52.00.03 - Private Cloud용 Edge 출시 노트

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

2023년 10월 25일에 프라이빗 클라우드용 Apigee Edge의 새 버전이 출시되었습니다.

참고: 이 버전은 2024년 10월 25일까지 지원됩니다.

업데이트 절차

이 섹션에서는 Private Cloud용 Edge의 이전 출시 버전에서 업데이트하는 경우 이 출시 버전을 설치하는 방법을 설명합니다. 이전 버전에서 업데이트해야 하는 경우 여러 패치 버전 적용을 참고하세요.

이 버전을 업데이트하면 다음 RPM 목록의 구성요소가 업데이트됩니다.

  • edge-gateway-4.52.00-0.0.60200.noarch.rpm
  • edge-management-server-4.52.00-0.0.60200.noarch.rpm
  • edge-message-processor-4.52.00-0.0.60200.noarch.rpm
  • edge-postgres-server-4.52.00-0.0.60200.noarch.rpm
  • edge-qpid-server-4.52.00-0.0.60200.noarch.rpm
  • edge-router-4.52.00-0.0.60200.noarch.rpm
  • apigee-sso-4.52.00-0.0.21316.noarch.rpm
  • edge-analytics-4.52.00-0.0.40100.noarch.rpm
  • edge-management-ui-4.52.00-0.0.20029.noarch.rpm
  • edge-ui-4.52.00-0.0.20233.noarch.rpm
  • apigee-service-4.52.00-0.0.1500.noarch.rpm
  • apigee-mirror-4.52.00-0.0.1032.noarch.rpm
  • apigee-tomcat-9.0.82-0.0.939.noarch.rpm
  • apigee-configutil-4.52.00-0.0.624.noarch.rpm

다음을 입력하여 현재 설치된 RPM 버전을 확인하고 업데이트가 필요한지 확인할 수 있습니다.

apigee-all version

설치를 업데이트하려면 Edge 노드에서 다음 절차를 수행합니다.

  1. 모든 Edge 노드에서:

    1. Yum 저장소를 삭제합니다.
      sudo yum clean all
    2. 최신 Edge 4.52.00 bootstrap_4.52.00.sh 파일을 /tmp/bootstrap_4.52.00.sh에 다운로드합니다.
      curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
    3. Edge 4.52.00 apigee-service 유틸리티 및 종속 항목을 설치합니다.
      sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord

      여기서 uNamepWord은 Apigee에서 받은 사용자 이름과 비밀번호입니다. pWord를 생략하면 입력하라는 메시지가 표시됩니다.

    4. source 명령어를 사용하여 apigee-service.sh 스크립트를 실행합니다.
      source /etc/profile.d/apigee-service.sh
  2. 모든 Edge 노드에서 에지 프로세스의 update.sh 스크립트를 실행합니다.
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  3. 모든 노드에서 SSO에 대해 update.sh 스크립트를 실행합니다.
  4. /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  5. 모든 UI 노드에서 UI의 update.sh 스크립트를 실행합니다.
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. New Edge 환경을 사용하는 경우 다음 명령어를 실행합니다.
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile

보안 문제 해결됨

다음은 이번 버전에서 수정된 알려진 보안 문제의 목록입니다. 이 문제를 방지하려면 최신 버전의 프라이빗 클라우드용 Edge를 설치하세요.
문제 ID 설명
279065506 OAuth2의 리디렉션 URL에서 크로스 사이트 요청 위조 (CSRF) 취약점을 피하기 위해 상태 매개변수의 엔트로피가 예측할 수 없게 개선되었습니다.",
279065586 헤더에 콘텐츠 보안 정책을 추가하여 클라이언트 측 공격으로 인한 사이트의 보안을 강화했습니다.

지원되는 소프트웨어 변경사항

다음 소프트웨어 버전에 대한 지원이 추가되었습니다.

  • Red Hat Enterprise Linux (Intel 64비트): 버전 8.8
  • Oracle Linux (Intel 64비트): 버전 7.9, 8.7, 8.8
  • Rocky Linux 8
  • Tomcat 9.0.82

지원되는 소프트웨어의 전체 목록은 Private Cloud 지원 소프트웨어용 Edge를 참조하세요.

지원 중단 및 사용 중지

이 출시 버전에는 새로운 지원 중단 또는 지원 중단이 없습니다.

새로운 기능

이 릴리스에서는 다음과 같은 새로운 기능을 제공합니다.

조직 및 환경 이름의 최대 문자 수 설정

이 출시 버전에서는 새 조직 또는 환경을 만들 때 조직 및 환경 이름의 최대 문자 수를 제한할 수 있습니다. 최대 문자 수의 기본값은 255자입니다. 최댓값을 더 낮게 설정하려면 각 속성 파일에 다음 속성을 설정합니다.

  • 조직 속성 파일에서 org.name.max.length를 설정합니다.
  • 조직 속성 파일에서 env.name.max.length를 설정합니다.

이러한 속성 중 하나가 0보다 작거나 255보다 큰 값으로 설정되면 시스템은 각각 1 또는 255의 최댓값을 사용합니다.

액세스 토큰 만료 설정

이 출시 버전에서는 conf_keymanagement_oauth_access_token_expiry_time_in_millis 속성을 원하는 만료 시간(밀리초)으로 설정하여 액세스 토큰의 만료 시간을 설정할 수 있습니다. 이 기능은 기본적으로 사용 중지되어 있습니다. 사용 설정하려면 메시지 프로세서에서 conf_keymanagement_oauth_access_token_is_apply_limittrue로 설정합니다.

이 기능을 사용하면 Apigee 관리자가 Apigee에서 생성된 액세스 토큰의 만료를 더 효과적으로 제어할 수 있습니다.

버그 수정

이 섹션에는 이번 출시 버전에서 수정된 Private Cloud 버그가 나와 있습니다.

문제 ID 설명
290242749

DataMasking에서 ServiceCallout.response 변수가 사용되면 정책이 trace에 표시되지 않았습니다.

이 문제가 해결되었습니다.
260397807

이메일 템플릿의 문제로 인해 멀티바이트 문자가 이메일로 전송되지 않았습니다.

이 문제가 해결되었습니다.
234544436

새 Edge UI에서 조직을 변경할 때 왼쪽 메뉴가 사라지는 문제가 있었습니다.

이 문제가 해결되었습니다.
293268203

관리 서버 노드에서 애널리틱스 종속 항목이 자동으로 업그레이드되지 않았습니다.

이 문제가 해결되었습니다.
261616264

업그레이드 프로세스 중에 postgresql이 삭제/삭제되지 않도록 부트스트랩 검사를 추가했습니다.

279065586

OAuth2용 리디렉션 URL에서 크로스 사이트 요청 위조 (CSRF) 취약점을 피하기 위해 상태 매개변수의 엔트로피를 예측할 수 없도록 개선했습니다.

283310836

대용량 XML을 파싱할 때 표시되는 오류 메시지가 개선되었습니다.

245936798

조직 및 환경 이름 문제로 인해 Postgresql <code<create< code="" dir="ltr" translate="no"> 쿼리가 실패했습니다.</code<create<>

이 문제는 긴 조직 및 환경 이름에 대한 postgres 색인 이름 충돌 처리를 개선하여 수정되었습니다.
293733533

Edge Gateway 구성요소의 Spring 타사 라이브러리가 버전 5.3.20에서 버전 5.3.27로 업데이트되었습니다.

294363158

회귀로 인해 Edge UI의 분석 및 모니터링 페이지의 드롭다운 메뉴에 일부 추가 측정기준이 표시되었습니다.

이 문제가 해결되었습니다.
297889765

Apigee-mirror로 생성된 아티팩트가 이제 올바른 소유권을 가집니다.

알려진 문제

알려진 문제의 전체 목록은 Private Cloud용 Edge의 알려진 문제를 참조하세요.

여러 패치 버전 적용

이 섹션에서는 이전 패치 출시 버전 이전 버전의 Private Cloud용 Edge 버전에서 업데이트하는 경우 여러 패치 버전을 적용하는 방법을 설명합니다.

각 패치 출시 버전에는 edge-management-server와 같은 프라이빗 클라우드용 Edge의 특정 구성요소에 대한 업데이트가 포함되어 있습니다. 여러 패치 버전을 적용하려면 현재 설치된 버전보다 나중에 패치 출시에 포함된 각 Edge 구성요소를 업데이트해야 합니다. 이러한 구성요소는 현재 버전 이후의 모든 버전에 대한 Edge for Private Cloud 출시 노트에서 해당 출시의 RPM 목록을 확인하여 찾을 수 있습니다. 모든 Private Cloud용 Edge 출시 노트에 대한 링크는 Apigee 출시 노트를 참조하세요.

참고: 각 구성요소는 패치 출시에 포함된 최신 버전의 구성요소의 RPM을 설치하여 한 번만 업데이트하면 됩니다. 해당 버전의 출시 노트에 있는 안내에 따라 구성요소를 업데이트하세요.

참고: 구성요소를 업그레이드하면 구성요소의 최신 패치 버전이 자동으로 설치됩니다. 최신 패치 버전이 아닌 패치 버전으로 업그레이드하려면 Apigee 미러를 사용하여 Apigee 저장소의 자체 tarball 사본을 유지관리하고 Apigee 설치에 이 미러를 사용해야 합니다. 자세한 내용은 로컬 Edge 저장소를 사용하여 Edge 버전 유지관리를 참조하세요.