15.05.27 - Примечания к выпуску облака Apigee Edge

Вы просматриваете документацию Apigee Edge .
Перейти к документации Apigee X. info

Во вторник, 2 июня 2015 года, мы выпустили новую облачную версию Apigee Edge.

Если у вас возникнут вопросы, обратитесь в службу поддержки Apigee Edge .

Список всех примечаний к выпуску Apigee Edge см. в разделе Примечания к выпуску Apigee .

Новые функции и улучшения

Ниже перечислены новые функции и улучшения в этой версии.

SmartDocs общедоступны

SmartDocs переходит из стадии бета-тестирования в стадию общедоступной версии. Обновления и новые функции включают:

• Поддержка Swagger 2.0, включая импорт по файлу или URL, включая поддержку именованных настраиваемых объектов безопасности.
• Улучшения визуального дизайна в шаблонах, формирующих SmartDocs.
• Улучшения удобства использования и рабочего процесса на портале разработчика, доступные через меню «Контент» > «SmartDocs» в Drupal.
• То, что раньше называлось аутентификацией с помощью «пользовательского токена», теперь называется «ключом API».
• Объекты «безопасности» аутентификации, определенные на уровне ревизии.
• Настройка аутентификации клиента на уровне шаблона. Новые версии больше не сбрасывают предварительно настроенные учётные данные клиента SmartDocs.

Более подробное описание функций смотрите в этой записи блога .

Документацию по SmartDocs см. в разделе Использование SmartDocs для документирования API .

Новая бета-версия редактора прокси API

Доступна новая бета-версия редактора прокси-API. Чтобы получить к ней доступ, нажмите ссылку «Перейти к бета-версии» при редактировании существующего прокси-API. Вы можете переключаться между «классическим» и «бета-редактором».

Новая политика OAuthV2

Новая политика DeleteOAuthV2Info позволяет удалять коды авторизации и токены доступа. Подробнее см. в разделе «Политика Delete OAuthV2 Info» .

Новые сущности в политике Access Entity

Политика Access Entity предоставляет доступ к следующим новым сущностям: consumerkey-scopes, authorizationcode, requesttoken и verifier. Подробнее см. в разделе Политика Access Entity .

Отображение SSL-сертификатов, срок действия которых скоро истечет

На странице «Сертификаты SSL» в пользовательском интерфейсе управления (Администрирование > Сертификаты SSL) отображается срок действия сертификатов SSL (10, 15, 30 или 90 дней) в зависимости от выбора в раскрывающемся поле нового срока действия.

Имя приложения разработчика отображается в пользовательском интерфейсе управления

Приложения для разработчиков в Edge имеют как внутреннее имя, которое не меняется, так и отображаемое имя, которое можно изменить. На странице приложения для разработчиков в интерфейсе управления (Публикация > Приложения для разработчиков > Имя приложения) внутреннее имя приложения отображается вместе с отображаемым именем, что упрощает визуальную идентификацию приложений по их внутренним именам для устранения неполадок и управления API.

Классическая версия пользовательских отчетов удаляется из интерфейса управления

Дополнительная классическая версия пользовательских аналитических отчетов больше не доступна в интерфейсе управления.

Процесс обновления SmartDocs

Если вы уже использовали SmartDocs в период бета-тестирования, для получения новых функций и возможностей в общедоступной версии вам потребуется обновить SmartDocs на портале разработчика.

Любые страницы SmartDocs, которые уже опубликованы на вашем портале разработчиков, продолжат работать, но вам необходимо будет пройти процедуру обновления, прежде чем редактировать или публиковать какие-либо изменения на существующих или новых страницах.

Имейте в виду, что, хотя вы можете визуализировать и публиковать документы SmartDocs внутри своего портала разработчика, они генерируются на основе модели API, которая находится в службах управления API Edge от Apigee. Любые изменения, вносимые вами в модель API в Edge, будут применяться во всех ваших средах Pantheon (аналогично тому, как разработчики работают в средах Pantheon).

Чтобы перейти с бета-версии SmartDocs на общедоступную версию

1. Обновите и протестируйте релиз 15.05.27 в ваших средах разработки или тестирования на Pantheon.
2. Создайте новую модель для замены любой существующей модели API, которую вы использовали.
   • Если вы импортировали документы Swagger или WADL, импортируйте их снова в новую версию.
   • Если вы поддерживали свою модель API через модуль SmartDocs, экспортируйте ее как SmartDocs JSON и импортируйте в новую модель, используя вложение файла.
3. Настройте параметры безопасности для версии вашей модели. На странице «Содержимое» > «SmartDocs» > «Модель» выберите «Параметры безопасности» .
   
4. Проверьте предварительно настроенную аутентификацию на странице настроек модели ( Содержание > SmartDocs ), нажав «Настройки» в столбце «Операции».
   
5. Обновите все пользовательские шаблоны, чтобы использовать CSS и JS-ресурсы версии 6, а также внесите изменения, отражающие новые имена объектов, такие как authSchemes и apiSchema. Информация об обновлении шаблонов SmartDocs приведена в разделе «Использование SmartDocs для документирования API» .
6. Повторно визуализируйте и опубликуйте версию модели.
7. После проверки новой документации обновите свой производственный портал до версии 15.05.27.

Если вы являетесь корпоративным клиентом Edge и у вас есть вопросы или сомнения по поводу процесса обновления, напишите на адреса marsh@apigee.com и cnovak@apigee.com. В противном случае, пожалуйста, воспользуйтесь поддержкой сообщества Apigee для получения наилучшего ответа.

Исправлены ошибки

В этом выпуске исправлены следующие ошибки.