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 인증서 페이지에는 새 만료 드롭다운 필드에서 선택한 값에 따라 10일, 15일, 30일 또는 90일 이내에 SSL 인증서가 만료되는 시점이 표시됩니다.
관리 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 버전으로 업데이트합니다.
Edge Enterprise 고객이 업그레이드 프로세스에 관해 질문이나 우려사항이 있는 경우 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임 |