현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보
2015년 5월 19일 화요일에 프라이빗 클라우드용 Apigee Edge의 분기별 버전이 출시되었습니다.
이전 제품명인 'Apigee Edge On-Prem' 또는 'OPDK'는 이제 'Apigee Edge for Private Cloud'입니다.
궁금한 점이 있으면 Apigee 고객 지원으로 이동하세요.
Apigee Edge 출시 노트의 전체 목록은 Apigee 출시 노트를 참조하세요.
새로운 기능 및 개선사항
다음은 이번 버전의 새로운 기능 및 개선사항입니다.
OpenLDAP - 설치 및 업그레이드
이제 Edge에서 신규 및 업그레이드 설치를 위해 지원되는 유일한 LDAP 서버는 OpenLDAP입니다.
API 서비스
다음은 Edge API 서비스의 새로운 기능과 개선사항입니다.
WebSockets
웹 클라이언트와 서버 간의 실시간 웹 통신을 사용 설정하기 위해 Edge는 WebSocket 프로토콜을 지원합니다. Edge는 WebSocket 통신에서 클라이언트 또는 서버 역할을 할 수 있습니다. Edge에서 WebSocket을 설정하고 사용하는 방법에 대한 자세한 내용은 WebSocket을 사용한 비공개 클라우드용 Apigee Edge 가이드를 참조하세요.
API 관리를 위한 외부 인증 제공업체 지원
Edge는 Active Directory 및 API 관리 사용자가 포함된 기타 외부 인증 제공업체/LDAP 시스템과 통합됩니다. 자세한 내용은 비공개 클라우드 외부 인증 구성용 Edge 가이드를 참조하세요.
관리 UI의 공동 브랜딩
Apigee 로고 옆에 표시되는 자체 커스텀 로고로 Edge 관리 UI를 공동 브랜딩할 수 있습니다. 자세한 내용은 프라이빗 클라우드용 Apigee Edge 운영 가이드의 'Apigee UI 메뉴에 커스텀 로고 추가'를 참조하세요.
Trace의 Node.js 로그
Node.js API 프록시를 디버깅할 때 API 프록시 편집기의 추적 뷰에서 Node.js 로그 기능을 사용 설정할 수 있습니다. 이 기능을 사용 설정하려면 설치의 apigee-base.conf 또는 apigee-onprem.conf 파일에서 apigee.feature.disableNodeJSLogs="false"를 설정하세요. Node.js 로그에 대한 자세한 내용은 Node.js 프록시 디버깅 및 문제 해결을 참조하세요.
비밀번호 만료
Edge 4.15.01.x에서는 Edge 비밀번호가 30일 후에 자동으로 만료됩니다. 즉, 비밀번호가 만료되기 전에 비밀번호를 변경하지 않는 한 사용자가 액세스할 수 없게 됩니다. 하지만 시스템 관리자의 비밀번호가 만료되어 시스템 관리자가 Edge에 액세스할 수 없게 되었습니다.
4.15.04.00으로 업그레이드하면 비밀번호가 만료되지 않도록 기본 설정이 변경됩니다. 필요한 경우 /opt/apigee4/bin/apigee-enable-pwlockout.sh 스크립트를 사용하여 Edge 비밀번호가 만료되도록 구성할 수 있습니다. 자세한 내용은 Apigee Edge for Private Cloud 운영 가이드를 참조하세요.
시스템 관리자 액세스를 특정 이메일 도메인으로 제한
sysadmin 또는 sysadmin 읽기 전용 역할의 멤버십을 특정 이메일 도메인의 사용자로 제한할 수 있습니다. 이 기능을 사용 설정하려면 Apigee Edge for Private Cloud 운영 가이드의 설명대로 허용되는 도메인을 apigee4/conf/apigee/management-server/security.properties 파일에 추가하세요.
관리 UI 오류 메시지
화면 공간을 더 효율적으로 사용할 수 있도록 관리 UI의 오류 메시지 표시 방식이 새롭게 디자인되었습니다.
새 OAuthV2 오류 변수
다음과 같은 새로운 오류 관련 변수는 OAuthV2 정책에 의해 설정됩니다.
- oauthV2.<policy-name>.failed - 정책이 실패하면 true로 설정합니다.
- oauthv2.<policy_name>.<fault_name> - 오류의 이름 예: invalid_request
- oauthv2.<policy_name>.<fault_cause> - 오류 원인입니다. 예: 토큰 만료됨
http://apigee.com/docs/api-services/content/oauthv2-policy를 참조하세요.
제품 생성
새 제품을 만들 때 이제 표시 이름 외에 제품 이름을 지정할 수 있습니다.
http://apigee.com/docs/developer-services/content/creating-api-products를 참조하세요.
조직에서 사용자를 삭제하는 UI
UI의 조직 사용자 페이지에서 삭제 버튼이 삭제 버튼으로 대체되었습니다. 따라서 조직에서 사용자를 삭제해도 해당 사용자의 Apigee 계정은 활성 상태로 유지된다는 것을 명확히 할 수 있습니다.
http://apigee.com/docs/api-services/content/managing-organization-users를 참고하세요.
관리 UI의 필터링 옵션
관리 UI의 API 프록시, 제품, 개발자, 앱 페이지에서 새로운 필터링 옵션을 검색할 수 있습니다.
오프라인 추적 도구
오프라인 트레이스 도구를 사용하면 이전에 저장된 트레이스 세션을 보고 분석할 수 있습니다. 저장된 Trace 세션은 기본적으로 Trace 세션의 '레코딩'이며, 문제 해결 및 추가 분석이 필요한 경우에 유용합니다. 오프라인 추적 도구의 UI는 '실시간' 추적 도구와 유사합니다.
자세한 내용은 오프라인 추적 도구 사용을 참고하세요.
사용자 설정에 표시된 사용자 역할
이제 관리 UI의 사용자 설정 페이지 (사용자 이름 > 사용자 설정)에 사용자의 역할이 표시됩니다.
에지 관리 UI 개선사항
이 출시 버전에는 Edge 관리 UI의 소규모 사용성 및 일관성 개선사항이 포함되어 있습니다.
분석 서비스
다음은 에지 분석 서비스의 새로운 기능과 개선사항입니다.
6개월 동안의 데이터 사용 가능
관리 UI 또는 API로 애널리틱스 보고서를 생성할 때 현재 날짜로부터 6개월이 지난 데이터에는 기본적으로 액세스할 수 없습니다. 6개월 넘게 지난 데이터에 액세스하려면 Apigee 지원팀에 문의하세요.
애널리틱스에 추가된 변수
다음 새 변수가 API 프록시 트레이스 창의 AX 단계에 표시되는 Edge 애널리틱스로 전달됩니다.
- apigee.edge.execution.is_target_error - API 오류가 타겟 측 오류 (값 '1')인지 아니면 실패한 HTTP 응답의 대상이 아닌 오류(값 '0')인지 식별할 수 있습니다. 성공적인 HTTP 응답을 위한 값은 null입니다.
-
apigee.edge.execution.is_policy_error - 실패한 HTTP 응답 (값 '0')에서 정책이 실패했는지 (값 '1') 또는 실패한 정책이 없는지 확인할 수 있습니다. 성공적인 HTTP 응답의 경우 값은 null입니다.
다음 관련 변수는 먼저 실패한 정책의 세부정보를 제공합니다. 실패한 정책이 없는 경우 값은 null입니다.- apigee.edge.execution.fault_policy_name - 실패한 정책의 이름입니다.
- apigee.edge.execution.fault_flow_name - 실패한 정책의 흐름 이름 (예: PreFlow, PostFlow 또는 사용자 정의 흐름 등)입니다.
- apigee.edge.execution.fault_flow_state - 흐름에서 정책이 연결된 위치입니다. 가능한 값은 PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW, PROXY_RESP_FLOW입니다.
대시보드
- API, 개발자, 제품, 개발자 앱의 실적 차트가 이전되었습니다. 이전에는 이러한 항목의 기본 페이지 하단에 표시되었습니다. 이제 각 페이지 상단에서 애널리틱스 탭을 선택하여 차트에 액세스할 수 있습니다.
- 이 출시 버전에는 다음과 같은 기존 또는 새 대시보드에 대한 주요 작업이 포함되어 있습니다.
- Apigee 대시보드 (수정됨): 프록시 트래픽, 개발자 참여, 개발자 앱의 세 가지 측정항목 차트가 포함됩니다. 각 차트에는 각 측정항목을 상세히 살펴볼 수 있는 '세부정보' 뷰가 제공됩니다. Apigee 대시보드를 참조하세요.
- 프록시 성능 (신규): API 프록시 트래픽 패턴과 처리 시간을 표시합니다. API 프록시 성능 대시보드를 대체합니다. API 프록시 성능을 참조하세요.
- 트래픽 구성 (수정됨): 대시보드의 디자인과 분위기 및 콘텐츠가 완전히 수정되었습니다. 전체 API 프로그램에 대한 상위 API, 앱, 개발자, 제품의 상대적 기여도를 측정합니다. 트래픽 구성을 참고하세요.
- 오류 분석 (수정): 디자인과 콘텐츠가 완전히 수정되었습니다. API 프록시 및 대상의 오류율을 표시합니다. 오류 코드 분석 대시보드를 참조하세요.
-
기존 대시보드는 다음과 같이 이름이 변경되었습니다.
개발자 서비스
다음은 에지 개발자 서비스의 새로운 기능과 개선사항입니다.
SmartDocs용 Swagger 2.0 지원
SmartDocs는 Swagger 2.0 사양 문서 가져오기를 지원하며 Swagger 1.2와 하위 호환성을 유지합니다. 보안 스키마 객체 및 중앙 집중식 스키마에 대한 지원은 향후 출시 버전에서 제공됩니다.
수익 창출
다음은 Edge 수익 창출의 새로운 기능과 개선사항입니다. 수익 창출에 대한 자세한 내용은 '알려진 문제' 섹션도 참고하세요.
회사와 개발자에 대한 별도의 처리
이제 회사와 개발자가 별도로 처리되므로 개발자에게 여러 회사를 추가하고 회사에 여러 개발자를 추가할 때 유연성을 향상할 수 있습니다. 이제 관리 UI에서 '회사'와 '개발자'를 위한 별도의 창을 제공합니다('게시' 메뉴에서 액세스 가능).
회사 및 개발자 관리를 참조하세요.
수익 창출 보고서에서 회사는 기본 필터로 유지되지만 필터 라벨이 '개발자'에서 '회사'로 변경되었습니다.
수정된 버그
다음은 이번 출시 버전에서 수정된 버그입니다.
| 문제 ID | 설명 |
|---|---|
| OPDK-954 | 4.15.01 Cassandra 스키마가 업그레이드되지 않음 |
| MGMT-1986 | 개발자 추가 중 UI 오류 발생 |
| MGMT-1983 | OAuth 2.0 승인 코드 가져오기 API가 잘못된 상태를 반환함 |
| MGMT-1962 | 안전한 비밀번호로 관리 UI에 로그인하는 중 오류 발생 퍼센트 기호와 같은 특정 특수문자를 사용하여 UI에 로그인해도 더 이상 실패하지 않습니다. |
| MGMT-1894 | 개발자 앱 페이지의 개발자 열의 로드가 완료되지 않음 |
| MGMT-1872 | 맞춤 보고서를 다운로드할 수 없음 |
| MGMT-1777 | TLD가 .acn인 이메일 주소로 사용자를 추가할 수 없음 |
| MGMT-1362 | 이메일 주소에 '_'이 포함된 경우 비밀번호 찾기 이메일이 작동하지 않음 Private Cloud에서 밑줄이 포함된 이메일 주소에 비밀번호 재설정 문제가 발생하는 문제를 해결했습니다. |
| CORERT-613 | 'undigd_name'으로 인한 SSL 핸드셰이크 실패 |
| APIRT-1346 | OAuth2.0 - hash.oauth.tokens.enabled가 true인 경우 액세스 토큰 응답에서 해싱된 값이 반환됨 |
또한 이 릴리스에는 다음 릴리스의 버그 수정도 포함되어 있습니다.
| Edge Cloud | 프라이빗 클라우드용 에지 |
|---|---|
알려진 문제
이 버전에는 다음과 같은 알려진 문제가 있습니다.
| 문제 ID | 설명 |
|---|---|
| N/A |
설치 프로그램이 수익 창출 설치 또는 업그레이드에 사용하는 Cassandra 스크립트 두 개는 이 출시 버전에 포함되지 않았습니다. 이 문제를 해결하려면 Cassandra 설치 또는 업그레이드 후 다음 명령어를 실행하여 수익 창출 설치/업그레이드를 완료하세요.
|
| CORERT-318 | 큰 페이로드 (수백 KB)가 포함된 API 호출은 때때로 중단될 수 있습니다. 이 문제를 해결하려면 Router.properties 파일에 다음 속성 값을 설정합니다.HTTPServer.streaming.buffer.limit=0 (기본 설정은 10) |