4.53.00.06 - 프라이빗 클라우드용 Edge 출시 노트

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

2025년 12월 11일에 Apigee Edge for Private Cloud의 새 버전이 출시되었습니다.

업데이트 절차

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

이 버전을 업데이트하면 아래에 나열된 구성요소가 업데이트됩니다.

  • edge-gateway-4.53.00-0.0.60366.noarch.rpm
  • edge-management-server-4.53.00-0.0.60366.noarch.rpm
  • edge-message-processor-4.53.00-0.0.60366.noarch.rpm
  • edge-postgres-server-4.53.00-0.0.60366.noarch.rpm
  • edge-qpid-server-4.53.00-0.0.60366.noarch.rpm
  • edge-router-4.53.00-0.0.60366.noarch.rpm
  • apigee-openldap-2.4-0.0.2528.noarch.rpm
  • apigee-mirror-4.53.00-0.0.1044.noarch.rpm
  • apigee-tomcat-9.0.111-0.0.962.noarch.rpm
  • apigee-sso-4.53.00-0.0.21610.noarch.rpm
  • edge-uapim-4.53.00-0.0.60366.noarch.rpm
  • edge-uapim-connector-4.53.00-0.0.60366.noarch.rpm

현재 설치된 RPM 버전을 확인하여 업데이트해야 하는지 확인할 수 있습니다.

apigee-all version

설치를 업데이트하려면 Edge 노드에서 다음 절차를 실행하세요.

  1. 모든 Edge 노드에서 다음을 실행합니다.

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

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

    4. source 명령어를 사용하여 apigee-service.sh 스크립트를 실행합니다. 
      source /etc/profile.d/apigee-service.sh
    5. apigee-setup 유틸리티를 업데이트합니다. 
      apigee-service apigee-setup update
  2. 모든 Edge 노드에서 edge 프로세스 (수익 창출 포함)에 대해 update.sh 스크립트를 실행합니다. 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  3. 모든 LDAP 노드에서 update.sh 스크립트를 실행합니다. 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. SSO를 사용하는 경우 다음 명령어를 실행합니다. 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  5. apigee-mirror를 사용하는 경우 다음 명령어를 실행합니다. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update

새로운 기능

이 섹션에는 이번 출시의 새로운 기능이 나열되어 있습니다.

문제 ID 설명
426383877 Northbound (클라이언트에서 Apigee로) 및 Southbound (Apigee에서 타겟으로) 통신 모두에 대해 ECDSA 형식 키와 인증서 지원이 추가되었습니다.

버그 수정

이 섹션에는 이 출시에서 수정된 프라이빗 클라우드 버그가 나열되어 있습니다.

문제 ID 설명
445563031 Cassandra와 애플리케이션 구성요소 (관리 서버, 메시지 프로세서 또는 라우터) 간의 특정 유형의 상호작용으로 인해 발생하는 데이터 저장소 오류가 수정되었습니다.
412696630 부트스트랩 중에 비공개 키가 로드되지 않는 메시지 프로세서 및 라우터의 버그가 수정되었습니다.
448566858 메시지 프로세서에서 키 저장소와 관련된 불필요한 로그가 삭제되었습니다.
442733857 암호화된 KeyValueMap의 성능이 개선되었습니다. 특히 항목이 많은 KVM의 성능이 개선되었습니다.

해결된 보안 문제

문제 ID 설명
463848991 Tomcat의 CVE-2025-61795 해결

프라이빗 클라우드용 Edge API 허브 통합

이번 출시에서는 프라이빗 클라우드 통합을 위한 Apigee API 허브 커넥터 지원이 계속 제공되므로 조직에서 API 메타데이터와 런타임 분석을 모두 Google Cloud API 허브에 동기화할 수 있습니다. 이 통합에는 새로운 Apigee API 허브 커넥터 바이너리와 런타임 데이터를 네트워크 파일 시스템(NFS)으로 내보내는 메시지 프로세서의 개선사항이 포함되어 있습니다. 프라이빗 클라우드용 API 허브 커넥터는 이 데이터를 사용하고 API 허브에 게시합니다. 버그 수정이나 기존 통합 동작의 변경사항은 없습니다.

자세한 내용은 프라이빗 클라우드용 Edge API 허브 통합을 참고하세요.

개인 식별 정보 (PII) 마스킹

이 기능을 사용하면 API 프록시 및 공유 흐름 번들 내의 민감한 정보를 API 허브에 동기화하기 전에 마스킹하여 데이터 개인 정보 보호 및 규정 준수를 보장할 수 있습니다.

  • 기본 마스크: 커넥터는 정책 구성에서 알려진 개인 식별 정보 소스를 마스킹하기 위해 기본 제공 XPath 표현식 목록 (기본 마스크)을 자동으로 적용합니다 (예: 하드코딩된 기본 인증 비밀번호, JWT/JWS 정책의 비공개 키).
  • 맞춤 마스크: /opt/apigee/customer/application/uapim-connector.properties 파일에서 conf_uapim_connector.uapim.mask.xpaths 속성을 설정하여 추가 맞춤 마스크를 구성할 수 있으므로 고객별 민감한 필드를 타겟팅할 수 있습니다.

조직 조정 (백필)

이제 커넥터는 기존 Apigee 조직의 전체 API 메타데이터 세트를 API 허브에 조정 (또는 백필)하기 위한 정의된 프로세스를 제공합니다.

  • 프로세스: 조직을 커넥터의 구성에서 일시적으로 선택 해제 (runtimeDataPubsub 및 metadataPubsub 속성 값 지우기)한 다음 즉시 다시 선택 (값 복원)하여 조정이 이루어집니다.
  • 기능: 이 작업은 커넥터가 지정된 조직의 모든 메타데이터를 완전히 가져오고 완전히 다시 동기화하도록 강제하여 잠재적인 데이터 불일치를 해결합니다.

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

  • Amazon Linux 2023(7,8) 및 RHEL-9.6 지원이 추가되었습니다.
  • Apache Tomcat 9.0.111 지원이 추가되었습니다.

지원되는 소프트웨어의 전체 목록은 프라이빗 클라우드용 Edge 지원 소프트웨어를 참고하세요.

지원 중단 및 지원 종료

이번 출시에는 새로운 지원 중단 또는 폐지가 없습니다.

알려진 문제

알려진 문제의 전체 목록은 프라이빗 클라우드용 Edge에서 알려진 문제를 참고하세요.

여러 패치 버전 적용

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

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

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

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