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

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

29 июля 2021 г. мы выпустили версию 4.51.00 Edge для частного облака.

Сводка по выпуску

В таблице ниже приведены основные изменения в этой версии.

Новые функции

В этом выпуске добавлены следующие новые функции:

○ Новое всплывающее окно с предупреждением о датах окончания поддержки
○ Возможность выхода из аккаунта при смене пароля
○ Настройка версии TLS для SMTP
○ Добавлен улучшенный pg-data-purgeскрипт для удаления данных из родительских таблиц фактов
○ Добавлен sosreport – новый инструмент диагностики и сбора данных на уровне системы.

Подробнее о новых функциях…
Обратная совместимость

В этой версии Apigee Edge для частного облака появились следующие проблемы, влияющие на обратную совместимость:

  • Расширения для управления Java (JMX) больше не включены по умолчанию для модуля Apigee SSO (система единого входа).
  • В связи с исправлением проблемы 132443137 (как описано в примечаниях к выпуску общедоступной облачной версии 19.03.01) процессоры сообщений теперь игнорируют заголовки, которые начинаются с X-Apigee-*. Поэтому вам нужно переработать код, в котором используются заголовки X-Apigee-*, и заменить их на поддерживаемые.

  • Изменилось название файлов журнала Cassandra. Сейчас:

    /opt/apigee/var/log/apigee-cassandra/system.log
Включенные релизы

С момента выхода предыдущей версии Edge для частного облака были выпущены следующие версии, которые включены в эту версию:

○ Edge:
   20.08.03 (маршрутизатор)
   20.09.18 (сервер управления)
   21.03.08 (маршрутизатор, сервер управления, обработчик сообщений)
Упразднение Нет
Прекращение поддержки

В версии 4.51.00:

  • 4.19.06: Версия 4.19.06 Apigee Edge для частного облака больше не поддерживается.

Более подробную информацию о прекращении поддержки, в том числе о сроках удаления, можно найти в статье Прекращение поддержки и вывод из эксплуатации продуктов Apigee.
Известные проблемы

В этой версии есть следующие известные проблемы:

Подробнее об известных проблемах…

Варианты перехода

Инструкции по обновлению до версии Edge для частного облака 4.51.00 приведены в статье Обновление Apigee Edge 4.19.06 или 4.50.00 до версии 4.51.00.

Новые функции

В этом разделе перечислены новые функции, добавленные в этом выпуске. Кроме того, в этот выпуск включены все функции, которые были добавлены в выпуски Edge UI, Edge Management и Portal, перечисленные в разделе Включенные выпуски.

Помимо перечисленных ниже улучшений, в этой версии также повышена удобство использования, производительность, безопасность и стабильность.

Новое всплывающее окно с предупреждением о датах окончания поддержки Edge для частного облака

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

Новый параметр для выхода из аккаунтов пользователей при смене паролей

В apigee.feature.clearSessionOnPasswordUpdate добавлен новый флаг, который позволяет настроить, будет ли пользователь выходить из системы после смены пароля. По умолчанию пользователи не выходят из аккаунта.

Новый флаг для настройки версии TLS для SMTP

В mail.smtp.ssl.protocols добавлен новый флаг, который указывает протокол SSL, включенный для подключений SMTP. Эта функция позволяет настраивать протоколы SSL в соответствии с вашими требованиями к безопасности.

Чтобы задать этот флаг, добавьте в файл свойств следующую запись:/opt/apigee/customer/application/ui.properties

conf_apigee.mail.smtp.ssl.protocols=ssl-protocol

Возможные значения для ssl-protocol: SSLv2Hello, SSLv3, TLSv1, TLSv1.1 и TLSv1.2.

Новый инструмент диагностики sosreport

Добавлен инструмент Sosreport для диагностики на уровне системы и сбора данных.

Добавлена поддержка новых версий ПО

В Apigee добавлена поддержка следующих версий ПО:

Настройте прямой прокси-сервер.

Добавлены следующие флаги, позволяющие настроить прямой прокси-сервер:

  • http.proxyHost
  • http.proxyPort
  • http.proxyUser
  • http.proxyPassword

По умолчанию значения флагов не заданы.

Улучшенный скрипт pg-data-purge для удаления родительских таблиц фактов из аналитики

Чтобы запустить скрипт, введите следующую команду:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql pg-data-purge org_name env_name number_of_days_to_retain [Delete-from-parent-fact - N/Y] [Confirm-delete-from-parent-fact - N/Y]

Скрипт имеет следующие параметры:

  • Delete-from-parent-fact Значение по умолчанию: "Нет". Также будут удалены данные старше срока хранения из родительской таблицы фактов.
  • skip-prompt. Значение по умолчанию: "Нет". Если выбрано значение "Нет", скрипт запросит подтверждение перед удалением данных из родительского факта. Установите значение "Да", если скрипт удаления автоматизирован.

Возможность изменить ярлык пользователя на странице входа

Новый флаг apigee.feature.customLoginUserLabel позволяет настроить ярлык пользователя на странице входа в соответствии с его предпочтениями. По умолчанию выбран вариант "Адрес электронной почты".

Поддерживаемое ПО

В этом выпуске внесены следующие изменения в поддерживаемое ПО:

Поддержка добавлена Больше не поддерживается

В этом выпуске поддерживаются следующие версии ПО:

  • Red Hat Enterprise Linux (RHEL) 7.5, 7.6, 7.7, 7.8, 7.9, 8.0
  • Amazon Linux AMI 2
  • Postgres 10.17
  • Nginx 1.20.1

В этом выпуске больше не поддерживаются следующие версии ПО:

  • Red Hat Enterprise Linux (RHEL) 6.X
  • Amazon Linux AMI 1
  • Node.js 0.10.32

Полный список поддерживаемых платформ приведен в разделе Поддерживаемое ПО и его версии.

Исправлены ошибки.

В этом разделе перечислены ошибки личного облака, исправленные в этой версии. Кроме того, в этот выпуск включены все исправления ошибок, которые были добавлены в выпуски Edge UI, Edge Management и Portal, перечисленные в разделе Включенные выпуски.

Идентификатор проблемы Описание
120421482

При создании KVM теперь выполняются дополнительные проверки, чтобы убедиться в существовании указанной среды.

Запросы POST и GET KVM, предназначенные для несуществующих сред, будут возвращать ошибку 404.
112262604

При переключении на резервный сервер Postgres необходимо обновить сервер управления Mint

Был создан улучшенный скрипт для изменения учетных данных подключения к Postgres для сервера управления Mint. Подробнее о том, как обрабатывать отработку отказа базы данных PostgreSQL…
150844280

Apigee SSO попытался скачать внешнюю библиотеку шрифтов во время входа в систему без подключения к интернету.

Шрифт Google Sans для заголовков, который не имеет лицензии с открытым исходным кодом, был заменен на шрифт Noto Sans.
161351690

Правило HMAC не появилось в окне выбора правил.

Правило появится в списке правил.
168149141

Не удавалось установить монетизацию на втором сервере управления.

Исправлены некоторые потенциальные проблемы, связанные с состоянием гонки при установке Mint Management Server.
170089960

Не удается изменить ярлык пользователя на странице входа

В apigee.feature.customLoginUserLabel добавлен новый флаг. С помощью этого флага можно настроить ярлык пользователя на странице входа. По умолчанию используется существующий ярлык, то есть Адрес электронной почты.
170791446

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

Теперь эта неполадка устранена.
173657467

Сервер управления не запускался, если узлы Cassandra в других центрах обработки данных были отключены.

Скрипт для включения аутентификации Cassandra был улучшен, чтобы предотвратить эту проблему.
175638733

Поддержка AWS Linux 1 прекращается

Добавлена поддержка AWS Linux 2.
175942835

GET-запросы к dailysummaryreports разрешались без защиты от CSRF

Проблема устранена
178305317

Клиент Consul Connect не использовал все доступные серверы Consul для автоматического перехода на резервный ресурс

Проблема устранена
180207712

Клиенты не могли добавлять новые узлы Cassandra из-за неправильного свойства CASS_HOSTS.

Теперь при настройке Cassandra возвращается улучшенное сообщение об ошибке, если указано неверное свойство CASS_HOSTS.
186503861

Правило ServiceCallout неправильно разделяло значения заголовков при использовании элемента .

Добавлена общая конфигурация (conf_http_HTTPHeader.{ANY}), позволяющая управлять поведением по умолчанию для всех заголовков с несколькими значениями и дубликатами. Эта конфигурация применяется, только если не задана определенная конфигурация заголовка.
182456858

Сервер управления не всегда подключался к серверу PostgreSQL в локальном регионе.

Алгоритм выбора сервера Postgres в сервере управления оптимизирован таким образом, чтобы он подключался к узлу Postgres в локальном регионе.
182857918

Улучшены сообщения в журнале, которые создаются, когда Message Processor достигает лимита подключений. Это упрощает устранение неполадок.
183147699

Не удалось расширить центр обработки данных dc-4 из-за настраиваемого названия региона.

Новый ресурс REGION_MAPPING позволяет сопоставлять названия регионов, заданные пользователем, со стандартными названиями регионов (dc-1, dc2 и т. д.). Подробнее о файле конфигурации Edge…
185285557

Добавлена возможность сделать адреса электронной почты разработчиков нечувствительными к регистру.

По умолчанию эта функция отключена, поэтому адреса электронной почты разработчиков по-прежнему будут чувствительны к регистру (как сейчас).
189743303

API Аналитики с фильтром для исключения прокси API возвращал ошибку.

Исправлена проблема с обработкой фильтров при выполнении специальных отчетов.
171240470

Не удавалось выполнить обновление управления, когда была включена аутентификация JMX Cassandra или SSL

Добавлена функция, позволяющая предоставлять конфигурации аутентификации и SSL Cassandra JMX при выполнении настройки или обновления на сервере управления.
168560804

При создании общего потока в интерфейсе Edge возвращалась ошибка 403 из-за недостаточных разрешений.

Исправлено неопределенное значение, которое передавалось в API.
171985727

Улучшены конфигурации JMX Cassandra, чтобы они соответствовали другим стандартам конфигурации Apigee и изменения не перезаписывались при обновлении Cassandra.
188526117

Команда IP не была дополнена абсолютным путем.

Теперь в команду включен абсолютный путь.
123015330

Неправильно отформатированные числа в файле .properties компонента приводили к тому, что компонент не запускался

Теперь эта неполадка устранена.
161934168

Уязвимость протокола PassTheHash в PostgreSQL, от PostgreSQL до Postgres версии 10.17

Теперь эта неполадка устранена.
185115206

Улучшена производительность аналитических запросов на сервере управления
193870176

Добавлена конфигурация на уровне маршрутизатора, позволяющая отключить параметры прослушивания виртуального хоста на стандартных портах 80 и 443.
197331224

Если организации нет, при запросе Get org будет возвращена ошибка 403 (неавторизованный доступ), а не 404 (не найдено).
184573211

Расширения для управления Java (JMX) больше не включены по умолчанию для модуля Apigee SSO.

Устранены проблемы с безопасностью

Ниже перечислены известные проблемы безопасности, которые были устранены в этой версии. Чтобы избежать этих проблем, установите последнюю версию Edge Private Cloud.

Идентификатор проблемы Описание
CVE-2018-16131

Уязвимость: [отказ в обслуживании (DoS)] обнаружена в проекте unified-experience/navbar (SNYK-JAVA-COMTYPESAFEAKKA-32493). Теперь эта неполадка устранена.
CVE-2020-7676

Уязвимость межсайтового скриптинга (XSS) в jQuery. Устранена уязвимость в jQuery, которая позволяла выполнять межсайтовый скриптинг (XSS).
CVE-2016-5388

Уязвимость в сервлете Tomcat В существующем сервлете Tomcat 8.0.53 была обнаружена уязвимость. Уязвимость была устранена при обновлении сервлета Tomcat до версии 8.5.34.

Известные проблемы

В таблице ниже перечислены известные проблемы в этом выпуске.

Идентификатор проблемы Описание
194249507

apigee-mirror не работает в Red Hat Enterprise Linux (RHEL) 8.0.

В качестве временного решения установите apigee-mirror на сервере с более ранней версией RHEL или другой поддерживаемой операционной системой для Apigee. После этого вы сможете использовать зеркало для добавления пакетов, даже если установили Apigee на серверах RHEL 8.0.

Полный список известных проблем с Edge для частного облака можно найти в этой статье.

Дальнейшие действия

Чтобы начать работу с Edge for Private Cloud 4.51.00, перейдите по следующим ссылкам:

Новые установки:

Обзор новой установки

Существующие установки

Обновите Apigee Edge 4.19.06 или 4.50.00 до версии 4.51.00.