현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보
2015년 6월 2일 화요일에 새로운 클라우드 버전의 Apigee Edge를 출시했습니다.
궁금한 점이 있으면 Apigee 고객 지원으로 이동하세요.
Apigee Edge 출시 노트의 전체 목록은 Apigee 출시 노트를 참조하세요.
새로운 기능 및 개선사항
다음은 이번 버전의 새로운 기능 및 개선사항입니다.
SmartDocs 정식 버전
SmartDocs가 베타 버전에서 정식 버전으로 출시됩니다. 업데이트 및 새로운 기능은 다음과 같습니다.
- 커스텀 이름이 지정된 보안 객체 지원을 포함하여 파일 또는 URL로 가져오기를 포함한 Swagger 2.0 지원
- SmartDocs를 생성하는 템플릿의 시각적 디자인이 개선되었습니다.
- Drupal의 콘텐츠 > SmartDocs 메뉴를 통해 개발자 포털의 사용성 및 워크플로 개선사항을 확인할 수 있습니다.
- '커스텀 토큰' 인증으로 알려진 인증을 이제 'API 키'라고 합니다.
- 버전 수준에서 정의된 인증 '보안' 객체입니다.
- 템플릿 수준에서 클라이언트 인증 구성입니다. 새 버전에서 더 이상 사전 구성된 SmartDocs 클라이언트 사용자 인증 정보가 재설정되지 않습니다.
자세한 기능 설명은 이 블로그 게시물을 참조하세요.
SmartDocs 문서는 SmartDocs를 사용하여 API 문서화를 참고하세요.
새로운 API 프록시 편집기 베타
API 프록시 편집기의 새로운 베타 버전을 사용할 수 있습니다. 액세스하려면 기존 API 프록시를 수정할 때 '베타 버전에 액세스' 링크를 클릭하세요. '기본' 편집기와 '베타' 편집기 간에 전환할 수 있습니다.
새 OAuthV2 정책
새 DeleteOAuthV2Info 정책을 사용하면 승인 코드 및 액세스 토큰을 삭제할 수 있습니다. 자세한 내용은 OAuthV2 정보 정책 삭제를 참고하세요.
항목 액세스 정책의 새 항목
액세스 항목 정책은 Consumerkey-scopes, Authorizationcode, requesttoken, verifier와 같은 새로운 항목에 대한 액세스를 제공합니다. 자세한 내용은 항목 정책 액세스를 참조하세요.
만료가 임박한 SSL 인증서 표시
관리 UI의 SSL 인증서 페이지 (관리 > SSL 인증서)에는 새 만료 드롭다운 필드에서 선택한 사항에 따라 SSL 인증서가 10일, 15일, 30일 또는 90일 이내에 만료되는 날짜가 표시됩니다.
관리 UI에 표시된 개발자 앱 이름
Edge의 개발자 앱에는 변경되지 않는 내부 이름과 변경할 수 있는 표시 이름이 모두 있습니다. 관리 UI의 개발자 앱 페이지 (게시 > 개발자 앱 > 앱 이름)에는 앱 내부 '이름'이 '표시 이름'과 함께 표시되므로 문제 해결 및 API 관리를 위해 내부 이름으로 앱을 시각적으로 쉽게 식별할 수 있습니다.
관리 UI에서 삭제되는 기존 버전의 맞춤 보고서
커스텀 애널리틱스 보고서의 기본 버전(선택사항)은 더 이상 관리 UI에서 사용할 수 없습니다.
SmartDocs 업그레이드 프로세스
베타 기간 동안 이미 SmartDocs를 사용했다면 일반 안정화 버전의 새로운 기능을 사용하려면 개발자 포털에서 SmartDocs를 업그레이드해야 합니다.
개발자 포털에 이미 게시된 SmartDocs 페이지는 계속 작동하지만 기존 페이지 또는 새 페이지의 변경사항을 수정하거나 게시하기 전에 업데이트 프로세스를 따라야 합니다.
개발자 포털 내에서 SmartDocs를 렌더링하고 게시할 수 있지만 SmartDocs는 Apigee의 Edge API 관리 서비스 내에 있는 API 모델에서 생성됩니다. Edge에서 API 모델을 변경하면 모든 Pantheon 환경에서 동일하게 유지됩니다 (개발자가 Pantheon 환경 전반에 걸쳐 존재하는 방식과 유사함).
SmartDocs 베타에서 정식 버전으로 업그레이드하기
- Pantheon의 dev 또는 test 환경에서 15.05.27 버전을 업데이트하고 테스트합니다.
- 사용하고 있는 기존 API 모델을 대체할 새 모델을 만듭니다.
- Swagger 또는 WADL 문서를 가져온 경우 새 버전으로 다시 가져오세요.
- SmartDocs 모듈을 통해 API 모델을 유지해 온 경우 SmartDocs JSON으로 내보내고 파일 첨부파일을 사용하여 새 모델로 가져옵니다.
- 모델 버전의 보안 속성을 설정합니다. 콘텐츠 > SmartDocs > 모델 페이지에서 보안 설정을 선택합니다.
- 모델 설정 페이지 (콘텐츠 > SmartDocs)에서 작업 열의 설정을 클릭하여 사전 구성된 인증을 확인합니다.
- CSS 및 JS 애셋 v6를 사용하도록 맞춤 템플릿을 업데이트하고 authSchemes 및 apiSchema와 같은 새 객체 이름을 반영하도록 변경합니다. SmartDocs 템플릿 업데이트에 관한 자세한 내용은 SmartDocs를 사용하여 API 문서화를 참조하세요.
- 모델 버전을 다시 렌더링하고 게시합니다.
- 새 문서를 검증한 후 프로덕션 포털을 15.05.27 출시 버전으로 업데이트합니다.
에지 엔터프라이즈 고객이며 업그레이드 프로세스에 대해 궁금한 점이나 우려사항이 있으면 marsh@apigee.com 및 cnovak@apigee.com으로 이메일을 보내 주십시오. 그렇지 않다면 Apigee 커뮤니티를 이용하면 최선의 답변을 받으실 수 있습니다.
수정된 버그
다음은 이번 출시 버전에서 수정된 버그입니다.
| 문제 ID | 설명 |
|---|---|
| TBD-72 | 메시지 로깅 정책 문제 |
| MGMT-2124 | UI에 권한을 저장하면 고객 역할의 권한이 재설정됩니다. |
| MGMT-2048 | 배포 권한을 하나의 환경으로 제한하는 커스텀 역할이 있는 사용자가 다른 환경에 배포할 수 있음 |
| MGMT-2041 | 기본 첨부파일 템플릿에서 FaultRules 요소 삭제 정책 또는 API 프록시 단계에서 사용되지 않는 FaultRules 요소는 API 프록시를 만들거나 정책을 추가할 때 더 이상 자동으로 추가되지 않습니다. |
| MGMT-2034 | 가져오기 WSDL에서 실패: '가져오기 WSDL 오류: WSDL을 처리하는 중에 오류가 발생했습니다.' |
| MGMT-1812 | 가져오기 중에 TargetEndpoint 유효성 검사 추가 ProxyEndpoint와 마찬가지로, TargetEndpoint는 API 프록시를 가져오는 동안 조건에 사용되는 적절한 스키마와 표현식에 대해 검증됩니다. |
| MGMT-1345 | 네임스페이스가 여러 개인 WSDL을 가져오면 빌드 SOAP 단계가 잘못됨 |
| MGMT-800 | 'default'라는 이름을 가진 리소스를 만들면 UI가 손상됨 |
| MGMT-602 | API 프록시 개발 보기: 엔드포인트에 PreFlow/PostFlow가 없는 경우 오류 발생 시 응답 캐시 정책 추가 |
| MGMT-460 | 정책 이름을 변경하면 문제가 발생하여 삭제할 수 없는 정책 중복 발생 |
| DEVRT-1565 | 청구의 경우 15분 간격 |
| AXAPP-1728 | 분석에서 수익 창출 변수 무시 |
| AXAPP-1690 | 맞춤 보고서의 '잘못된 API 오류' |
| AXAPP-1533 | 애널리틱스 Geomap에서 잘못된 API 호출 오류가 발생함 |
| APIRT-52 | 맞춤 보고서: 여러 API의 응답 상태 코드가 null임 |