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

<ph type="x-smartling-placeholder"></ph> 현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서.
정보

2015년 9월 8일 화요일, 비공개용 Apigee Edge의 주요 기능 출시가 출시되었습니다. 있습니다.

<ph type="x-smartling-placeholder">

이전 Private Cloud용 Edge 분기별 출시 버전 (4.15.04.00) 이후 출시되었으며 이번 분기별 버전에 포함된 버전:

업그레이드할 수 있는 Edge 버전 4.15.07.00

Edge의 현재 버전에 따라 다음 중 하나를 수행할 수 있습니다.

  • 4.15.07.00으로 직접 업그레이드
  • 점진적 업그레이드(현재 버전을 다른 버전으로 업그레이드해야 함) 4.15.07.00으로 업그레이드해야 합니다

자세한 내용은 다음 버전으로 업그레이드할 수 있는 Private Cloud용 Edge 버전을 참조하세요. 4.15.07.00.

버전 4.15.01.x 또는 이전 버전에서 업그레이드하기 전에

업그레이드하기 전에 모든 Cassandra 노드에서 Cassandra SSTable을 업그레이드했는지 확인하세요.
  1. Cassandra SSTable 버전을 확인합니다. <ph type="x-smartling-placeholder">
      </ph>
    1. 디렉터리를 /&lt;install-root&gt;/apigee4/data/cassandra/data로 변경합니다.
    2. 찾기 명령어를 실행합니다.
      &gt; 찾습니다 . -name *-ic-*
      Cassandra 1 .2 SSTable을 실행하는 경우 결과는.db 파일 집합을 반환합니다.
    3. 다음 찾기 명령어를 실행합니다.
      &gt; 찾습니다 . -name *-HF-*
      결과는 비어 있어야 합니다. 즉, hf 형식의 .db 파일이 없어야 합니다. 목록에 파일이 없으면 hf 형식인 경우 4.15.07.00으로 업그레이드할 수 있습니다

      hf 형식은 Cassandra 1.0 SSTables에서 지원됩니다. hf 형식의 *.db 파일이 있는 경우 SSTable을 업그레이드하면 됩니다.
  2. hf 형식의 *.db 파일을 찾으면 SSTable을 업그레이드합니다. 모든 Cassandra를 업그레이드할 때까지 모든 Cassandra 노드에서 다음 명령어를 실행하여 노드:
    &gt; /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost Upgradestables -a
  3. 1단계를 반복하여 모든 *.db 파일이 Cassandra 1.2에 대한 ic 형식인지 확인합니다. 있습니다.
  4. Edge 설치의 모든 Cassandra 노드에서 1~3단계를 반복합니다.
  5. Edge 4.15.07.00으로 업그레이드합니다.
  6. 4.15.07.00 업그레이드 후 *.db 파일을 확인하여 모두 업그레이드되었는지 확인합니다. C* 2.0 스타일 안정화로 변경합니다.
    &gt; cd /&lt;install-root&gt;/apigee4/data/cassandra/data
    &gt; 찾습니다 . -이름 *-jb-*

    Cassandra 2 .0을 실행 중인 경우 이 명령어는.db 파일 집합을 반환합니다.

새로운 기능 및 개선사항

다음은 이번 버전의 새로운 기능과 개선사항입니다.

설치 및 업그레이드

선택적 구성요소 업그레이드 및 제거

이제 apigee-upgrade.sh 및 apigee-uninstall.sh 스크립트를 사용하면 Edge 구성요소를 선택할 수 있습니다. 업그레이드 또는 제거하세요. 이전에는 노드의 모든 구성요소를 업그레이드하거나 제거했습니다. (OPDK-1377, OPDK-1175)

업그레이드 롤백

업그레이드 중에 apigee-upgrade.sh가 실패하면 이제 apigee-rollback.sh를 사용할 수 있습니다. 스크립트를 사용하여 업그레이드를 롤백합니다. 업그레이드 문제를 해결한 후 업그레이드를 다시 시도할 수 있습니다. (OPDK-1275)

단축된 설치 프로그램 스크립트 옵션

설치 스크립트는 더 이상 --help와 같은 긴 형식의 옵션을 사용하지 않습니다. 이제는 -h와 같은 단일 문자 옵션을 사용합니다. (OPDK-1356)

SmartDocs 설치

setup-smartdocs.sh 스크립트로 SmartDocs를 설치하면 가상 호스트를 통해 조직, 환경, 가상 호스트를 통해 조직, 환경, 가상 호스트를 통해 예상 위치 이전에는 이러한 값이 스크립트에 하드 코딩되었습니다. (OPDK-1310)

프롬프트 없이 update-cass-pwd-in-config.sh 실행

update-cass-pwd-in-config.sh 스크립트는 ENABLE_CASS_AUTH, CASS_USERNAME, CASS_PASSWORD 환경 변수입니다. (OPDK-1309)

에지 플랫폼

다음은 이 버전에 포함된 새로운 Edge 플랫폼 기능입니다.

Edge 프라이빗 클라우드에서 지원되는 OpenJDK 1.7

이 Edge 버전은 Oracle JDK 1.7 및 OpenJDK 7을 지원하고 JDK 1.6에 대한 지원을 삭제했습니다. (OPDK-1187)

OS 지원

프라이빗 클라우드용 Apigee Edge가 Red Hat을 포함하도록 운영체제 지원을 확장했습니다. 엔터프라이즈 Linux 6.6 이상 7.0 (64비트), CentOS 6.5, 6.6 및 7.0 (64비트) 및 Oracle Linux 6.5.

OPDK 15.07에 포함된 Cassandra 2.0.15

이 출시에서는 Cassandra 2.0.15를 설치합니다. 이전 버전을 업그레이드하는 경우 업데이트됩니다 (OPDK-1197)

OAuth 토큰 해싱을 위한 SHA2 지원

데이터베이스 보안 위반 시 OAuth 토큰을 더 효과적으로 보호하기 위해 Edge는 SHA2를 지원합니다. (SHA1 외에) OAuth 토큰을 해싱하기 위한 알고리즘입니다. 새로운 조직 수준 사용 속성을 사용하면 새 토큰에 해싱을 사용 설정 및 구성하고 기존 해싱을 유지할 수 있습니다. 이 새로운 기능 이전에 존재했던 토큰 이전에는 프라이빗 클라우드용 Edge에서 해시.oauth.tokens.enabled라는 이름의 속성을 관리 서버 및 메시지 프로세서)에서 OAuth 토큰의 자동 SHA1 해싱을 사용 설정했습니다. 이 속성이 지원 중단되었습니다.

이전에 hash.oauth.tokens.enabled 속성을 사용하여 SHA1 해싱을 사용 설정한 경우 이 출시의 업그레이드 스크립트가 새 조직 수준 속성을 자동으로 생성합니다. 받는사람 업그레이드 후 확인하려면 이 API를 사용하여 시스템 관리자로 GET을 수행합니다. https://{host}:{port}/v1/o/{your_org}.

  • 조직에서 새 속성으로 토큰 해싱을 사용 설정하는 방법에 대한 자세한 내용은 다음을 참조하세요. "데이터베이스의 토큰 해싱" 액세스 토큰 요청 주제에 대해 살펴보겠습니다.
  • 기존 토큰 일괄 해싱에 대한 자세한 내용은 Private Cloud의 Edge를 참조하세요. 운영 가이드를 참고하세요. (APIRT-1389)

로그 파일의 플랫 디렉터리 구조

로그 파일을 플랫 디렉터리 구조에 저장하도록 Edge를 구성할 수 있습니다. message-logging.properties에서 enable.flat.directory.structure 속성을 true로 설정 파일에서 참조됩니다. 자세한 내용은 메시지 로깅 정책을 참고하세요. (APIRT-1394)

환경 캐시 성능

인메모리 캐시 관리 및 사용률 개선을 위해 '메모리의 최대 요소' 환경 캐시 리소스에 대한 설정은 지원 중단되었습니다. 디코더에 존재하는 기본 캐시를 포함한 모든 캐시 리소스는 있습니다. 기본적으로 지정된 메시지 프로세서에서 메모리 내 캐싱에 할당된 총 메모리입니다. 메시지의 캐시 속성 설정에 따라 사용 가능한 총 메모리의 40% 프로세서 캐시.속성 파일을 제출해야 합니다. 메모리 내 캐시에서 요소가 제거됩니다. 단, 캐시 메모리가 부족하거나 요소가 만료됩니다.

'메모리의 최대 요소 개수'를 사용하는 이전 동작으로 되돌리기 속성 overrideMaxElementsInCacheResource=false 속성을 cache.properties 파일에서 찾을 수 있습니다. (APIRT-1140)


API 서비스

다음은 이번 버전에 포함된 새로운 API 서비스 기능입니다.

기본값으로 새 프록시 편집기

새 API 프록시 편집기는 관리 UI에서 기본적으로 사용 설정됩니다. 새로운 편집기에는 보다 포괄적인 조건부 흐름 뷰 등 다양한 사용성 개선사항을 엔드포인트, 개발 페이지의 모든 구성, 보다 직관적으로 조건부 흐름, 엔드포인트 및 정책, 작은 스니펫이 아닌 더 완전한 XML 뷰, 파일 이름 및 텍스트 등을 크롤링하는 검색 기능을 제공합니다. (MGMT-2279)

새로운 OAuth v2.0 정보 삭제 정책

새로운 'OAuth v2.0 정보 삭제' 정책을 통해 OAuth v2 액세스 토큰 및 승인을 삭제할 수 있습니다. 있습니다. 이 정책은 이전에 관리 API에서 제공했던 기능을 대체합니다. 자세한 내용은 자세한 내용은 삭제 OAuthV2 정보 정책의 적용을 받습니다. (MGMT-2257)

새로운 OAuth v1.0 정보 삭제 정책

새로운 'OAuth v1.0 정보 삭제' 정책을 사용하면 OAuth v1.0 요청 토큰을 삭제하고 토큰 및 인증자 코드가 포함됩니다. 이 정책은 '게시자'가 이전에 제공한 기능을 대체합니다. 관리 API를 제공합니다. 자세한 내용은 OAuth V1 정보 삭제 정책을 참고하세요. (APIRT-1351)

액세스 제어 정책

IP 주소를 보다 세밀하게 평가할 수 있도록 액세스 제어 정책이 개선되었습니다. X-FORWARDED-FOR HTTP 헤더.

헤더에서 다중 IP 주소 확인을 사용하도록 설정한 상태에서 feature.enableMultipleXForwardCheckForACL) 정책의 새로운 <ValidateBasedOn> 요소를 사용하면 헤더의 첫 번째 IP, 마지막 IP 또는 모든 IP입니다. 자세한 내용은 액세스 제어 정책을 참조하세요.

항목 액세스 정책의 새로운 항목

액세스 항목 정책은 consumerkey-scopes, Authorizationcode, requesttoken 및 verifier가 있습니다. 자세한 내용은 액세스 항목 정책을 참고하세요.

통계 수집기 정책: 통계 이름을 소문자로 자동 변환

API 프록시 편집기에서 맞춤 애널리틱스 컬렉션을 만들 때 (개발 페이지 > 도구) &gt; 맞춤 애널리틱스 컬렉션), 수집기 변수 (통계) '이름' 소문자여야 합니다. 이름을 대문자로 입력하면 도구에서 통계 이름을 자동으로 변환합니다. 통계 수집기 정책에서 소문자로 변경합니다. (MGMT-740)

API 프록시 편집기에서 기존 Trace 삭제

API 프록시 편집기의 최신 버전의 Trace 기능이 베타 버전에서 정식 버전으로 제공됩니다. '기존 트레이스' 액세스 'trace의 기존 버전에 액세스'를 링크를 더 이상 사용할 수 없습니다.

관리 UI 도움말 메뉴에서의 Apigee 커뮤니티 액세스

관리 UI 도움말 메뉴에서 Apigee 커뮤니티에 액세스할 수 있습니다.

관리 UI의 오류 메시지

다음은 관리 UI의 오류 메시지 개선사항입니다.

  • 전체의 UI에 모든 오류 메시지를 그룹화하고 표시하는 데 사용되는 관리 UI 로그인 세션을 종료할 수 있습니다. 이 업데이트를 통해 오류 메시지가 사용자가 발생했던 페이지를 벗어날 때 자동으로 삭제됩니다. (MGMT-2254)
  • 관리 UI에서 더 이상 중복 오류 메시지를 억제하지 않습니다. (MGMT-2242)

UI 성능 및 오류 개선

페이지 표시 등 관리 UI의 여러 영역이 전반적으로 개선되었습니다. 성능 및 오류 메시지 정리가 가능합니다.

관리 UI (관리 > 조직 사용자)의 조직 사용자 페이지에서 이름이 하이퍼링크로 연결되어 역할 페이지로 빠르게 이동할 수 있습니다. (MGMT-1055)

메시지 흐름의 새 대상 변수

메시지 흐름의 새 변수는 대상 엔드포인트에 대한 보다 완전한 URL 정보를 제공하며 대상 서버:

  • TargetEndpoint: request.urltarget.basepath.with.query를 대체합니다.
  • TargetServer: loadbalancing.targetservertargetserver.name를 대체합니다. 또한 target.basepath<Path> 요소는 TargetEndpoint의 HTTPTargetConnection <LoadBalancer> 요소를 사용합니다.

서버 이름 표시 (SNI) 지원

Edge는 사우스바운드 (메시지 프로세서에서 대상까지) 서버 이름 표시의 사용을 지원합니다. 엔드포인트)에서 시작됩니다. SNI를 사용하려면 Apigee 지원팀에 문의하세요.

자바 1.7이 필요합니다.

TLS/SSL의 확장 기능인 SNI를 사용하면 여러 HTTPS 타겟을 동일하게 제공할 수 있습니다. 모든 대상이 동일한 인증서를 사용할 필요 없이 IP 주소 및 포트에서 식별할 수 있습니다.

에지별 구성이 필요하지 않습니다. 환경이 southbound로 구성된 경우 SNI (Edge 클라우드는 기본값)이며 Edge에서 지원합니다.

Edge는 요청 URL에서 호스트 이름을 자동으로 추출하고 SSL 핸드셰이크 요청에 추가합니다. 예를 들어 타겟 호스트가 https://example.com/request/path이면 Edge는 다음과 같이 server_name 확장 프로그램을 추가합니다. 아래:

SNI에 관한 자세한 내용은 http://en.wikipedia.org/wiki/Server_Name_Indication을 참고하세요.

"Signature Algorithm" SSL 인증서 세부정보의

새로운 'Signature Algorithm' 필드가 SSL 인증서 세부정보에 추가되었으며 관리 UI (관리 > SSL 인증서)와 관리 API (가져오기 키 저장소 또는 트러스트 저장소의 인증서 세부정보). 필드에 'sha1WithRSAEncryption'이 표시됩니다. 를 생성하는 데 사용된 해싱 알고리즘의 유형에 따라 'sha256WithRSAEncryption'을 사용할 수 있습니다. 있습니다.

만료가 임박한 SSL 인증서 표시

관리 UI (관리 > SSL 인증서)의 SSL 인증서 페이지에 SSL 인증서는 새 만료 드롭다운 필드를 선택합니다.

위협 방지 오류 구성

기본적으로 Edge에서 HTTP 500 내부 서버 오류 상태 코드와 ExecutionFailed가 표시됩니다. 메시지가 JSON 또는 XML 위협 보호 정책을 통과하지 못하면 오류 발생 새로운 조직 수준 속성으로 이 오류 동작을 변경할 수 있습니다. 조직 설정 시 features.isPolicyHttpStatusEnabled 속성을 true로 설정하면 다음과 같이 동작합니다.

  • 요청: 요청 흐름에 연결된 위협 방지 정책 사용, 잘못된 메시지 400 상태 코드와 함께 해당 정책 오류 메시지가 반환됩니다.
  • 응답: 모든 응답 흐름에 연결된 위협 방지 정책이 있으면 잘못된 메시지가 여전히 500 상태 코드를 반환하고 이에 상응하는 정책 오류 메시지 중 하나가 발생합니다. (ExecutionFailed가 아니라)입니다.

Cloud 고객은 Apigee 지원팀에 문의하여 조직 속성을 설정해야 합니다. 이 기능은 Private Cloud 분기별 출시

엔드포인트, 프록시, 기타 항목의 스키마 업데이트

TargetEndpoint, ProxyEndpoint, APIProxy 등을 예로 들 수 있습니다. https://github.com/apigee/api-platform-samples/tree/master/schemas를 참조하세요. (APIRT-1249)


개발자 서비스

다음은 이 버전에 포함된 개발자 서비스의 새로운 기능입니다.

SmartDocs 정식 버전

SmartDocs가 베타 버전에서 일반 안정화 버전으로 전환될 예정입니다. 업데이트 및 새로운 기능 포함:

  • Swagger 2.0 지원(파일 또는 URL별 가져오기 포함, 커스텀 명명된 보안 객체를 생성할 수 있습니다
  • SmartDocs를 생성하는 템플릿의 시각적 디자인이 개선되었습니다.
  • 콘텐츠를 통해 사용할 수 있는 개발자 포털의 사용성 및 워크플로 개선사항 &gt; Drupal의 SmartDocs 메뉴
  • '커스텀 토큰'으로 알려진 항목 인증이 'API 키'로 변경되었습니다.
  • 인증 '보안' 객체 버전 관리입니다
  • 템플릿 수준의 클라이언트 인증 구성입니다. 새 버전이 더 이상 재설정되지 않음 사전 구성된 SmartDocs 클라이언트 사용자 인증 정보를 확인할 수 있습니다.

기능에 대한 자세한 설명은 이 블로그를 참조하세요. 게시물을 참고하세요.

SmartDocs 문서는 SmartDocs를 사용하여 문서 작성을 참조하세요. API를 참고하세요.

관리 UI에 표시되는 개발자 앱 이름

Edge의 개발자 앱에는 변경되지 않는 내부 이름과 변경할 수 있습니다 관리 UI의 개발자 앱 페이지 (게시 > 개발자 앱 > 앱 이름), 앱 내부 '이름' '표시 이름'과 함께 표시되므로 문제 해결 및 API 관리를 위해 내부 이름으로 앱을 시각적으로 식별할 수 있습니다.


분석 서비스

다음은 이번 버전에 포함된 새로운 분석 서비스 기능입니다.

보존된 데이터 시간 제한

관리 UI 또는 API로 분석 보고서를 생성할 때 6개월이 지난 데이터는 기본적으로 액세스할 수 없습니다. 6개월보다 오래된 데이터에 액세스하려는 경우 개월마다 Apigee 지원팀에 문의하세요.

기존 버전의 맞춤 보고서가 관리 UI에서 삭제됩니다.

맞춤 분석 보고서의 기존 버전(선택사항)은 다음 국가에서 더 이상 제공되지 않습니다. 관리 UI를 제공합니다.

개발자 참여 위젯 성능

기본 애널리틱스 대시보드 (개발자 참여 섹션)의 유입경로 위젯 개선 더 나은 성능을 제공할 수 있습니다


수익 창출

다음은 이번 버전에 포함된 새로운 수익 창출 기능입니다.

요금제 이메일 알림

새로운 요금제 이메일 알림 유형을 통해 개발자는 일정 등급에 도달할 때 구매한 볼륨 밴드 또는 번들 요금제의 거래 또는 달러 한도 대상 설정 알림 템플릿을 사용하여 알림 사용

정기 수수료와 집계 기준 기간 동기화

요금제에서 두 개의 서로 다른 기간이 적용되었을 수 있습니다.

  • 요금제의 '요금' 탭에서 구성된 반복 수수료 기간으로 개발자에게 반복 수수료가 청구되었습니다.
  • 대량 구매 요금제 또는 번들 요금제의 요율표에 정의된 집계 기준 기간으로 개발자가 번들 사용이 재설정된 시점을 파악함

이제 이 두 기간이 동기화됩니다. 0이 아닌 반복 수수료와 볼륨 밴드가 모두 있는 경우 또는 번들 요율표가 요금제에 있는 경우 반복 수수료 기간이 둘 다에 사용됩니다. 예를 들어 월별 반복 수수료가 있는 경우 요율표 번들도 매월 재설정됩니다 (기본적으로 월 초).

반복 수수료가 없으면 있습니다. 예를 들어 개발자가 매월 19일에 요율표를 사용하기 시작했고 집계 기준은 매월이며 19일 이후에 번들 사용이 재설정됩니다.

집계 기준이 지원 중단되며 향후 수익 창출에서 삭제될 예정입니다. 있습니다. 자세한 내용은 요율표 요금제 지정을 참조하세요. 자세히 알아보세요.

요약 수익 보고서의 맞춤 속성

트랜잭션 기록 정책을 사용하면 필요에 따라 이제 요약 수익에 이러한 맞춤 거래 속성을 포함할 수 있습니다. 있습니다. 조직에 MINT.SUMMARY_CUSTOM_ATTRIBUTES 속성을 추가하면 보고서에서 사용할 데이터베이스 표에 추가되는 맞춤 속성을 지정합니다.

프라이빗 클라우드용 Apigee Edge 고객은 다음 API 호출로 플래그를 설정할 수 있습니다. 시스템 관리자 사용자 인증 정보

curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isMonetizationEnabled">true</Property>
        <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

API 호출의 맞춤 속성 배열은 URL로 인코딩됩니다.


SmartDocs 업그레이드 프로세스

베타 기간 동안 SmartDocs를 이미 사용하고 있다면 정식 버전으로 출시된 버전에서는 개발자의 SmartDocs를 업그레이드해야 합니다 있습니다.

개발자 포털에 이미 게시된 SmartDocs 페이지의 경우 계속해서 단, 기존 앱의 변경사항을 수정하거나 게시하기 전에 업데이트 절차를 새 페이지를 만들 수 있습니다

개발자 포털 내에서 SmartDocs를 렌더링하고 게시할 수는 있지만 SmartDocs는 Apigee의 Edge API 관리 내에 있는 API 모델에서 생성됩니다. 서비스. Edge에서 API 모델을 변경하면 변경사항이 모든 Pantheon에서 동일합니다. (Patheon 환경 전반에서 개발자가 존재하는 방식과 유사함)

SmartDocs 베타에서 정식 버전으로 업그레이드하려면 다음 안내를 따르세요.

  1. 다음에서 15.05.27 버전 업데이트 및 테스트 dev 또는 test 환경 판테온.
  2. 사용 중인 기존 API 모델을 대체할 새 모델을 만듭니다.
    • Swagger 또는 WADL 문서를 가져온 경우 새 있습니다.
    • SmartDocs 모듈을 통해 API 모델을 유지보수해 온 경우 SmartDocs JSON을 만들고 첨부파일을 사용하여 새 모델로 가져옵니다.
  3. 모델 버전의 보안 속성을 설정합니다. 콘텐츠 > SmartDocs > 모델 페이지에서 보안 설정을 선택합니다.
  4. 모델 설정 페이지 (콘텐츠 > SmartDocs 작업)에서 Settings를 클릭하여 를 클릭합니다.
  5. v6 CSS 및 JS 애셋을 사용하도록 맞춤 템플릿을 업데이트하고 다른 새 객체 이름(예: authSchemes 및 apiSchema)을 사용할 수 있습니다. SmartDocs 업데이트에 대한 자세한 내용 자세한 내용은 사용 SmartDocs API를 문서화합니다.
  6. 모델 버전을 다시 렌더링하고 게시합니다.
  7. 새 문서의 유효성을 검사한 후 프로덕션 포털을 15.05.27 버전으로 업데이트합니다.

에지 엔터프라이즈 고객이며 업그레이드에 관해 질문이나 우려사항이 있는 경우 marsh@apigee.com 및 cnovak@apigee.com으로 이메일을 보내주세요. 그렇지 않은 경우 Apigee 커뮤니티에서 있습니다.


향후 기능 변경 및 개선사항

이 섹션에서는 향후 예상되는 기능 변경사항 및 개선사항을 미리 살펴봅니다.

다음으로 변경: 응답 캐시 정책 동작

향후 출시 (추후 결정 예정)에서 의 기본 동작은 &lt;ExcludeErrorResponse&gt; 응답 캐시 정책의 요소가 변경됩니다.

현재 동작: <ExcludeErrorResponse> 요소 를 응답 캐시 정책의 기본값은 false입니다. 즉, 기본적으로 응답 캐시 정책에 의해 캐시될 수 있는 모든 HTTP 상태 코드 (3xx 포함)를 캐시합니다.

향후 동작: <ExcludeErrorResponse> 요소 를 응답 캐시 정책의 기본값은 true입니다. 즉, 기본적으로 HTTP(S) 태그가 있는 경우에만 상태 코드 200에서 205까지 캐시됩니다. 이 동작을 재정의하고 모든 사용자에 대한 응답을 캐시하려는 경우 없는 경우 <ExcludeErrorResponse> 요소를 ~ true를 명시적으로 true로 설정합니다.

현재 해결 방법: Private Cloud 4.15.07.00 이하 출시의 경우 상태 코드 200~205로만 응답을 캐시하려는 경우 <ExcludeErrorResponse> 요소 true로 설정합니다.


수정된 버그

다음은 이번 출시 버전에서 수정된 버그입니다.

문제 ID 설명
OPDK-1521 비밀번호 암호화 문제
OPDK-1201 UI 데이터를 복원할 수 없음
OPDK-1112 커스텀 LDAP 비밀번호 정책이 Apigee 관리자에 적용되지 않습니다. 사용자
OPDK-1097 OPDK 업그레이드 중 키스페이스 예외
OPDK-1068 설치 중 실패 시 관리자 비밀번호 변경 가능
OPDK-1053 Zookeeper가 루트로 실행 중입니다.
OPDK-967 set-autostart.sh, all-status.sh를 사용하여 OpenLDAP에서 자동 시작되도록 설정할 때 고장났다고 신고함
OPDK-905 axgroup001 그룹에 이미 등록된 Smartdocs prod
OPDK-899 온보딩 중 오류
OPDK-847 온보딩 중에 생성된 사용자에게 재설정 시 메일이 수신되지 않음 비밀번호
OPDK-817 init.d 스크립트에서 오류 발생
OPDK-815 ax-purge.sh 스크립트에서 샘플링 테이블을 삭제해야 함
MGMT-2246 맞춤 보고서 생성 페이지가 관리에 제대로 표시되지 않습니다. UI
MGMT-2235 만료되는 SSL 인증서의 경우 만료 상대 시간이 혼란스러울 수 있음 둥근 모양
만료되는 SSL 인증서의 경우 만료일의 상대적 시간은 항상 일 단위로 표시됩니다. 인증서가 90일 후 만료되거나 줄일 수 있습니다.
MGMT-2193 API 수정 시 스피너 로드
MGMT-2173 Trace UI가 법적 URL을 허용하지 않음
이제 Trace UI에서 중첩된 내용이 포함된 쿼리 매개변수 값을 사용하여 요청을 보낼 수 있습니다. 쿼리 매개변수를 추가할 수 있습니다.
MGMT-2162 JavaScript 컴파일 문제
MGMT-2124 고객 역할의 권한은 UI
MGMT-2114 MessageLogging 정책의 잘못된 시스템 로그 IP가 배포
MGMT-2067 Trace: API 프록시 버전이 두 환경에 배포된 경우 버전 및 제대로 작동하지 않는 경우
MGMT-2061 비밀번호를 잊어버린 경우 등록된 사용자에게만 이메일을 보내야 합니다.
'비밀번호 찾기' 관리 UI 로그인 페이지의 링크를 클릭하면 등록된 Apigee 사용자
MGMT-2048 배포 권한을 하나의 환경으로 제한하는 커스텀 역할을 가진 사용자가 배포할 수 있음 (기타)
MGMT-2041 기본 첨부파일 템플릿에서 FaultRules 요소 삭제
정책 또는 API 프록시 단계에서 사용되지 않는 FaultRules 요소는 더 이상 사용되지 않습니다. API 프록시를 만들거나 정책을 추가할 때 자동으로 추가됩니다.
MGMT-2034 가져오기 WSDL이 실패를 반환함: 'WSDL 가져오기 오류: 처리 중 오류 발생 WSDL'
MGMT-1986 개발자를 추가하는 중 UI 오류 발생
MGMT-1983 OAuth 2.0 승인 코드 가져오기 API가 잘못된 상태를 반환함
MGMT-1962 안전한 비밀번호로 관리 UI에 로그인하는 중 오류 발생
더 이상 퍼센트 기호와 같은 특정 특수문자로 UI에 로그인할 수 없습니다. 있습니다
MGMT-1947 관리 UI의 직관적이지 않은 역할
사용자에게 트랜잭션 기록 정책을 만들거나 수정할 권한이 없는 경우 UI는 거래 기록 정책을 만들고 수정하는 버튼이 사용 중지되었습니다.
MGMT-1899 제품 설정을 저장한 후 리소스 경로가 삭제됨
API 제품을 수정할 때 사용자가 저장 버튼을 더블클릭했습니다. 이 문제는 해결되었습니다.
MGMT-1894 개발자를 위해 개발자 앱 페이지 로드가 완료되지 않음 열
MGMT-1882 WSDL의 새 API 프록시에서 마지막 매개변수 세부정보만 표시
MGMT-1878 한 환경에 여러 버전이 배포된 경우 Trace에는 다음 버전 중 하나만 표시됩니다.
MGMT-1872 맞춤 보고서를 다운로드할 수 없음
MGMT-1863 관리 UI에 Node.js 로그를 볼 수 없음
MGMT-1843 API 프록시가 열리지 않음
MGMT-1833 시스템 관리자에게 OPDK
MGMT-1825 교차 사이트 스크립팅 (XSS) 버그
MGMT-1824 확장자가 .xml인 WSDL 파일을 가져오는 중 WSDL 가져오기 오류
MGMT-1812 가져오기 중에 TargetEndpoint 검증 추가
ProxyEndpoint와 마찬가지로 TargetEndpoint는 적절한 스키마에 대해 검증됩니다. API 프록시 가져오기 중 조건에서 사용된 표현식입니다.
MGMT-1804 경우에 따라 Node.js API에서 잘못된 JSON을 전송함
json 데이터가 유효하지 않은 경우 형식이 지정되지 않은 로그를 표시하는 데 Node.js 로그 화면이 사용되었습니다. 있습니다. 이 출시 버전에서 수정되었으며 이제 UI에 올바른 형식의 node.js가 표시됩니다. 할 수 있습니다
MGMT-1802 비밀번호 재설정 URL #118
관리 UI가 SSL 종료 서버 뒤에 있는 경우 이제 관리 UI가 올바르게 작동합니다. http URL이 아닌 https URL 링크가 포함된 비밀번호 재설정 이메일을 생성합니다.
MGMT-1799 Trace에서 요청을 전송하는 UI 보안 취약점
MGMT-1777 TLD가 .acn인 이메일 주소를 사용하는 사용자를 추가할 수 없음
MGMT-1735 브랜딩 'W를 가져오는 중에 오류가 발생했습니다'
Edge OPDK의 맞춤 브랜딩 지원이 즉시 삭제되었습니다. 하지만 사용하고 있던 소수의 고객만 실망할 수도 있지만, 이것은 전혀 API 관리와 관련된 Edge의 기능을 직접적으로 개선하는 기능입니다.
MGMT-1569 기존 API 제품에 API 프록시를 연결하는 중에 문제가 발생했습니다.
API 프록시가 '/'에 대한 리소스입니다. 있습니다.
MGMT-1563 오류 발생 시 Trace의 보내기 버튼이 사용 중지된 상태로 유지됨
MGMT-1362 이메일 주소에 '_'
이메일 주소에 밑줄이 포함된 OPDK 비밀번호 재설정 문제가 수정되었습니다.
MGMT-1345 네임스페이스가 여러 개인 WSDL을 가져오면 잘못된 빌드 SOAP가 발생함 단계
MGMT-1193 프록시를 새 버전으로 저장하면 예기치 않게 라우팅 규칙이 변경됨
MGMT-1061 SmartDocs: Swagger 정의의 본문 유형 매개변수에 대한 설명이 표시되지 않음 문서 UI 사용
MGMT-800 이름이 'default'인 리소스 생성 중 UI가 손상됨
MGMT-787 UI 알림 사용성 문제
관리 UI에서 + API 프록시를 클릭하고 새 API 프록시 대화상자가 표시되면 Esc 키를 눌러 대화상자를 닫을 수 있습니다.
MGMT-619 API 프록시 UI 페이지에서 페이지로 나누기 활성화
MGMT-602 API 프록시 개발 뷰: 엔드포인트에 응답이 없을 때 응답 캐시 정책 추가 PreFlow/PostFlow로 인해 오류가 발생함
MGMT-460 정책 이름을 변경하면 글리치 동작, 중복 정책으로 인해 삭제됨
DEVRT-1644 이름으로 알림 조회로 인해 잘못된 이메일이 전송됨
DEVRT-1583 '미래'가 표시된 수익 창출 UI 현재 요금제 배지
DEVRT-1546 요금제 한도가 작동하지 않음
DEVRT-1511 기존 개발자의 mint.resourcedoesNotExist 오류
CORERT-639 TCPSysLogSocket은 비동기여야 함
CORERT-613 'unAware_name'으로 인한 SSL 핸드셰이크 실패
AXAPP-1728 분석에서 수익 창출 변수 무시
AXAPP-1708 Analytics API가 동일한 통계에 대해 다른 수치를 생성하는 것으로 보임 어떻게 질문하느냐에 따라
AXAPP-1707 무료 포드 분석 성능 향상
AXAPP-1690 '잘못된 API 오류' (맞춤 보고서에 적용)
AXAPP-1533 애널리틱스 Geomap에서 잘못된 API 호출 오류가 발생함
AXAPP-1493 잘못된 캐시 성능 통계
APIRT-1436 해싱되지 않은 토큰을 해싱하는 도구/스크립트 만들기
APIRT-1425 'true'로 설정된 경우continueOnError 속성 Java콜아웃에 영향을 미치지 않음 정책
APIRT-1346 OAuth2.0 - 다음에 대해 액세스 토큰 응답에서 해싱된 값 반환 hash.oauth.tokens.enabled가 true임
APIRT-1206 target_ip는 503초 동안 팩트 테이블에 기록되지 않았으며 대부분의 504초
APIRT-1170 리소스 파일 누락으로 인해 MP가 환경을 로드하지 못함
APIRT-1148 Node.js 타겟이 발생하는 경우 ResponseFlow에서 {message.version} 변수의 GET이 발생합니다. NPE
APIRT-1054 기본값
APIRT-387 OrganizationService가 '기타' 버전에서 실행되도록 함 MP
APIRT-67 OAuth GenerateAccessToken 정책에서 oauthV2.failed 변수를 설정하지 않음 정확하게
APIRT-52 맞춤 보고서: 많은 API의 응답 상태 코드가 null입니다.

알려진 문제

이 릴리스에는 다음과 같은 알려진 문제가 있습니다.

문제 ID 설명
OPDK-1586

IPV6 지원이 사용 설정되지 않은 경우 API BaaS 포털이 시작되지 않음
해결 방법은 /&lt;install-dir&gt;/apigee4/conf/nginx/conf.d/loadbalancer.conf에서 다음 IPV6 줄을 주석 처리하는 것입니다. API BaaS 포털을 실행하거나 IPV6 지원을 사용 설정하려면 다음 단계를 따르세요.

# listen [::]:8080;

OPDK-1785

업그레이드된 Edge에 수익 창출 구성요소 설치 환경
Edge 설치를 4.15.07.00으로 업그레이드했으며 아직 사용하고 있지 않은 경우 업그레이드 전에 수익 창출을 설정하려는 경우 4.15.07.00에 수익 창출을 설치할 수 없습니다. 사용할 수 있습니다

해결 방법은 apigee-env.sh 파일에 올바른 수익 창출 버전을 설정하는 것입니다. 을 준수해야 합니다. 4.15.07에서 수익 창출 버전을 다운로드하려면 다음 안내를 따르세요. (Edge 4.15.07로 이미 업그레이드한 후) 다음을 실행합니다.
> source /{install-dir}/apigee4/bin/apigee-env.sh 

> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4` 
기본적으로 install-dir은 /opt입니다.
위의 VER 값을 apigee-env.sh에 설정해야 합니다.
> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh 
위 단계를 수행하지 않고 수익 창출을 설치하려고 하면 설치에 실패하고 공유 디렉터리에 작동하지 않는 심볼릭 링크가 있을 수 있습니다. 요구사항 해당 심볼릭 링크를 삭제하려면 다음 단계를 따르세요.
> rm /install-dir/apigee4/share/monetization 
심볼릭 링크를 삭제한 후 위의 단계를 수행하여 수익 창출 버전을 설정합니다. 수익 창출 설치를 다시 시도하세요.
OPDK-1857 bin/qpid-stat.sh에 Python 2.6 버전을 하드코딩하고 bin/qpid-config.sh

CentOS 및 RedHat 7.0에서 bin/qpid-stat.sh 및 bin/qpid-config.sh에 있는 여러 스크립트 Python 버전 2.6을 사용하도록 하드 코딩되어 있습니다.

이 문제의 해결 방법은 PYTHONPATH를 qpid-stat.sh 및 qpid-config.sh를 Apigee4/bin 디렉터리에 배치하세요.

export PYTHONPATH="${QPID_DIR}/lib/python2.6/site-packages"

시스템의 Python 버전을 확인하려면 /opt/apigee4/share/apache-qpid/lib를 참조하세요. 디렉터리는 python2.7일 가능성이 높습니다.

그런 다음 qpid-stat.sh 및 qpid-config.sh에서 PYTHONPATH 설정을 다음과 같이 업데이트해야 합니다. 올바른 경로를 선택합니다. 예를 들면 다음과 같습니다.

export PYTHONPATH="${QPID_DIR}/lib/python2.7/site-packages"

DEVRT-1574 활성 요금이 여러 개인 개발자의 균형 및 사용량이 일관되지 않음 요금제
개발자가 API별 호출이 포함된 둘 이상의 요금제를 사용 중인 경우 수익 창출 금전적인 잔액 사용이 일관되지 않은 경우가 있습니다.
APIBAAS-1647 시스템 관리자로 로그인한 후 BaaS UI에서 '역할을 가져오는 중 오류 발생' 메시지가 표시됨 메시지
이 오류 메시지는 다음 시간 이후 시스템 관리자가 시스템에 처음 로그인할 때 나타납니다. 4.15.01에서 4.15.07로 업그레이드되었습니다 이 메시지는 무시해도 됩니다.
DEVRT-1834 4.15.07로 수익 창출 업그레이드
apigee-upgrade.sh 스크립트는 끝에 다음 메시지를 출력하여 다음을 수행하라는 메시지를 표시합니다. 다른 스크립트 실행:
************************************** 
In order to complete the monetization upgrade please run: 
sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/
365-create-notification-condition.sh 
************************************** 

이 메시지는 무시해도 됩니다. 해당 스크립트는 필요하지 않으며 실행할 수 없습니다.

DEVRT-1951 수익 창출 신규 설치에 알림 구성이 누락됨
Private Cloud용 Apigee Edge 버전 4.15.07.00을 새로 설치하면 수익 창출 알림에 대한 다음 구성이 누락되었습니다. 이는 관리 > 알림 유형에 대해 관리 UI의 알림 페이지
mint.scheduler.${ORG_ID}.adhocnotify@@@management
mint.scheduler.${ORG_ID}.expiringrateplannotify@@@management
mint.scheduler.${ORG_ID}.newpkgnotify@@@management
mint.scheduler.${ORG_ID}.newproductnotify@@@management
mint.scheduler.${ORG_ID}.newrateplannotify@@@management
mint.scheduler.${ORG_ID}.tncacceptancenotify@@@management
이 문제를 해결하려면 다음 단계를 따르세요. Cassandra 인스턴스 찾으려면 <Installation-root>/apigee4/conf/cassandra/cassandra.yaml 또는 &lt;installation-root&gt;/apigee4/conf/cassandra/cassandra-topology.properties.
  1. 다음 명령어를 실행하세요. {ORG_ID} 변수는 그대로 두고 <org_name>, <installation-root>, <cassandra_ip_address>.
    sed -e "s/\${ORG_ID}/<org_name>/g" <installation-root>/apigee4/share/monetization/schema/cassandra/org/ui/mint-org-specific-ui-schedulers.txt > /tmp/mint-org-specific-ui-schedulers.txt
    
    <installation-root>/apigee4/share/apache-cassandra/bin/cassandra-cli -h <cassandra_ip_address> -f /tmp/mint-org-specific-ui-schedulers.txt
    
  2. 관리 서버를 다시 시작합니다.
DEVRT-1952 알림 누락 4.14.07.00에서의 수익 창출 업그레이드 구성
Private Cloud용 Apigee Edge 버전을 4.14.07.00에서 4.15.07.00으로 업그레이드하면 수익 창출 알림에 대한 다음 구성이 누락되어 수익 창출 보고서가 제대로 작동하지 않을 수 있습니다.
mint.scheduler.${ORG_ID}.chargedaily@@@management
mint.scheduler.${ORG_ID}.chargehourly@@@management
이 문제를 해결하려면 다음 단계를 따르세요. Cassandra 인스턴스 찾으려면 <Installation-root>/apigee4/conf/cassandra/cassandra.yaml 또는 &lt;installation-root&gt;/apigee4/conf/cassandra/cassandra-topology.properties.
  1. 다음 명령어를 실행하세요. {ORG_ID} 변수는 그대로 두고 <org_name>, <installation-root>, <cassandra_ip_address>.
    sed -e "s/\${ORG_ID}/<org_name>/g" <installation-root>/apigee4/share/monetization/schema/cassandra/org/system/mint-org-specific-system-schedulers.txt > /tmp/mint-org-specific-system-schedulers.txt
    
    <installation-root>/apigee4/share/apache-cassandra/bin/cassandra-cli -h <cassandra_ip_address> -f /tmp/mint-org-specific-system-schedulers.txt
    
  2. 관리 서버를 다시 시작합니다.
OPDK-1878 여러 데이터 센터 설치에서 포드 이름을 설정할 수 없습니다.
Edge 설치 가이드에서는 포드 이름을 'gateway-1'로 설정하도록 지정합니다. 'gateway-2' 를 자동 설치 파일이 있습니다. 하지만 포드 이름을 변경하면 라우터와 메시지 프로세서가 제대로 등록되지 않고 있습니다. 또한 이 문제로 인해 setup-org.sh 스크립트가 사용할 수 있는 메시지 프로세서를 찾습니다.

해결 방법은 MP_POD 속성을 사용하여 포드 이름을 '게이트웨이'로 설정하는 것입니다. 를 자동 설치 파일이 생성됩니다.
OPDK-1886

노드가 192.168.x.y와 같은 로컬 IP 주소에 액세스할 수 없음
'EINVAL 연결' 오류가 표시됩니다. 액세스하려고 할 때 발생합니다.
해결 방법은 /&lt;install_dir&gt;/apigee4/conf/apigee/message-processor/nodejs.properties를 편집하는 것입니다. 파일을 주석 처리하여 다음 줄을 주석 처리합니다.

connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32

그런 다음 메시지 프로세서 노드를 다시 시작합니다.

<install_dir>/apigge4/bin/apigee-service message-processor restart 
OPDK-1958 업그레이드 시 모든 노드가 관리에서 포트 8080에 액세스해야 합니다. 서버
런타임 시 다음 구성요소는 관리 서버의 포트 8080에 액세스해야 합니다. 라우터, 메시지 프로세서, UI, Postgres, Qpid에 대해 알아봤습니다. 그러나 업그레이드할 때 모든 노드는 Cassandra 및 동물원을 포함한 관리 서버의 포트 8080에 대한 액세스 필요 노드라는 두 가지 리소스가 있습니다
OPDK-1962 업그레이드 후 Edge API의 SSL을 재구성해야 함
4.15.07.00으로 업그레이드하기 전에 SSL을 사용하도록 Edge API를 구성한 경우 업그레이드 후 SSL을 다시 구성해야 합니다. Edge 작업 가이드에서 Edge API용 SSL을 구성하는 절차를 따르세요.