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

4.15.01.00 - Apigee Edge 온프레미스 출시 노트

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보

2015년 1월 27일 화요일에 온프레미스 Apigee Edge의 분기별 버전을 출시했습니다.

버전 4.15.01.00에는 수많은 새 기능이 포함되어 있으며 이 중 다수는 최신 연말연시 시즌 및 이전 클라우드 출시의 컨텍스트에서 해결되었습니다. 새로운 기능 영역에는 관리 UI 프레임워크, LDAP, 설치 및 업그레이드, 분석, 응답 오류 구성 및 압축이 포함됩니다. 아래에서 전체 목록을 확인하세요.

궁금한 점이 있으면 Apigee 고객 지원으로 이동하세요.

Apigee Edge 출시 노트의 전체 목록은 Apigee 출시 노트를 참조하세요.

새로운 기능 및 개선사항

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

ApacheDS를 대체하는 OpenLDAP
이제 Edge에서 API 관리 환경에서 사용자를 인증하기 위해 OpenLDAP를 제공합니다. OpenLDAP의 이점으로는 다양한 비밀번호 인증 옵션을 구성할 수 있는 비밀번호 정책이 있습니다. 예를 들어 로그인 시도가 연속으로 실패한 횟수 이후에는 더 이상 비밀번호를 사용하여 사용자를 디렉터리에 인증할 수 없습니다. 자세한 내용은 Edge OPDK 작업 가이드를 참조하세요.

이제 Edge에서 신규 설치 시 OpenLDAP가 유일한 LDAP 서버입니다. 4.15.01.00으로 업그레이드하는 기존 Edge 설치는 ApacheDS를 계속 사용할 수 있지만 4.15.01.00의 모든 새 설치는 OpenLDAP를 사용합니다.

4.15.01.00 설치 절차에서 포트로 OpenLDAP로 업그레이드하면 ApacheDS의 모든 데이터가 OpenLDAP로 마이그레이션됩니다. 업그레이드에 관한 자세한 내용은 알려진 문제 섹션을 참고하세요.
보안 개선
이 출시 버전의 보안이 개선되었습니다. 경로 삽입 및 순회 취약점, 역할 기반 액세스 권한, 교차 사이트 요청 위조 취약점, Edge 관리 UI의 승인 우회, 외부 항목 취약점.
Apache Cassandra 성능 및 안정성 개선
이 출시 버전에는 Edge 제품이 NoSQL Cassandra 데이터베이스에 액세스하는 방식의 성능 개선사항과 버전 1.2.11에서 1.2.19로 업그레이드되는 Cassandra 자체에 대한 개선사항이 포함되어 있습니다.
토큰 관리 개선

OAuth 토큰 반환 및 데이터베이스 정리 기능이 개선되었을 뿐만 아니라 이제 최종 사용자 ID, 앱 ID 또는 둘 다를 사용하여 OAuth 2.0 액세스 토큰을 검색하고 취소할 수 있습니다. 자세한 내용은 다음을 참조하세요.
- Apigee Edge 작업 가이드
- 최종 사용자 또는 앱 ID별로 OAuth2 액세스 토큰 받기
- 최종 사용자 또는 앱 ID별로 OAuth2 액세스 토큰 취소
애널리틱스 개선사항
이 출시 버전에는 다음을 포함한 여러 분석 개선사항이 포함되어 있습니다.
- API 프록시의 캐시 사용에 대한 측정항목을 확장했습니다.
- 지연 시간 분석 지연 시간 분석 대시보드(Apigee Edge 요금제만 해당) 외에도 커스텀 보고서의 새로운 상위 백분위수 (TP*) 측정항목을 통해 특정 비율의 트랜잭션이 완료되는 시간 기준을 확인할 수 있습니다. 예를 들어 TP99 측정항목은 트랜잭션의 99% 가 완료되는 시간 기준점을 표시합니다.
- 가상 측정기준 - 사용자 에이전트, 타임스탬프, IP 주소가 OS 버전, 기기 제품군, 요일, 도시, 국가, 시간대와 같은 측정기준에 자동으로 매핑됩니다.
- 새롭게 설계된 맞춤 보고서용 인터페이스 (베타)
- Apigee 127 내장 프록시 지원
- 애널리틱스에서 캡처한 새로운 'Apigee Fault' 및 'Target Fault' 불리언 플래그
런타임 복원력 개선
이 출시 버전에는 Cassandra 오류에 대한 정책 가용성, Netty 라우터 안정성, SSL 스레드 안정성 등 여러 런타임 복원력 개선사항이 포함되어 있습니다.
Node.js 개선사항
이 출시 버전에는 다음과 같은 Node.js 개선사항이 포함되어 있습니다.
- 새로운 캐시된 Node.js 로그 가져오기 API를 사용하면 Node.js 스크립트에서 최근 수백 개의 로그 레코드를 검색할 수 있습니다.
- 'trireme-support' 모듈 (Java로 작성된 Node.js 모듈)을 지원합니다. 자세한 내용은 https://www.npmjs.com/package/trireme-support를 참조하세요.
- 조직 및 환경 이름이 가상 경로에서 제거되고 변수로 이동했습니다.
- 자바 7로 업그레이드
- Trireme 0.8.4로 업그레이드하여 UTF-8이 아닌 문자 집합의 HTTP 요청 파싱 및 처리 문제를 해결합니다.
2.0으로 업그레이드된 Play 프레임워크
수익 창출을 포함하여 Edge에서 사용하는 Play 프레임워크가 Play 2.0으로 업그레이드되었습니다.
이제 비밀번호를 요구하도록 JMX 모니터링 통계를 구성할 수 있음
관리 서버, 라우터, 메시지 프로세서, QPID, Postgres의 모니터링 프로세스는 모두 JMX를 사용합니다. JMX는 기본적으로 사용 설정되며 원격 JMX 액세스에는 비밀번호가 필요하지 않습니다. 그러나 이제 JMX 통계에 비밀번호 보호를 적용하여 액세스를 제어할 수 있습니다. 자세한 내용은 Edge 작업 가이드를 참조하세요.
API 프록시 리소스의 와일드 카드
API 프록시 리소스를 정의할 때 와일드 카드 문자 (별표 *)를 사용할 수 있습니다. 예를 들면 /developers/*/apps 또는 /developers/**입니다. API 프록시 리소스에 대한 자세한 내용은 조건부 흐름을 백엔드 API 리소스에 매핑을 참조하세요.
"/" resource on productsAPIRT-667
API 제품에 리소스를 단일 슬래시('/')로 추가하면 기본적으로 Apigee에서 리소스를 '/**와 동일하게 취급하여 개발자에게 기본 경로 아래의 모든 URI에 대한 액세스 권한을 부여합니다. 새로운 조직 수준 features.isSingleForwardSlashBlockingEnabled 속성을 사용하면 '/'의 기본 동작을 변경할 수 있습니다. 속성을 'true'로 변경하면(클라우드 고객이 이 작업을 수행하려면 Apigee 지원팀에 문의해야 함) '/'로 개발자가 기본 경로 리소스에만 액세스할 수 있습니다.

자세한 내용은 리소스 경로의 동작 구성을 참고하세요.
할당량 및 Spike Arrest의 HTTP 응답 오류 구성APIRT-664
이제 할당량 또는 Spike Arrest 정책에 설정된 비율 제한을 초과하는 모든 요청에 대해 HTTP 상태 코드 429 (너무 많은 요청)를 반환하도록 Apigee Edge 조직을 구성할 수 있습니다. 기본 구성은 HTTP 상태 코드 500 (내부 서버 오류)을 반환합니다.

할당량 및 Spike Arrest 위반이 HTTP 상태 코드 429를 반환하도록 하려는 조직에 대해 features.isHTTPStatusTooManyRequestEnabled 속성을 true로 설정하려면 Apigee 지원팀에 문의하세요.
HealthMonitor에서 SSL 지원
이제 부하 분산기에 할당된 HealthMonitor에서 SSL을 지원합니다. 자세한 내용은 백엔드 서버 간 부하 분산을 참조하세요.
Edge 수익 창출 설치 프로그램이 이제 자동 설치를 지원합니다.
이제 수익 창출에서 자동 또는 무인 설치를 지원합니다. 자세한 내용은 Edge 설치 및 구성 가이드를 참고하세요.
API 응답의 gzip 압축MGMT-1127
관리 API 호출은 콘텐츠 길이가 1,024바이트 이상인 응답에서 gzip 압축을 지원합니다. 사용:
'Accept-Encoding: gzip, deflate'

수정된 버그

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

주제	문제 ID	설명
메모리 사용률 높음	CORERT-362	메시지 프로세서가 프로세스를 완료하기 전에 트리거된 중지 셸 스크립트로 인해 메모리 사용률이 높았습니다. 이 문제는 해결되었습니다.
SOAP WSDL 프록시 생성	MGMT-1526	관리 UI에서 SOAP 기반 API 프록시를 만들면 브라우저가 중단됩니다. 이 문제는 해결되었습니다.
이름에 마침표가 있는 개발자 앱	MGMT-1236	관리 UI에서 개발자 앱 이름에 마침표가 포함되어 있으면 앱을 업데이트할 수 없습니다. 이 문제는 해결되었습니다.
MP CPU 및 지연 시간 증가	CORERT-384	대상 응답에 'Connection: close' 헤더가 포함될 때마다 메시지 프로세서 CPU 및 응답 지연 시간이 증가했습니다. 이 문제는 해결되었습니다.
HTTP 요청 및 응답 통계	CORERT-364	누적 HTTP 요청 및 응답에 대한 통계가 정확하지 않았습니다. 이 문제는 해결되었습니다.
할당량 정책 시행	APIRT-909	할당량 기간이 시작되기 전에 발생한 API 호출이 캘린더 기반 할당량 정책에서 잘못 거부되었습니다. 이 문제는 해결되었습니다.

또한 이 릴리스에는 다음 릴리스의 버그 수정도 포함되어 있습니다. 자세한 내용은 개별 출시 노트를 참고하세요.

Edge Cloud	Edge 온프레미스
14.10.29 14.10.15 (수익 창출) 14.10.15 14.10.01 14.09.17 14.09.03	4.14.07.04 4.14.07.03 4.14.07.00 4.14.04.11

알려진 문제

이 버전에는 다음과 같은 알려진 문제가 있습니다.

주제 문제 ID 설명

LDAP 업그레이드

DOC-1262

주제	문제 ID	설명
LDAP 업그레이드	DOC-1262	버전 4.14.07에서 4.15.01로 업그레이드하고 ApacheDS에서 OpenLDAP으로 업그레이드할 때 공백이 포함된 역할 이름 (예: '읽기 전용')이 OpenLDAP에서 제대로 다시 생성되지 않습니다. 업그레이드하기 전에 이름에 공백이 있는 역할을 삭제하고 다시 만드세요. 이미 업그레이드한 경우 다음 명령어를 실행하여 OpenLDAP에서 문제 역할을 삭제합니다. `ldapdelete -H ldap://localhost:10389 -D 'cn=manager,dc=apigee,dc=com' -r -W 'cn=<role>,ou=userroles,o=<org>,ou=organizations,dc=apigee,dc=com'` 그런 다음 역할을 다시 만듭니다.
SMTP 이메일 오류	OPDK-900	SMTP 이메일 유효성 검사에 실패하는 경우 apigee4/conf/ui/apigee.conf의 다음 속성 값이 동일한 값(`apigee.mgmt.mailFrom and mail.smtp.user`)으로 설정되어 있는지 확인하세요. 또는 SMTP 이메일 검증을 중지합니다.

버전 4.14.07에서 4.15.01로 업그레이드하고 ApacheDS에서 OpenLDAP으로 업그레이드할 때 공백이 포함된 역할 이름 (예: '읽기 전용')이 OpenLDAP에서 제대로 다시 생성되지 않습니다.

업그레이드하기 전에 이름에 공백이 있는 역할을 삭제하고 다시 만드세요.

이미 업그레이드한 경우 다음 명령어를 실행하여 OpenLDAP에서 문제 역할을 삭제합니다.

ldapdelete -H ldap://localhost:10389 -D 'cn=manager,dc=apigee,dc=com' -r -W 'cn=<role>,ou=userroles,o=<org>,ou=organizations,dc=apigee,dc=com'

그런 다음 역할을 다시 만듭니다.

SMTP 이메일 오류 OPDK-900 SMTP 이메일 유효성 검사에 실패하는 경우 apigee4/conf/ui/apigee.conf의 다음 속성 값이 동일한 값(apigee.mgmt.mailFrom and mail.smtp.user)으로 설정되어 있는지 확인하세요. 또는 SMTP 이메일 검증을 중지합니다.

4.15.01.01

4.14.07.07