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

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

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

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

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

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

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

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

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

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

API-сервисы

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

Веб-сокеты

Для обеспечения веб-коммуникаций в режиме реального времени между веб-клиентом и сервером Edge поддерживает протокол WebSocket. Edge может выступать как клиентом, так и сервером в WebSocket-коммуникациях. Сведения о настройке и использовании WebSocket в Edge см. в руководстве Apigee Edge for Private Cloud Using WebSocket .

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

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

Совместный брендинг в интерфейсе управления

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

Логи Node.js в Trace

При отладке прокси-серверов API Node.js вы можете включить функцию журнала Node.js в представлении Trace редактора прокси-сервера 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 for Private Cloud .

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

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

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

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

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

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

  • oauthV2.<имя-политики>.failed — установите значение true, если политика не выполнена.
  • oauthv2.<имя_политики>.<имя_ошибки> — имя ошибки. Например, invalid_request.
  • 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-прокси, продуктов, разработчиков и приложений в пользовательском интерфейсе управления доступны новые параметры фильтрации для поиска.

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

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

Более подробную информацию см. в разделе Использование инструмента Offline Trace .

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

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

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

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

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

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

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

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

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

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

  • apigee.edge.execution.is_target_error — позволяет определить, являются ли ошибки API ошибками целевой стороны (значение «1») или нецелевыми ошибками, связанными с неудачными HTTP-ответами (значение «0»). Значение равно null для успешного HTTP-ответа.
  • apigee.edge.execution.is_policy_error — позволяет определить, была ли политика не выполнена (значение «1») или не было ни одной политики в случае неуспешного HTTP-ответа (значение «0»). Значение равно null в случае успешного 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 API получения кода авторизации OAuth 2.0 возвращает неверный статус
МГМТ-1962 Ошибка входа в пользовательский интерфейс управления с надежным паролем
Вход в пользовательский интерфейс с использованием некоторых специальных символов, таких как знак процента, больше не приводит к сбою.
МГМТ-1894 Страница «Приложения для разработчиков» никогда не загружается до конца для колонки разработчиков
МГМТ-1872 Невозможно загрузить пользовательские отчеты
МГМТ-1777 Невозможно добавить пользователя с адресом электронной почты, имеющим домен верхнего уровня .acn.
МГМТ-1362 Письмо с сообщением «Забыли пароль?» не будет работать, если адрес электронной почты содержит «_».
Устранена проблема сброса пароля в частном облаке с адресами электронной почты, содержащими символ подчеркивания.
КОРЕРТ-613 Сбои SSL-соединения из-за «unrecognized_name»
APIRT-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 {хост} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/320-update-notification-service_item.txt
КОРЕРТ-318 Вызовы API с большими объёмами данных (сотни килобайт) иногда могут зависать. Чтобы обойти эту проблему, задайте следующее значение свойства в файле router.properties:
HTTPServer.streaming.buffer.limit=0 (значение по умолчанию — 10)