4.53.00.02 - Edge for Private Cloud release notes

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

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

Как обновить

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

После обновления этой версии будут обновлены перечисленные ниже компоненты.

  • apigee-nginx-1.26.1-el8.x86_64.rpm
  • apigee-nginx-1.26.1-el9.x86_64.rpm
  • apigee-qpidd-8.0.6-0.0.2534.noarch.rpm
  • apigee-sso-4.53.00-0.0.21506.noarch.rpm
  • apigee-tomcat-9.0.86-0.0.948.noarch.rpm

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

apigee-all version

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

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

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

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

    4. Чтобы выполнить скрипт apigee-service.sh, используйте команду source: 
      source /etc/profile.d/apigee-service.sh
  2. На всех узлах Qpid выполните скрипт update.sh: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. На узлах SSO выполните процедуру, описанную в разделе Инструкции по обновлению Apigee SSO с более ранних версий: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile

Как обновить Apigee SSO с более ранних версий

В Edge for Private Cloud 4.53.00 ключи и сертификаты поставщика идентификационной информации, используемые в компоненте apigee-sso, теперь настраиваются через хранилище ключей. Вам нужно будет экспортировать ключ и сертификат, использованные ранее, в хранилище ключей, настроить его, а затем обновить SSO обычным способом.

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

    1. Чтобы получить сертификат, найдите значение SSO_SAML_SERVICE_PROVIDER_CERTIFICATE в файле конфигурации установки SSO или запросите компонент apigee-sso для conf_login_service_provider_certificate.

      Чтобы запросить у apigee-sso путь к сертификату поставщика идентификационной информации, выполните на узле SSO следующую команду: В выходных данных найдите значение в последней строке.

      apigee-service apigee-sso configure -search conf_login_service_provider_certificate

    2. Чтобы получить ключ, найдите значение SSO_SAML_SERVICE_PROVIDER_KEY в файле конфигурации установки SSO или запросите компонент apigee-sso для conf_login_service_provider_key.

      Чтобы запросить путь к ключу поставщика идентификационной информации, используйте следующую команду в узле SSO: apigee-sso. В выходных данных найдите значение в последней строке. 

      apigee-service apigee-sso configure -search conf_login_service_provider_key
  2. Экспортируйте ключ и сертификат в хранилище ключей:
    1. Экспортируйте ключ и сертификат в хранилище ключей PKCS12: 
      sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>

      Параметры:

      • certificate_path: путь к файлу сертификата, полученному на шаге 1а.
      • key_path – путь к файлу закрытого ключа, полученному на шаге 1б.
      • keystore_path: путь к созданному хранилищу ключей, содержащему сертификат и закрытый ключ.
      • alias – псевдоним, используемый для пары ключей и сертификатов в хранилище ключей.

      Подробная информация приведена в документации OpenSSL.

    2. При необходимости экспортируйте ключ и сертификат из PKCS12 в хранилище ключей JKS: 
      sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>

      Параметры:

      • PKCS12_keystore_path – путь к хранилищу ключей PKCS12, созданному на шаге 2а и содержащему сертификат и ключ.
      • destination_keystore_path – путь к новому хранилищу ключей JKS, в которое будут экспортированы сертификат и ключ.
      • alias – псевдоним, используемый для пары ключей и сертификатов в хранилище ключей JKS.

      3. Подробная информация приведена в документации по keytool.

  3. Измените владельца выходного файла хранилища ключей на пользователя apigee: 
    sudo chown apigee:apigee <keystore_file>
  4. Добавьте в файл конфигурации Apigee SSO следующие свойства и укажите в них путь к файлу хранилища ключей, пароль, тип хранилища ключей и псевдоним: 
    # Path to the keystore file
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks

# Keystore password
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore

# Keystore type
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12

# Alias within keystore that stores the key and certificate
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert
  5. Обновите ПО Apigee SSO на узле SSO обычным способом, используя следующую команду: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

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

В этом разделе перечислены ошибки личного облака, исправленные в этой версии.

Идентификатор проблемы Описание
379446933 Исправлена проблема, из-за которой nginx не удавалось привязать к порту 443.

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

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

Идентификатор проблемы Описание
344961470 Исправлена уязвимость, связанная с межсайтовым скриптингом, в портале управления QPID.

Изменения в поддерживаемом ПО

В этом выпуске не добавлена поддержка нового ПО.

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

В этом выпуске нет новых объявлений об устаревании или прекращении поддержки.

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

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

Идентификатор проблемы Описание
379125083 Включена функция единого входа (SSO) в средах RHEL 8 с поддержкой FIPS.
379125495 Теперь SSO принимает ключи и сертификаты для поставщика идентификационной информации в формате хранилища ключей.

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

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

Как применить несколько версий исправлений

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

Каждый патч содержит обновления для определенных компонентов Edge для частного облака, например: edge-management-server. Чтобы применить несколько версий исправлений, необходимо обновить каждый компонент Edge, который был включен в версию исправлений, выпущенную позже установленной у вас. Чтобы найти эти компоненты, ознакомьтесь с примечаниями к выпуску Edge для частного облака для всех версий, более поздних, чем ваша текущая, и проверьте список RPM для этих выпусков. Ссылки на все примечания к выпуску Edge для частного облака можно найти в примечаниях к выпуску Apigee.

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

Примечание. При обновлении компонента автоматически устанавливается последняя версия патча. Если вы хотите перейти на версию исправления, которая не является последней, вам нужно создать собственную копию репозитория Apigee в виде архива tar с помощью зеркала Apigee и использовать это зеркало для установки Apigee. Подробнее о том, как использовать локальный репозиторий Edge для поддержки версии Edge…