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

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

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

Как обновить

После обновления этой версии будут обновлены компоненты в следующих RPM-пакетах:

  • edge-gateway-4.19.06-0.0.20094.noarch.rpm
  • edge-management-server-4.19.06-0.0.20094.noarch.rpm
  • edge-message-processor-4.19.06-0.0.20094.noarch.rpm
  • edge-postgres-server-4.19.06-0.0.20094.noarch.rpm
  • edge-qpid-server-4.19.06-0.0.20094.noarch.rpm
  • edge-router-4.19.06-0.0.20094.noarch.rpm
  • apigee-mtls-4.19.06-0.0.20189.noarch.rpm
  • apigee-mtls-consul-4.19.06-0.0.20128.noarch.rpm
  • apigee-cassandra-2.1.16-0.0.2508.noarch.rpm
  • edge-ui-4.19.06-0.0.20164.noarch.rpm
  • edge-management-ui-static-4.19.06-0.0.20018.noarch.rpm
  • apigee-sso-4.19.06-0.0.20080.noarch.rpm
  • apigee-setup-4.19.06-0.0.1122.noarch.rpm

Чтобы проверить, нужно ли обновить установленные версии RPM, введите:

apigee-all version

Чтобы обновить установку, выполните следующие действия на узлах Edge:

  1. На всех узлах Edge:

    1. Очистите репозитории Yum: 
      sudo yum clean all
    2. Скачайте последнюю версию файла Edge 4.19.06 bootstrap_4.19.06.sh в каталог /tmp/bootstrap_4.19.06.sh: 
      curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
    3. Установите утилиту Edge 4.19.06 apigee-service и зависимости: 
      sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord

      где uName:pWord – имя пользователя и пароль, полученные от Apigee. Если вы не укажете pWord, вам будет предложено ввести его.

    4. Обновите утилиту apigee-setup: 
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    5. Чтобы выполнить скрипт apigee-service.sh, используйте команду source: 
      source /etc/profile.d/apigee-service.sh

  2. Обновите все узлы Cassandra:

    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

    где configFile – файл конфигурации, который вы использовали для установки Apigee Edge Private Cloud. Пример: /opt/silent.conf.

  3. На всех узлах Edge выполните скрипт update.sh для процесса edge. Для этого выполните на каждом узле следующую команду: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

  4. Обновление интерфейса Edge:

    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  5. Выполните скрипт update.sh для SSO на всех узлах. На каждом узле выполните следующую команду: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  6. Если вы используете новый интерфейс Edge, выполните следующую команду: 
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
  7. Если вы используете Apigee mTLS, следуйте инструкциям в разделе Как обновить Apigee mTLS.

    Подробнее о Apigee mTLS…

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

Без изменений.

Прекращение поддержки

Новых устаревших функций нет.

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

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

Шифрование паролей JMX

Теперь вы можете шифровать пароли JMX. Подробную информацию можно найти в статьях Как включить шифрование пароля JMX и Как включить аутентификацию JMX для Cassandra. (150633039)

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

В таблице ниже перечислены ошибки, исправленные в этой версии.

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

Сертификаты apigee-mtls действовали только 30 дней.

Новые сертификаты действительны в течение одного года. Чтобы заменить старый 30-дневный сертификат новым, действительным в течение года, ознакомьтесь с разделом Обновление Apigee MTLS.
147736003

Устаревшая библиотека на сайте enterprise.apigee.com вызывала проблемы с безопасностью.

Библиотека обновлена.
150594487

Набор ресурсов Java на уровне организации приводил к тому, что процессоры сообщений не могли загрузить организации.
149739904

Маскировка данных для HTTP-заголовков выполнялась с учетом регистра.

Мы исправили эту проблему, и теперь маскировка данных не зависит от регистра.
130416715

Потенциальная уязвимость из-за заголовка True-Client-IP

В этом выпуске представлен новый элемент правил управления доступом – IgnoreTrueClientIPHeader, который устраняет проблему. Подробнее об элементе IgnoreTrueClientIPHeader…
161858295

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

Переменная для установки в фоновом режиме SSO_JWT_SIGNING_KEY_FILEPATH теперь пишется правильно.
160951701

Установка mTLS не удавалась из-за проблемы с сервером Consul.

Исполняемый файл Consul обновлен с версии 1.6.2 до последней стабильной версии 1.8.0.
132654321

В журналах аудита не отображались пользователи, чьи роли были изменены.

После изменения роли существующего пользователя или добавления существующего пользователя в организацию в журнале аудита отображалось сообщение "Обновление пользователя не определено", из-за чего вы не могли узнать, для кого было выполнено действие.
160916451

Установка mTLS не удавалась из-за устаревшей версии исполняемого файла Consul.

Двоичный файл Consul обновлен с версии 1.6.2 до последней стабильной версии 1.8.0.

Теперь apigee-mtls корректно обрабатывает серверы с несколькими сетевыми интерфейсами и адресами.
161764596

apigee-tomcat не обновлялся при применении исправлений.

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

В документации отсутствовала информация о том, как отключить протоколы в интерфейсе.

Новую документацию можно найти в разделе Отключение протоколов TLS.

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

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

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

Проблема с пулом подключений к правилам LDAP

Настройки пула подключений LDAP для JNDI, заданные через ресурс LDAP, не отражаются, и настройки JNDI по умолчанию приводят к одноразовым подключениям каждый раз. В результате соединения открываются и закрываются каждый раз для однократного использования, создавая большое количество соединений в час с сервером LDAP.

Решение

Чтобы изменить свойства пула подключений LDAP, выполните следующие действия, чтобы задать глобальное изменение для всех правил LDAP.

  1. Создайте файл конфигурации, если его ещё нет: 
    /opt/apigee/customer/application/message-processor.properties
  2. Добавьте в файл следующие строки (замените значения свойств Java Naming and Directory Interface (JNDI) в соответствии с требованиями к конфигурации ресурса LDAP). 
    bin_setenv_ext_jvm_opts="-Dcom.sun.jndi.ldap.connect.pool.maxsize=20
-Dcom.sun.jndi.ldap.connect.pool.prefsize=2
-Dcom.sun.jndi.ldap.connect.pool.initsize=2
-Dcom.sun.jndi.ldap.connect.pool.timeout=120000
-Dcom.sun.jndi.ldap.connect.pool.protocol=ssl"
  3. Убедитесь, что файл /opt/apigee/customer/application/message-processor.properties принадлежит пользователю apigee:apigee.
  4. Перезапустите каждый процессор сообщений.

Чтобы убедиться, что свойства JNDI пула подключений действуют, можно выполнить tcpdump, чтобы отследить поведение пула подключений LDAP с течением времени.