Apigee Edge 문서입니다.
Apigee X 문서로 이동 정보
2015년 5월 19일 화요일에 프라이빗 클라우드용 Apigee Edge의 분기별 버전이 출시되었습니다.
이전 제품 이름인 'Apigee Edge 온프레미스' 또는 'OPDK'가 이제 '프라이빗 클라우드용 Apigee Edge'로 변경되었습니다.
궁금한 점이 있으면 Apigee 고객 지원팀으로 이동하세요.
모든 Apigee Edge 출시 노트 목록은 Apigee 출시 노트를 참고하세요.
새로운 기능 및 개선사항
다음은 이번 출시의 새로운 기능과 개선사항입니다.
OpenLDAP - 설치 및 업그레이드
이제 OpenLDAP는 Edge에서 신규 설치 및 업그레이드에 대해 지원하는 유일한 LDAP 서버입니다.
API 서비스
다음은 Edge API 서비스의 새로운 기능과 개선사항입니다.
WebSocket
웹 클라이언트와 서버 간의 실시간 웹 통신을 사용 설정하기 위해 Edge는 WebSocket 프로토콜을 지원합니다. Edge는 WebSocket 통신에서 클라이언트 또는 서버 역할을 할 수 있습니다. Edge에서 WebSocket을 설정하고 사용하는 방법에 관한 자세한 내용은 WebSocket을 사용하는 프라이빗 클라우드용 Apigee Edge 가이드를 참고하세요.
API 관리를 위한 외부 인증 제공업체 지원
Edge는 API 관리 사용자가 포함된 Active Directory 및 기타 외부 인증 제공업체/LDAP 시스템과 통합됩니다. 자세한 내용은 프라이빗 클라우드용 Edge 외부 인증 구성 가이드를 참고하세요.
관리 UI의 공동 브랜딩
Apigee 로고 옆에 표시되는 자체 맞춤 로고로 Edge 관리 UI를 공동 브랜딩할 수 있습니다. 자세한 내용은 프라이빗 클라우드 운영을 위한 Apigee Edge 가이드의 'Apigee UI 메뉴에 맞춤 로고 추가하기'를 참고하세요.
트레이스에서 Node.js 로그
Node.js API 프록시를 디버그할 때 API 프록시 편집기의 Trace 뷰에서 Node.js 로그 기능을 사용 설정할 수 있습니다. 이 기능을 사용 설정하려면 설치의 apigee-base.conf 또는 apigee-onpremise.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 가이드를 참고하세요.
특정 이메일 도메인에 대한 시스템 관리자 액세스 제한
sysadmin 또는 sysadmin 읽기 전용 역할의 멤버십을 특정 이메일 도메인의 사용자로 제한할 수 있습니다. 이 기능을 사용 설정하려면 비공개 클라우드 운영을 위한 Apigee Edge 가이드에 설명된 대로 허용된 도메인을 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 도구를 사용하면 이전에 저장한 Trace 세션을 보고 분석할 수 있습니다. 저장된 Trace 세션은 기본적으로 Trace 세션의 '레코딩'이며, 문제 해결 및 추가 분석이 필요한 경우에 유용합니다. 오프라인 Trace 도구의 UI는 '실시간' Trace 도구와 유사합니다.
자세한 내용은 오프라인 Trace 도구 사용을 참고하세요.
사용자 설정에 표시되는 사용자 역할
관리 UI의 사용자 설정 페이지 (사용자 이름 > 사용자 설정)에 사용자의 역할이 표시됩니다.
Edge 관리 UI 개선사항
이 버전에는 Edge 관리 UI의 여러 가지 소규모 사용성 및 일관성 개선사항이 포함되어 있습니다.
분석 서비스
다음은 Edge Analytics Services의 새로운 기능과 개선사항입니다.
6개월 동안의 데이터를 확인할 수 있습니다.
관리 UI 또는 API로 분석 보고서를 생성할 때 현재 날짜로부터 6개월 이상 오래된 데이터는 기본적으로 액세스할 수 없습니다. 6개월 이상 오래된 데이터에 액세스하려면 Apigee 지원팀에 문의하세요.
분석에 추가된 변수
다음과 같은 새 변수가 Edge 분석에 전달되며 API 프록시 트레이스 창의 AX 단계에 표시됩니다.
- apigee.edge.execution.is_target_error: API 오류가 타겟 측 오류 (값 '1')인지 또는 실패한 HTTP 응답의 타겟 외 오류(값 '0')인지 식별할 수 있습니다. HTTP 응답이 성공하면 값은 null입니다.
-
apigee.edge.execution.is_policy_error: 정책이 실패했는지 (값 '1') 또는 실패한 HTTP 응답에서 정책이 실패하지 않았는지 (값 '0') 식별할 수 있습니다. 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 프록시 및 대상의 오류율을 표시합니다. 오류 코드 분석 대시보드를 참고하세요.
-
다음과 같은 기존 대시보드의 이름이 변경되었습니다.
개발자 서비스
다음은 Edge 개발자 서비스의 새로운 기능과 개선사항입니다.
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 | Get an OAuth 2.0 authorization code API가 잘못된 상태를 반환함 |
| MGMT-1962 | 강력한 비밀번호로 관리 UI에 로그인할 때 오류 발생 백분율 기호와 같은 특정 특수문자로 UI에 로그인해도 더 이상 실패하지 않습니다. |
| MGMT-1894 | 개발자 앱 페이지의 개발자 열 로드가 완료되지 않음 |
| MGMT-1872 | 맞춤 보고서를 다운로드할 수 없음 |
| MGMT-1777 | TLD가 .acn인 이메일 주소를 사용하는 사용자를 추가할 수 없음 |
| MGMT-1362 | 이메일 주소에 '_'가 포함된 경우 비밀번호 찾기 이메일이 작동하지 않음 밑줄이 포함된 이메일 주소가 있는 비공개 클라우드의 비밀번호 재설정 문제를 수정합니다. |
| CORERT-613 | 'unrecognized_name'으로 인한 SSL 핸드셰이크 실패 |
| APIRT-1346 | OAuth2.0 - hash.oauth.tokens.enabled가 true이면 액세스 토큰 응답에 해싱된 값이 반환됨 |
이 출시에는 다음 출시의 버그 수정도 포함되어 있습니다.
| Edge Cloud | 프라이빗 클라우드용 Edge |
|---|---|
알려진 문제
이 출시에는 다음과 같은 알려진 문제가 있습니다.
| 문제 ID | 설명 |
|---|---|
| 해당 사항 없음 |
설치 프로그램이 수익 창출 설치 또는 업그레이드에 사용하는 두 개의 Cassandra 스크립트가 출시에 포함되지 않았습니다. 이 문제를 해결하려면 Cassandra 설치 또는 업그레이드 후 다음 명령어를 실행하여 수익 창출 설치/업그레이드를 완료하세요.
|
| CORERT-318 | 페이로드가 큰 (수백 KB) API 호출은 중단될 수 있습니다. 이 문제를 해결하려면 router.properties 파일에서 다음 속성 값을 설정합니다.HTTPServer.streaming.buffer.limit=0 (기본 설정은 10) |