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 .

Новые сущности в политике доступа к сущностям

Политика доступа к сущностям предоставляет доступ к следующим новым сущностям: consumerkey-scopes, authorizationcode, requesttoken и verifier. Для получения дополнительной информации см. раздел «Политика доступа к сущностям» .

Отображение 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, экспортируйте ее в формате JSON SmartDocs и импортируйте в новую модель, прикрепив файл.
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 для получения наиболее полного ответа.

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

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