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 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 для частного облака .

Ограничение доступа системных администраторов к определенным почтовым доменам.

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

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

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

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

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

  • oauthV2.<policy-name>.failed - Устанавливается в значение true, если политика не была выполнена.
  • oauthv2.<policy_name>.<fault_name> - Название ошибки. Например, invalid_request
  • oauthv2.<policy_name>.<fault_cause> - Причина ошибки. Например: Срок действия токена истек.

См. 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.

Аналитические сервисы

Ниже перечислены новые функции и улучшения в 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 Ошибка при входе в пользовательский интерфейс управления с использованием надежного пароля.
Теперь вход в пользовательский интерфейс с использованием определенных специальных символов, таких как знак процента, больше не приводит к ошибкам.
MGMT-1894 Страница приложений для разработчиков постоянно загружается, особенно в столбце для разработчиков.
MGMT-1872 Не удается загрузить пользовательские отчеты.
MGMT-1777 Невозможно добавить пользователя с адресом электронной почты, имеющим домен верхнего уровня .acn.
MGMT-1362 Функция восстановления пароля по электронной почте не работает, если в адресе электронной почты содержится символ '_'.
Исправлена ​​проблема сброса пароля в частном облаке, связанная с адресами электронной почты, содержащими символ подчеркивания.
КОРЕРТ-613 Сбои при установлении SSL-соединения из-за "нераспознанного имени"
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 {host} -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)