이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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

참고: 시스템 수준 진단 및 데이터 수집 도구인 sosreport가 이제 기본적으로 설치됩니다. Apigee 지원 담당자는 sosreport를 사용하여 발생할 수 있는 문제를 해결할 수 있습니다. 이 도구는 실행되지 않는 한 데이터를 수집하지 않습니다.

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

apigee-all version

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

모든 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
```
  여기서 uName 및 pWord는 Apigee에서 받은 사용자 이름과 비밀번호입니다. pWord를 생략하면 입력하라는 메시지가 표시됩니다.
4. source 명령어를 사용하여 apigee-service.sh 스크립트를 실행합니다.
```
source /etc/profile.d/apigee-service.sh
```
모든 Edge 노드에서 Edge 프로세스의 update.sh 스크립트를 실행합니다.
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
모든 노드에서 SSO용 update.sh 스크립트를 실행합니다.

/opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile

모든 UI 노드에서 UI의 update.sh 스크립트를 실행합니다.
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
새로운 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

지원되는 소프트웨어의 전체 목록은 프라이빗 클라우드용 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_limit를 true로 설정하세요.

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

버그 수정

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

문제 ID	설명
290242749	DataMasking에서 `ServiceCallout.response` 변수가 사용되면 정책이 트레이스에 표시되지 않았습니다. 이 문제가 해결되었습니다.
260397807	이메일 템플릿의 문제로 인해 이메일에 다중 바이트 문자가 전송되지 않았습니다. 이 문제가 해결되었습니다.
234544436	새로운 Edge UI에서 조직을 변경할 때 왼쪽 메뉴가 사라지는 문제가 있었습니다. 이 문제가 해결되었습니다.
293268203	관리 서버 노드에서 분석 종속 항목이 자동으로 업그레이드되지 않았습니다. 이 문제가 해결되었습니다.
261616264	업그레이드 프로세스 중에 postgresql이 삭제되지 않도록 부트스트랩 검사를 추가했습니다.
279065586	OAuth2의 리디렉션 URL에서 사이트 간 요청 위조 (CSRF) 취약점을 방지하기 위해 상태 매개변수의 엔트로피가 개선되어 예측할 수 없게 되었습니다.
283310836	대용량 XML을 파싱할 때의 오류 메시지가 개선되었습니다.
245936798	조직 및 환경 이름 관련 문제로 인해 Postgresql <code<create< code="" dir="ltr" translate="no"> query가 실패했습니다.</code<create<> 긴 조직 및 환경 이름의 postgres 색인 이름 충돌을 더 효과적으로 처리하여 이 문제가 해결되었습니다.
293733533	Edge 게이트웨이 구성요소의 Spring 서드 파티 라이브러리가 버전 5.3.20에서 버전 5.3.27로 업데이트되었습니다.
294363158	회귀로 인해 Edge UI의 분석 및 모니터링 페이지의 드롭다운 메뉴에 일부 추가 측정기준이 표시되었습니다. 이 문제가 해결되었습니다.
297889765	이제 apigee-mirror에서 생성된 아티팩트에 올바른 소유권이 있습니다.
294989027	특정 통계 API의 성능이 개선되었습니다.

알려진 문제

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

여러 패치 버전 적용

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

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

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

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