Apigee Edge 문서입니다.
Go to the
Apigee X 문서로 이동합니다. info
2015년 5월 19일 화요일에 Apigee Edge for Private Cloud의 분기별 버전이 출시되었습니다.
이전 제품 이름 "Apigee Edge 온프레미스" 또는 "OPDK"가 이제 "Apigee Edge for Private Cloud"입니다.
궁금한 점이 있으면 Apigee Edge 지원팀에 문의하세요.
모든 Apigee Edge 출시 노트 목록은 Apigee 출시 노트를 참조하세요.
새로운 기능 및 개선사항
이번 출시 버전의 새로운 기능과 향상된 기능은 다음과 같습니다.
OpenLDAP - 설치 및 업그레이드
이제 OpenLDAP는 신규 및 업그레이드 설치를 위해 Edge에서 지원하는 유일한 LDAP 서버입니다.
API 서비스
다음은 Edge API 서비스의 새로운 기능과 개선사항입니다.
WebSockets
웹 클라이언트와 서버 간의 실시간 웹 통신을 사용 설정하기 위해 Edge는 WebSocket 프로토콜을 지원합니다. Edge는 WebSocket 통신에서 클라이언트 또는 서버 역할을 할 수 있습니다. Edge에서 WebSocket을 설정하고 사용하는 방법에 대한 자세한 내용은 Apigee Edge for Private Cloud Using WebSockets 가이드를 참조하세요.
API 관리를 위한 외부 인증 제공업체 지원
Edge는 API 관리 사용자가 포함된 Active Directory 및 기타 외부 인증 제공업체/LDAP 시스템과 통합됩니다. 자세한 내용은 Edge for Private Cloud External Authentication Configuration 가이드를 참조하세요.
관리 UI의 공동 브랜딩
Apigee 로고 옆에 표시되는 자체 맞춤 로고로 Edge 관리 UI를 공동 브랜딩할 수 있습니다. 자세한 내용은 Apigee Edge for Private Cloud Operations Guide의 "Apigee UI 메뉴에 맞춤 로고 추가" 를 참조하세요.
Trace의 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 for Private Cloud Operations Guide를 참조하세요.
특정 이메일 도메인에 대한 시스템 관리자 액세스 제한
시스템 관리자 또는 시스템 관리자 읽기 전용 역할의 멤버십을 특정 이메일 도메인의 사용자로 제한할 수 있습니다. 이 기능을 사용 설정하려면 허용된 도메인을 apigee4/conf/apigee/management-server/security.properties 파일에 추가합니다. Apigee Edge for Private Cloud Operations Guide에 설명되어 있습니다.
관리 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 분석 서비스의 새로운 기능과 개선사항입니다.
6개월 동안의 데이터 사용 가능
관리 UI 또는 API로 분석 보고서를 생성할 때 현재 날짜로부터 6개월 이상 오래된 데이터는 기본적으로 액세스할 수 없습니다. 6개월 이상 오래된 데이터에 액세스하려면 Apigee Edge 지원팀에 문의하세요.
분석에 변수 추가
다음과 같은 새로운 변수가 Edge 분석에 전달되며 API 프록시 trace 창의 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는 '회사' 및 '개발자'(Publish 메뉴에서 액세스 가능)를 위한 별도의 창을 제공합니다.
회사 및 개발자 관리를 참조하세요.
수익 창출 보고서에서 회사 이름은 '개발자'에서 '회사'로 변경되었지만 회사는 기본 필터로 유지됩니다.
수정된 버그
다음은 이번 출시 버전에서 수정된 버그입니다.
| 문제 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 | .acn TLD가 있는 이메일 주소로 사용자를 추가할 수 없음 |
| MGMT-1362 | 이메일 주소에
'_' 가 포함된 경우 비밀번호 찾기 이메일이 작동하지 않음 밑줄이 포함된 이메일 주소로 프라이빗 클라우드에서 비밀번호 재설정 문제를 해결합니다. |
| CORERT-613 | 'unrecognized_name'으로 인한 SSL 핸드셰이크 실패 |
| APIRT-1346 | OAuth2.0 - hash.oauth.tokens.enabled가 true인 경우 액세스 토큰 응답에서 해시된 값이 반환됨 |
이번 출시 버전에는 다음 출시 버전의 버그 수정도 포함되어 있습니다.
| Edge Cloud | Edge for Private Cloud |
|---|---|
알려진 문제
이번 출시 버전에는 다음과 같은 알려진 문제가 있습니다.
| 문제 ID | 설명 |
|---|---|
| 해당 사항 없음 |
설치 프로그램이 수익 창출 설치 또는 업그레이드에 사용하는 두 개의 Cassandra 스크립트가 출시 버전에 포함되지 않았습니다. 이 문제를 해결하려면 Cassandra 설치 또는 업그레이드 후 다음 명령어를 실행하여 수익 창출 설치/업그레이드를 완료합니다.
|
| CORERT-318 | 페이로드가 큰 (수백 KB) API 호출이 때때로 중단될 수 있습니다. 이 문제를 해결하려면 router.properties 파일에서 다음 속성 값을 설정합니다.
HTTPServer.streaming.buffer.limit=0 (기본 설정은 10) |