4.19.01.03 - Private Cloud용 Edge 출시 노트

Apigee Edge 문서입니다.
Apigee X 문서로 이동하세요.
정보

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

업데이트 절차

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

  1. 모든 에지 노드에서:

    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에서 아래 그림과 같이 'smartdocs_whitelist'라는 이름의 KVM을 만들고 업데이트합니다. KVM은 SmartDocs 프록시가 현재 배포된 조직 및 환경에서 만들어야 합니다.

    참고: 암호화됨 체크박스가 선택 해제되어 있어야 합니다.

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

지원되는 소프트웨어

없음

지원 중단 및 사용 중지

없음

수정된 버그

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

문제 ID 설명
145340106

Apigee SmartDocs API 취약점

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