4.19.01.03 - Private Cloud용 Edge 출시 노트

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

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

업데이트 절차

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

  1. 모든 Edge 노드에서 다음 단계를 수행합니다.

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

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

    4. apigee-setup 유틸리티를 업데이트합니다.
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    5. source 명령어를 사용하여 apigee-service.sh 스크립트를 실행합니다.
      source /etc/profile.d/apigee-service.sh
  2. apigee validate 유틸리티를 업데이트합니다.
    sudo /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  3. /opt/apigee/apigee-validate/bundles 디렉터리의 smartdocs.zip에서 새 SmartDocs 프록시를 가져오고 새 버전으로 배포합니다. 새 프록시는 현재 SmartDocs 가 구성된 조직으로 가져와야 합니다. 필요한 경우 프록시를 새 버전으로 배포하면 롤백이 더 쉬워집니다.

    참고: 배포하기 전에 새 프록시의 <VirtualHost>가 현재 환경에 설정된 <VirtualHost> 구성과 일치하는지 확인합니다. 일치하지 않으면 배포하기 전에 프록시를 수정합니다.

  4. Edge UI에서 KVM을 만들고 업데이트합니다. 아래 그림과 같이 'smartdocs_whitelist'라는 이름으로 지정합니다. KVM은 현재 SmartDocs 프록시가 배포된 조직 및 환경에서 생성되어야 합니다.

    참고: 암호화됨 체크박스가 선택되어 있지 않은지 확인합니다.

    • 값이 'YES'인 'is_whitelist_configured'라는 키를 추가합니다.
    • SmartDocs에서 호출되는 공백으로 구분된 호스트 이름 또는 IP 주소인 값을 갖는 'allowed_hosts'라는 두 번째 키를 추가합니다. 'allowed_hosts' 값에는 SmartDocs에 추가된 OpenAPI 사양에 포함된 모든 호스트가 포함되어야 합니다. 예를 들어 mocktarget.apigee.net을 호출하는 OpenAPI 사양이 있는 경우 'allowed_hosts' 값에 mocktarget.apigee.net을 추가해야 합니다. 호스트가 KVM에 포함되지 않은 경우 SmartDocs 응답은 콘텐츠 페이로드가 Bad Request-Hostname not permitted400 Bad Request가 됩니다.
    KVM 생성 인터페이스 참고: 이 KVM을 추가하고 구성하지 않으면 프록시가 허용 목록을 적용하지 않습니다. 이로 인해 호스트 및 IP 주소에 무단으로 액세스할 수 있습니다. 'allowed_hosts' 값에는 SmartDocs로 문서화된 API 엔드포인트의 호스트 이름과 IP 주소만 포함되어야 합니다.

지원되는 소프트웨어

없음

지원 중단 및 서비스 종료

없음

수정된 버그

다음 표에는 이번 출시 버전에서 수정된 버그가 나와 있습니다.

문제 ID 설명
145340106

Apigee SmartDocs API 취약점

보안 취약점을 해결하기 위해 Apigee SmartDocs 프록시를 업데이트했습니다. 자세한 내용과 필요한 단계는 업데이트 절차를 참고하세요.