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

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

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

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

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

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

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

Общая доступность SmartDocs

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

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

Дополнительные описания функций см. в этой записи блога .

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

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

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

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

Новая политика DeleteOAuthV2Info позволяет удалять коды авторизации и токены доступа. Дополнительные сведения см. в разделе Удаление политики информации OAuthV2 .

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

Политика Access Entity обеспечивает доступ к следующим новым объектам: области потребительских ключей, код авторизации, токен запроса и верификатор. Дополнительные сведения см. в разделе Политика доступа к объектам .

Показаны SSL-сертификаты, срок действия которых истекает

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

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

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

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

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

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

Если вы уже использовали 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 для получения наилучшего ответа.

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

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