4.15.04.00 — Примечания к выпуску Apigee Edge для частного облака

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

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

Прежнее название продукта «Apigee Edge On-premises» или «OPDK» теперь называется «Apigee Edge для частного облака».

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

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

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

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

OpenLDAP – установка и обновление

OpenLDAP теперь является единственным сервером LDAP, поддерживаемым Edge для новых установок и обновлений.

API-сервисы

Ниже приведены новые функции и улучшения в службах Edge API.

Вебсокеты

Чтобы обеспечить веб-связь в реальном времени между веб-клиентом и сервером, Edge поддерживает протокол WebSocket. Edge может играть роль клиента или сервера в коммуникации через WebSocket. Информацию о настройке и использовании WebSockets в Edge см. в руководстве Apigee Edge для частного облака с использованием WebSockets .

Поддержка внешнего поставщика аутентификации для управления API

Edge интегрируется с Active Directory и другими внешними поставщиками аутентификации/системами LDAP, которые содержат пользователей-администраторов API. Дополнительные сведения см. в руководстве по настройке внешней аутентификации Edge для частного облака .

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

Вы можете объединить пользовательский интерфейс управления Edge с собственным логотипом, который появится рядом с логотипом Apigee. Дополнительную информацию см. в разделе «Добавление собственного логотипа в меню пользовательского интерфейса Apigee» в Руководстве по эксплуатации Apigee Edge для частного облака .

Журналы Node.js в трассировке

При отладке прокси-серверов API Node.js вы можете включить функцию журнала Node.js в представлении трассировки редактора прокси-сервера API. Чтобы включить эту функцию, установите apigee.feature.disableNodeJSLogs="false" в файле apigee-base.conf или apigee-onpremise.conf вашей установки. Дополнительные сведения о журнале Node.js см. в разделе Отладка и устранение неполадок прокси-серверов Node.js.

Срок действия пароля

В Edge 4.15.01.x срок действия паролей Edge автоматически истекает через 30 дней. Это означало, что пользователь был заблокирован, если он не изменил свой пароль до истечения срока его действия. Однако это также привело к истечении срока действия пароля системного администратора, в результате чего системный администратор был заблокирован для Edge.

При обновлении до версии 4.15.04.00 значения по умолчанию изменяются, поэтому срок действия паролей не истекает. При необходимости вы можете настроить срок действия паролей Edge с помощью сценария /opt/apigee4/bin/apigee-enable-pwlockout.sh . Дополнительную информацию см. в Руководстве по эксплуатации Apigee Edge для частного облака .

Ограничение доступа системного администратора к определенным доменам электронной почты

Вы можете ограничить членство в ролях системного администратора или системного администратора только для чтения для пользователей в определенных доменах электронной почты. Чтобы включить эту функцию, добавьте разрешенные домены в файл apigee4/conf/apigee/management-server/security.properties, как описано в Руководстве по эксплуатации Apigee Edge для частного облака .

Сообщения об ошибках пользовательского интерфейса управления

Отображение сообщений об ошибках в пользовательском интерфейсе управления было переработано для более эффективного использования пространства экрана.

Новые переменные ошибки OAuthV2

Эти новые переменные, связанные с ошибками, устанавливаются политикой OAuthV2:

  • oauthV2.<имя-политики>.failed — установите значение true, если политика не удалась.
  • oauthv2.<имя_политики>.<имя_ошибки> — имя ошибки. Например, инвалид_запрос
  • oauthv2.<имя_политики>.<причина_ошибки> — причина ошибки. Например: Срок действия токена истек.

См. http://apigee.com/docs/api-services/content/oauthv2-policy .

Создание продукта

При создании нового продукта теперь помимо отображаемого имени можно указать имя продукта.

См. http://apigee.com/docs/developer-services/content/creating-api-products .

Пользовательский интерфейс для удаления пользователей из организации

На странице «Пользователи организации» в пользовательском интерфейсе кнопка «Удалить» была заменена кнопкой «Удалить». Это сделано для того, чтобы было понятно, что когда вы удаляете пользователя из организации, учетная запись Apigee этого пользователя остается активной.

См. http://apigee.com/docs/api-services/content/managing-organization-users .

Параметры фильтрации в пользовательском интерфейсе управления

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

Инструмент автономной трассировки

Инструмент автономной трассировки позволяет просматривать и анализировать ранее сохраненные сеансы трассировки. Сохраненный сеанс трассировки по сути представляет собой «запись» сеанса трассировки и может быть полезен в случаях, когда требуется устранение неполадок и дальнейший анализ. Пользовательский интерфейс инструмента автономной трассировки аналогичен инструменту «живой» трассировки.

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

Роли пользователей, отображаемые в настройках пользователя

На странице пользовательских настроек пользовательского интерфейса управления (имя пользователя > Настройки пользователя) теперь отображаются роли пользователя.

Улучшения пользовательского интерфейса Edge Management

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

Аналитические услуги

Ниже приведены новые функции и улучшения в Edge Analytics Services.

Доступны данные за шесть месяцев

При создании аналитических отчетов с помощью пользовательского интерфейса или API управления данные старше шести месяцев с текущей даты по умолчанию недоступны. Если вы хотите получить доступ к данным старше шести месяцев, обратитесь в службу поддержки Apigee .

Переменные добавлены в аналитику

Следующие новые переменные передаются в аналитику Edge и отображаются на этапе AX окна трассировки прокси-сервера API.

  • apigee.edge.execution.is_target_error — позволяет определить, являются ли ошибки API ошибками целевой стороны (значение «1») или нецелевыми ошибками для неудачных ответов HTTP (значение «0»). Значение равно нулю для успешного ответа HTTP.
  • apigee.edge.execution.is_policy_error — позволяет определить, произошла ли ошибка политики (значение «1») или нет сбоя политики в случае неудачного ответа HTTP (значение «0»). Значение равно нулю для успешного ответа HTTP.
    Следующие связанные переменные предоставляют подробную информацию о политике, которая потерпела неудачу первой. Значения равны нулю, если ни одна политика не привела к сбою.
    • apigee.edge.execution.fault_policy_name — имя политики, в которой произошел сбой.
    • apigee.edge.execution.fault_flow_name — имя потока в политике, в которой произошел сбой (например, PreFlow, PostFlow или пользовательский поток).
    • apigee.edge.execution.fault_flow_state — место, где политика была прикреплена к потоку. Возможные значения: PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW, PROXY_RESP_FLOW.

Панели мониторинга

  • Диаграммы производительности для API, разработчиков, продуктов и приложений для разработчиков были перемещены. Раньше они отображались внизу главных страниц этих организаций. Теперь вы можете получить доступ к диаграммам, выбрав вкладку «Аналитика» вверху каждой страницы.
  • Этот выпуск включает в себя основную работу над следующими существующими или новыми панелями мониторинга:
    • Панель управления Apigee (пересмотренная): включает три диаграммы показателей: трафик прокси, взаимодействие с разработчиками и приложения для разработчиков. Каждая диаграмма предоставляет более подробное представление, позволяющее детализировать каждую метрику. См. панель мониторинга Apigee .
    • Производительность прокси-сервера (новое): показывает шаблоны трафика прокси-сервера API и время обработки. Заменяет панель мониторинга производительности прокси-сервера API. См. Производительность прокси-сервера API .
    • Состав трафика (пересмотренный): Полностью переработанный внешний вид и содержимое информационной панели. Измеряет относительный вклад ваших лучших API, приложений, разработчиков и продуктов в вашу общую программу API. См. Состав трафика .
    • Анализ ошибок (пересмотренный): полностью переработанный внешний вид и содержание. Показывает частоту ошибок для прокси-серверов и целей API. См . Панель мониторинга анализа кодов ошибок .
  • Эти существующие панели мониторинга были переименованы:
    • Производительность конечной точки была переименована в Целевую производительность : показывает шаблоны трафика и показатели производительности для целевых серверных частей прокси-сервера API. См. «Целевая производительность» .
    • Взаимодействие с партнерами было переименовано в Взаимодействие с разработчиками . Показывает, какие из ваших зарегистрированных разработчиков приложений генерируют наибольший трафик API. По каждому из ваших разработчиков вы можете узнать, кто генерирует больше всего трафика API и больше всего ошибок. См. раздел «Взаимодействие с разработчиками» .

Услуги для разработчиков

Ниже приведены новые функции и улучшения в Edge Developer Services.

Поддержка Swagger 2.0 для SmartDocs

SmartDocs поддерживает импорт документов спецификаций Swagger 2.0 и поддерживает обратную совместимость со Swagger 1.2. Поддержка объектов схемы безопасности и централизованных схем будет доступна в более поздней версии.

Монетизация

Ниже приведены новые функции и улучшения монетизации Edge. Дополнительную информацию о монетизации см. в разделе «Известные проблемы».

Раздельная работа с компаниями и застройщиками

Компании и разработчики теперь обрабатываются отдельно, что обеспечивает большую гибкость при добавлении нескольких компаний к разработчикам и нескольких разработчиков к компаниям. Пользовательский интерфейс управления теперь предоставляет отдельные окна для «Компаний» и «Разработчиков» (доступны из меню «Опубликовать»).

См. раздел Управление компаниями и разработчиками .

В отчетах о монетизации компании остаются основным фильтром, хотя метка фильтра изменилась с «Разработчики» на «Компании».

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

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

Идентификатор проблемы Описание
ОПДК-954 4.15.01 Схема Cassandra не обновляется
МГМТ-1986 Ошибка пользовательского интерфейса при добавлении разработчика
МГМТ-1983 Получите код авторизации OAuth 2.0. API возвращает неправильный статус.
МГМТ-1962 Ошибка входа в интерфейс управления с использованием надежного пароля.
Вход в пользовательский интерфейс с использованием определенных специальных символов, таких как знак процента, больше не завершается неудачно.
МГМТ-1894 Страница приложений разработчика никогда не завершает загрузку столбца разработчика
МГМТ-1872 Невозможно загрузить пользовательские отчеты
МГМТ-1777 Невозможно добавить пользователя с адресом электронной почты, который имеет TLD .acn.
МГМТ-1362 Электронная почта о забытом пароле не работает, если адрес электронной почты содержит «_»
Устраняет проблему сброса пароля в частном облаке с адресами электронной почты, содержащими подчеркивание.
КОРЕТ-613 Ошибки подтверждения SSL из-за «unrecounced_name»
АПИРТ-1346 OAuth2.0 – хешированное значение возвращается в ответе токена доступа, если hash.oauth.tokens.enabled имеет значение true.

Этот выпуск также содержит исправления ошибок из следующих выпусков:

Граничное облако Edge для частного облака

Известные проблемы

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

Идентификатор проблемы Описание
Н/Д

Два скрипта Cassandra, которые установщик использует при монетизационной установке или обновлении, не были включены в выпуск.

Чтобы обойти эту проблему, выполните следующие команды после установки или обновления Cassandra, чтобы завершить установку/обновление монетизации:

  • apigee4/share/apache-cassandra/bin/cassandra-cli -h {host} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/360-company-developers.txt
  • apigee4/share/apache-cassandra/bin/cassandra-cli -h {host} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/320-update-notification-service_item.txt
КОРЕТ-318 Вызовы API с большими полезными нагрузками (100 КБ) иногда могут зависать. Чтобы обойти эту проблему, установите следующее значение свойства в файле router.properties:
HTTPServer.streaming.buffer.limit=0 (значение по умолчанию — 10)