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