Вы просматриваете документацию 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 выполните следующие команды, чтобы завершить установку/обновление системы монетизации:
|
| КОРЕРТ-318 | Вызовы API с большими объемами данных (сотни килобайт) иногда могут зависать. Чтобы обойти эту проблему, установите следующее значение свойства в файле router.properties:HTTPServer.streaming.buffer.limit=0 (значение по умолчанию — 10) |