4.52.00.03: Notas de la versión de Edge para la nube privada

Estás viendo la documentación de Apigee Edge.
Ve a la Documentación de Apigee X.
información

El 25 de octubre de 2023, lanzamos una nueva versión de Apigee Edge para la nube privada.

Nota: Esta versión será compatible hasta el 25 de octubre de 2024.

Procedimiento de actualización

En esta sección, se describe cómo instalar esta versión si estás actualizando desde la versión anterior. de Edge para la nube privada. Si necesitas actualizar desde una versión anterior, consulta Aplicar varias versiones de parche.

Si actualizas esta versión, se actualizarán los componentes de la siguiente lista de RPM:

  • edge-gateway-4.52.00-0.0.60200.noarch.rpm
  • edge-management-server-4.52.00-0.0.60200.noarch.rpm
  • edge-message-processor-4.52.00-0.0.60200.noarch.rpm
  • edge-postgres-server-4.52.00-0.0.60200.noarch.rpm
  • edge-qpid-server-4.52.00-0.0.60200.noarch.rpm
  • edge-router-4.52.00-0.0.60200.noarch.rpm
  • apigee-sso-4.52.00-0.0.21316.noarch.rpm
  • edge-analytics-4.52.00-0.0.40100.noarch.rpm
  • edge-management-ui-4.52.00-0.0.20029.noarch.rpm
  • edge-ui-4.52.00-0.0.20233.noarch.rpm
  • apigee-service-4.52.00-0.0.1500.noarch.rpm
  • apigee-mirror-4.52.00-0.0.1032.noarch.rpm
  • apigee-tomcat-9.0.82-0.0.939.noarch.rpm
  • apigee-configutil-4.52.00-0.0.624.noarch.rpm

Puedes consultar las versiones de RPM que tienes instaladas actualmente para ver si se deben actualizar ingresando lo siguiente:

apigee-all version

Para actualizar la instalación, realiza el siguiente procedimiento en los nodos de Edge:

  1. En todos los nodos de Edge:

    1. Limpia los repositorios de Yum:
      sudo yum clean all
    2. Descarga el archivo bootstrap_4.52.00.sh de Edge 4.52.00 más reciente en /tmp/bootstrap_4.52.00.sh
      curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
    3. Instala la utilidad apigee-service y las dependencias de Edge 4.52.00:
      sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord

      En el ejemplo anterior, uName y pWord son el nombre de usuario y la contraseña que recibiste de Apigee. Si omites pWord, se te solicitará que lo ingreses.

    4. Usa el comando source para ejecutar la secuencia de comandos de apigee-service.sh:
      source /etc/profile.d/apigee-service.sh
  2. En todos los nodos de Edge, ejecuta la secuencia de comandos update.sh para el proceso perimetral:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  3. Ejecuta la secuencia de comandos update.sh para SSO en todos los nodos:
  4. /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  5. En todos los nodos de la IU, ejecuta la secuencia de comandos update.sh para la IU:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. Si usas la experiencia New Edge, ejecuta el siguiente comando:
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile

Se solucionaron los problemas de seguridad

En la siguiente lista, se enumeran los problemas de seguridad conocidos que se solucionaron en esta versión. Para evitar estos problemas, instala la versión más reciente de Edge para la nube privada.
ID del problema Descripción
279065506 En la URL de redireccionamiento para OAuth2, se mejoró la entropía del parámetro de estado para que sea impredecible y evitar la vulnerabilidad de falsificación de solicitudes entre sitios (CSRF).",
279065586 Se agregaron políticas de seguridad de contenido en el encabezado para proporcionar una capa de seguridad adicional. para sitios de ataques del cliente.

Cambios en el software compatible

Se agregó compatibilidad con las siguientes versiones de software:

  • Red Hat Enterprise Linux (Intel de 64 bits): Versión 8.8
  • Oracle Linux (Intel 64-bit): versiones 7.9, 8.7 y 8.8
  • Rocky Linux 8
  • Tomcat 9.0.82

Consulta Edge para el software compatible con la nube privada para obtener una lista completa del software compatible.

Bajas y jubilaciones

No hay bajas ni bajas nuevas en esta versión.

Nuevas funciones

En esta versión, se introducen las siguientes funciones nuevas:

Establece la cantidad máxima de caracteres para los nombres de organizaciones y entornos

Con esta versión, puedes limitar la cantidad máxima de caracteres para el de la organización y del entorno cuando se crea una nueva organización o entorno. El el valor predeterminado para la cantidad máxima de caracteres es 255. Para establecer un máximo más bajo, configura las siguientes propiedades en su respectivo archivo de propiedades:

  • En el archivo de propiedades de la organización, configura org.name.max.length.
  • En el archivo de propiedades de la organización, configura env.name.max.length.

Si cualquiera de estas propiedades se establece en un valor menor que 0 o mayor que 255, el sistema usarán un valor máximo de 1 o 255, respectivamente.

Configura el vencimiento de los tokens de acceso

En esta versión, puedes establecer el vencimiento de los tokens de acceso configurando la propiedad conf_keymanagement_oauth_access_token_expiry_time_in_millis al valor deseado de vencimiento en milisegundos. Esta función está inhabilitada de forma predeterminada. Para habilitarlo, configura conf_keymanagement_oauth_access_token_is_apply_limit a true en el Message Processor.

Con esta función, los administradores de Apigee tienen un mejor control sobre el vencimiento de los tokens de acceso creados en Apigee.

Correcciones de errores

En esta sección, se enumeran los errores de la nube privada que se corrigieron en esta versión.

ID del problema Descripción
290242749

Cuando se usó la variable ServiceCallout.response en DataMasking, políticas no eran visibles en Trace.

Ya corregimos este problema.
260397807

Un problema en las plantillas de correo electrónico impidió que se enviaran caracteres de varios bytes por correo electrónico.

Ya corregimos este problema.
234544436

Hubo un problema por el que el menú de la izquierda desapareció cuando se cambiaba la organización en la nueva IU de Edge.

Ya corregimos este problema.
293268203

Las dependencias de Analytics no se actualizaban automáticamente en los nodos del servidor de administración.

Ya corregimos este problema.
261616264

Se agregó una verificación de arranque para garantizar que postgresql no se quite ni se borre durante el proceso de actualización.

279065586

En la URL de redireccionamiento para OAuth2, se mejoró la entropía del parámetro de estado para que sea impredecible y evitar la vulnerabilidad de falsificación de solicitudes entre sitios (CSRF).

283310836

Se mejoró el mensaje de error cuando se analizaban XML grandes.

245936798

Un problema con los nombres de la organización y el entorno provocaba que Postgresql <code<create< code=&quot;&quot; dir=&quot;ltr&quot; translate=&quot;no&quot;&gt; que las consultas fallen.</code<create<>

Esto se corrigió gracias al manejo mejorado de los conflictos de nombres de índices de postgres en organizaciones prolongadas y los nombres de los entornos.
293733533

La biblioteca de terceros de Spring en Edge Los componentes de la puerta de enlace se actualizaron de la versión 5.3.20 a la 5.3.27.

294363158

Una regresión hacía que aparecieran algunas dimensiones adicionales en los menús desplegables de la las páginas de estadísticas y supervisión de la IU de Edge.

Ya corregimos este problema.
297889765

Los artefactos generados por apigee-mirror ahora tienen la propiedad correcta

Problemas conocidos

Consulta Problemas conocidos con Edge para la nube privada para obtener una lista completa de los problemas conocidos.

Aplicar varias versiones de parche

En esta sección, se describe cómo aplicar varias versiones de parche en caso de que actualices una versión de Edge para la nube privada anterior a la versión de actualización del parche anterior.

Cada versión de parche contiene actualizaciones de componentes específicos de Edge para la nube privada, como edge-management-server Para aplicar varias versiones de parches, debes actualizar cada componente de Edge que se incluyó en una versión de parche posterior a la versión instalada actualmente. Puedes encontrar estos componentes examinando las notas de la versión de Edge for Private Cloud correspondientes a todas las versiones posteriores a la actual de versiones y verificar la lista de RPM de esas versiones. Consulta Notas de la versión de Apigee para acceder a todos los vínculos Notas de la versión de Edge para la nube privada.

Nota: Solo debes actualizar cada componente una vez. Para ello, instala los RPM de las versiones del componente que se incluye en las versiones de parche. Sigue las instrucciones de la notas de la versión para actualizar el componente.

Nota: La actualización de un componente instala automáticamente la última versión del parche de un este componente. Si quieres actualizar a una versión de parche que no sea la más reciente, debes mantener tu propio copia tarball del repositorio de Apigee con Apigee Mirror y usar esta duplicación para las instalaciones de Apigee. Para obtener más información, consulta Usar un repositorio de Edge local para mantener tu versión de Edge