4.50.00.11 - Private Cloud용 Edge 출시 노트

Apigee Edge 문서입니다.
Go to the Apigee X 문서로 이동합니다. info

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

업데이트 절차

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

  • edge-analytics-4.50.00-0.0.40046.noarch.rpm
  • apigee-sso-4.50.00-0.0.21034.noarch.rpm
  • apigee-tomcat-8.5.64-0.0.917.noarch.rpm
  • apigee-machinekey-1.1.0-0.0.20008.noarch.rpm
  • apigee-lib-4.50.00-0.0.1019.noarch.rpm
  • apigee-cassandra-2.1.22-0.0.2527.noarch.rpm
  • apigee-cassandra-client-2.1.22-0.0.2512.noarch.rpm
  • apigee-setup-4.50.00-0.0.1128.noarch.rpm
  • apigee-service-4.50.00-0.0.1428.noarch.rpm
  • apigee-configutil-4.50.00-0.0.613.noarch.rpm
  • edge-gateway-4.50.00-0.0.20140.noarch.rpm
  • edge-management-server-4.50.00-0.0.20140.noarch.rpm
  • edge-message-processor-4.50.00-0.0.20140.noarch.rpm
  • edge-postgres-server-4.50.00-0.0.20140.noarch.rpm
  • edge-qpid-server-4.50.00-0.0.20140.noarch.rpm
  • edge-router-4.50.00-0.0.20140.noarch.rpm
  • edge-mint-gateway-4.50.00-0.0.30233.noarch.rpm
  • edge-mint-management-server-4.50.00-0.0.30233.noarch.rpm
  • edge-mint-message-processor-4.50.00-0.0.30233.noarch.rpm
  • edge-management-ui-4.50.00-0.0.20020.noarch.rpm
  • edge-ui-4.50.00-0.0.20198.noarch.rpm
  • edge-management-ui-static-4.50.00-0.0.20033.noarch.rpm
  • apigee-validate-4.50.00-0.0.624.noarch.rpm
  • apigee-mtls-4.50.00-0.0.20224.noarch.rpm
  • apigee-adminapi-4.50.00-0.0.607.noarch.rpm

현재 설치된 RPM 버전을 확인하여 업데이트해야 하는지 확인하려면 다음을 입력합니다.

apigee-all version

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

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

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

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

    4. apigee-setup 유틸리티를 업데이트합니다. 
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    5. apigee-lib 유틸리티를 업데이트합니다. 
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-lib update
    6. source 명령어를 사용하여 apigee-service.sh 스크립트를 실행합니다. 
      source /etc/profile.d/apigee-service.sh
  2. 관리 서버에서 apigee-validate 유틸리티를 업데이트합니다. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  3. apigee-adminapi 유틸리티를 업데이트합니다. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  4. apigee-machinekey 유틸리티를 업데이트합니다. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-machinekey update
  5. apigee-config 유틸리티를 업데이트합니다. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-configutil update
  6. 모든 Cassandra 노드를 업데이트합니다. 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

    여기서 configFile은 프라이빗 클라우드용 Apigee Edge를 설치하는 데 사용한 구성 파일을 지정합니다. 예를 들어 /opt/silent.conf입니다.

  7. 모든 Edge 노드에서 Edge 프로세스의 update.sh 스크립트를 실행합니다. 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. 모든 노드에서 SSO의 update.sh 스크립트를 실행합니다. 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  9. 모든 노드에서 UI의 update.sh 스크립트를 실행합니다. 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  10. 새 Edge 환경을 사용하는 경우 다음 명령어를 실행합니다. 
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
  11. Apigee mTLS를 사용하는 경우 Apigee mTLS 업그레이드에 설명된 절차를 따릅니다. 자세한 내용은 Apigee mTLS 소개를 참조하세요.

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

이 출시 버전에서 지원되는 소프트웨어는 변경되지 않습니다.

지원 중단 및 서비스 종료

이 출시 버전에는 새로운 지원 중단 또는 서비스 종료가 없습니다.

새로운 기능

이 출시 버전에는 다음과 같은 새로운 기능이 도입되었습니다.

nodetool repair 도구 주변의 새 래퍼

래퍼는 Cassandra가 마운트된 디스크 공간에 대한 상태 점검을 실행하기 전에 nodetool repair를 실행합니다. 래퍼는 JMX 인증 및 JMX 관련 구성에 대한 SSL도 지원합니다.

LDAP 정책에서 <BaseDN> 요소의 동적 문자열 대체 지원이 추가되었습니다.

LDAP 정책의 <BaseDN> 요소 는 모든 데이터가 존재하는 LDAP의 기본 수준을 지정합니다. 이 출시 버전에서는 ref 속성이 요소에 추가되었습니다. 이 속성을 사용하여 <BaseDN> 값(예: apigee.baseDN)을 포함하는 흐름 변수를 지정할 수 있습니다. ref는 명시적 BaseDN 값보다 우선합니다. ref와 값을 모두 지정하면 ref가 우선순위를 갖습니다. ref가 런타임에 확인되지 않으면 값이 사용됩니다.

버그 수정

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

문제 ID 설명
197513151

기본 UI에서 일관되지 않은 jQuery 스크립트 경로가 수정되었습니다.
151852439

UI의 로깅이 잘못된 구성으로 인해 실패했습니다. .properties 파일

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

개발자 앱 페이지에서 개발자로 이동하는 중에 404 오류가 발생했습니다.

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

회사가 Edge UI에 표시되지 않았습니다.

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

Edge UI에서 자체 서명된 인증서 신뢰 문제가 발생했습니다.

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

console.log()로 인해 로깅이 과도하게 발생했습니다.

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

Cassandra 설정 스크립트에서 데이터 센터 이름이 정렬되는 방식에 사소한 버그가 있었습니다.

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

Apigee SSO가 응답에서 스택 트레이스를 잘못 반환했습니다.

이 문제가 해결되었습니다. 스택 트레이스는 계속 로깅됩니다.
79591934

apigee-validate가 이해하기 어려운 메시지와 함께 실패했습니다.

이 문제가 해결되었습니다. apigee-validate 스크립트의 오류 로깅이 개선되었습니다.
174732169

syslog 메시지가 잘못 삭제되었습니다.

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

게이트웨이 및 Machinekey 구성요소에서 기존 키가 삭제되었습니다.
197760258

권한 API의 실패로 인해 Edge UI와 게이트웨이 간에 호환성 문제가 발생했습니다.

외부 LDAP 인증이 사용 설정된 경우 발생한 이 문제가 해결되었습니다.
194485178

모든 HTTP 요청 및 응답 제한 속성에서 후행 및 선행 공백이 삭제되었습니다.
193918953

게이트웨이 구성요소에서 사용되지 않는 일부 구성이 삭제되었습니다.
112262604

Postgres 장애 조치가 실행되면 Mint 관리 서버를 업데이트해야 합니다.

Mint 관리 서버의 Postgres 연결 세부정보를 변경하기 위해 향상된 스크립트가 생성되었습니다. PostgreSQL 데이터베이스 장애 조치 처리 를 참조하세요.
197301743

대규모 SSL 핸드셰이크 메시지로 인해 Java 1.8.0_3XX에서 문제가 발생했습니다.

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

ip 명령어에 절대 경로가 접두사로 지정되지 않았습니다.

이 문제가 해결되었습니다. 이제 Apigee 스크립트가 명령어의 경로를 완전히 지정합니다.
171240470

Cassandra JMX 인증 또는 SSL이 사용 설정된 경우 관리 업데이트가 실패했습니다.

관리 서버에서 설정 또는 업데이트를 실행할 때 Cassandra JMX 인증 및 SSL 구성을 제공하는 기능이 추가되었습니다.
193564174

Edge UI 애널리틱스 대시보드에서 데이터를 가져올 수 없었습니다.

이름에 마침표가 있는 환경에서 애널리틱스 쿼리가 실패하는 버그가 수정되었습니다.
167960487

측정기준 텍스트 내의 예약어 AND/OR로 인해 애널리틱스 보고서가 실패했습니다.

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

router.properties의 IP 주소 목록에 있는 추가 공백으로 인해 라우터가 시작되지 않았습니다.

이 문제가 해결되었습니다. 이제 추가 공백이 삭제되었습니다.
184573211

Java 관리 확장 프로그램 (JMX)은 더 이상 Apigee SSO 모듈에 기본적으로 사용 설정되지 않습니다.

해결된 보안 문제

다음은 이 출시 버전에서 해결된 알려진 보안 문제의 목록입니다. 이러한 문제를 방지하려면 최신 버전의 Edge 프라이빗 클라우드를 설치하세요.

문제 ID 설명
해당 사항 없음

구성 파일 델타 변경사항의 일반 로깅으로 인해 프라이빗 클라우드용 Edge에 비밀번호가 로깅되었습니다. 다음과 같이 구성 변경사항의 로깅을 방지할 수 있습니다.

  • Edge 구성요소가 이미 설치되어 있는 경우 다음 단계 중 하나를 실행합니다.
    • LOGGER_PRINT_CONFIG_DELTA=false를 환경 변수로 설정합니다. 이렇게 하면 해당 노드의 모든 구성요소에 대한 구성 델타 로깅이 중지됩니다.
    • 특정 구성요소의 구성 델타 로깅을 중지하려면 해당 구성요소의 고객별 구성 파일에 logger.print.config.delta=false을 추가합니다. 이렇게 하면 해당 구성요소의 구성 변경사항 로깅이 중지됩니다. 자세한 내용은 Edge 구성 방법을 참조하세요.
  • Edge 구성요소를 설치하는 경우 silent.conf 파일에 다음 항목을 추가하여 구성 변경사항의 로깅을 방지할 수 있습니다. 
    CONFIG_DELTA_LOG=n

    이렇게 하면 구성요소가 구성 변경사항을 로깅하지 않도록 구성됩니다.
해당 사항 없음 플랫폼에 저장된 비밀번호 및 관련 데이터의 보안이 개선되었습니다.
CVE-2015-9251 jQuery에서 dataType 옵션 없이 교차 도메인 Ajax 요청이 실행될 때 교차 사이트 스크립팅 (XSS)이 수정됩니다.
해당 사항 없음 SAML 어설션 재전송 공격에 대한 추가 보호가 추가되었습니다.

알려진 문제

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