Вы просматриваете документацию по Apigee Edge.
Перейдите к документации по Apigee X. Информация
Во вторник, 19 мая 2015 г., мы выпустили квартальную версию Apigee Edge для частного облака.
Продукт, ранее называвшийся Apigee Edge On-premises или OPDK, теперь называется Apigee Edge для частного облака.
Если у вас возникли вопросы, обратитесь в службу поддержки Apigee Edge.
Список всех примечаний к выпуску Apigee Edge приведен на странице Примечания к выпуску Apigee.
Новые функции и улучшения
Ниже перечислены новые функции и улучшения в этом выпуске.
OpenLDAP – установка и обновление
Теперь Edge поддерживает только сервер OpenLDAP для новых и обновленных установок.
Сервисы API
Ниже перечислены новые функции и улучшения в сервисах Edge API.
WebSockets
Чтобы обеспечить обмен данными в реальном времени между веб-клиентом и сервером, Edge поддерживает протокол WebSocket. Edge может выступать в роли клиента или сервера при обмене данными по протоколу WebSocket. Информацию о настройке и использовании WebSockets в Edge можно найти в руководстве Apigee Edge для частного облака с использованием WebSockets.
Поддержка внешнего поставщика аутентификации для управления API
Edge интегрируется с Active Directory и другими внешними поставщиками аутентификации/системами LDAP, которые содержат администраторов API. Дополнительную информацию можно найти в руководстве Настройка внешней аутентификации Edge для частного облака.
Кобрендинг в интерфейсе управления
Вы можете добавить в интерфейс управления Edge свой логотип, который будет показываться рядом с логотипом Apigee. Дополнительную информацию можно найти в разделе "Добавление собственного логотипа в меню интерфейса Apigee" Руководства по эксплуатации Apigee Edge для частного облака.
Журналы Node.js в Trace
При отладке прокси-серверов API Node.js можно включить функцию журнала Node.js в представлении трассировки редактора прокси-сервера API. Чтобы включить эту функцию, задайте значение apigee.feature.disableNodeJSLogs="false" в файле apigee-base.conf или apigee-onpremise.conf в вашей установке. Подробнее об отладке и устранении неполадок прокси-серверов 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.<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 Proxies, Products, Developers и Apps в интерфейсе управления доступны новые варианты фильтрации для поиска.
Инструмент "Трассировка офлайн"
Инструмент "Офлайн-трассировка" позволяет просматривать и анализировать ранее сохраненные сеансы трассировки. Сохраненный сеанс трассировки – это запись сеанса трассировки, которая может быть полезна при устранении неполадок и дальнейшем анализе. Интерфейс инструмента "Офлайн-трассировка" похож на интерфейс инструмента "Трассировка в реальном времени".
Подробнее о том, как использовать инструмент Offline Trace…
Роли пользователей, отображаемые в настройках пользователя
На странице пользовательских настроек в интерфейсе управления (имя пользователя > Пользовательские настройки) теперь отображаются роли пользователя.
Улучшения интерфейса управления Edge
В этой версии улучшено удобство использования и согласованность интерфейса управления Edge.
Сервисы аналитики
Ниже перечислены новые функции и улучшения в сервисах Edge Analytics.
Доступны данные за шесть месяцев
При создании отчетов Аналитики с помощью интерфейса управления или API по умолчанию недоступны данные, которые старше шести месяцев с текущей даты. Если вам нужны данные старше шести месяцев, обратитесь в службу поддержки Apigee Edge.
Переменные, добавленные в аналитику
В аналитику Edge передаются следующие новые переменные, которые можно посмотреть на этапе AX в окне трассировки прокси API.
- apigee.edge.execution.is_target_error – позволяет определить, являются ли ошибки API целевыми (значение "1") или нецелевыми для неудачных HTTP-ответов (значение "0"). Если HTTP-ответ был успешным, значение будет нулевым.
-
apigee.edge.execution.is_policy_error – позволяет определить, произошла ли ошибка в правиле (значение "1") или в неудачном HTTP-ответе не было ошибок в правилах (значение "0"). Для успешного HTTP-ответа значение равно null.
Следующие связанные переменные содержат сведения о правиле, которое не удалось применить первым. Если ни одно правило не нарушено, значения будут нулевыми.- 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. Для каждого разработчика можно узнать, кто генерирует больше всего трафика API и ошибок. Подробнее о взаимодействии с разработчиками…
Сервисы для разработчиков
Ниже перечислены новые функции и улучшения в сервисах для разработчиков Edge.
Поддержка Swagger 2.0 для SmartDocs
SmartDocs поддерживает импорт документов спецификации Swagger 2.0 и сохраняет обратную совместимость со Swagger 1.2. Поддержка объектов схемы безопасности и централизованных схем будет добавлена в более поздней версии.
Монетизация
Ниже перечислены новые функции и улучшения в монетизации Edge. Также ознакомьтесь с разделом "Известные проблемы", чтобы узнать больше о монетизации.
Раздельное управление компаниями и разработчиками
Теперь компании и разработчики обрабатываются отдельно, что позволяет более гибко добавлять несколько компаний к разработчикам и несколько разработчиков к компаниям. В интерфейсе управления теперь есть отдельные окна для компаний и разработчиков (доступны в меню "Публикация").
Подробнее об управлении компаниями и разработчиками…
В отчетах о монетизации компании по-прежнему являются основным фильтром, хотя его название изменилось с "Разработчики" на "Компании".
Исправлены ошибки
В этой версии исправлены следующие ошибки:
| Идентификатор проблемы | Описание |
|---|---|
| OPDK-954 | 4.15.01 Схема Cassandra не обновлена |
| MGMT-1986 | Ошибка интерфейса при добавлении разработчика |
| MGMT-1983 | API для получения кода авторизации OAuth 2.0 возвращает неверный статус |
| MGMT-1962 | Ошибка при входе в интерфейс управления с надежным паролем Вход в интерфейс с использованием определенных специальных символов, например знака процента, больше не приводит к ошибке. |
| MGMT-1894 | Страница "Приложения разработчика" не загружается до конца для столбца "Разработчик" |
| MGMT-1872 | Не удается скачать специальные отчеты |
| MGMT-1777 | Невозможно добавить пользователя с адресом электронной почты, в котором используется домен верхнего уровня .acn |
| MGMT-1362 | Письмо для восстановления пароля не работает, если адрес электронной почты содержит символ подчеркивания. Исправлена проблема со сбросом пароля в частном облаке, возникающая при использовании адресов электронной почты, содержащих символ подчеркивания. |
| CORERT-613 | Сбои рукопожатия SSL из-за ошибки "unrecognized_name" |
| APIRT-1346 | OAuth2.0 – хешированное значение возвращается в ответе с токеном доступа, если hash.oauth.tokens.enabled имеет значение true |
В этой версии также исправлены ошибки из следующих выпусков:
| Edge Cloud | Edge для частного облака |
|---|---|
Известные проблемы
В этом выпуске есть следующие известные проблемы.
| Идентификатор проблемы | Описание |
|---|---|
| Н/Д |
В релиз не вошли два скрипта Cassandra, которые установщик использует при монетизации установки или обновления. Чтобы обойти эту проблему, после установки или обновления Cassandra выполните следующие команды, чтобы завершить установку или обновление монетизации:
|
| CORERT-318 | Вызовы API с большими полезными нагрузками (сотни КБ) иногда могут зависать. Чтобы обойти эту проблему, задайте в файле router.properties следующее значение свойства:HTTPServer.streaming.buffer.limit=0 (по умолчанию установлено значение 10). |