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 realizando una actualización desde la versión anterior de Edge para la nube privada. Si necesitas realizar una actualización desde una versión anterior, consulta Aplica 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 verificar las versiones de RPM que tienes instaladas actualmente para ver si deben actualizarse. Para ello, ingresa lo siguiente:

apigee-all version

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

  1. En todos los nodos perimetrales, haz lo siguiente:

    1. Limpia los repositorios de Yum:
      sudo yum clean all
    2. Descarga el archivo bootstrap_4.52.00.sh más reciente de Edge 4.52.00 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 pedirá que lo ingreses.

    4. Usa el comando source para ejecutar la secuencia de comandos apigee-service.sh:
      source /etc/profile.d/apigee-service.sh
  2. En todos los nodos perimetrales, 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 el 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

Problemas de seguridad solucionados

A continuación, se incluye una lista de problemas de seguridad conocidos que se corrigieron en esta versión. A fin de 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 de OAuth2, se mejoró la entropía del parámetro de estado para que sea impredecible y, así, 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 adicional de seguridad a los sitios contra ataques del cliente.

Cambios en el software compatible

Se agregó compatibilidad con las siguientes versiones de software:

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

Consulta Software compatible con Edge para la nube privada si quieres obtener una lista completa del software compatible.

Bajas y retiros

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

Funciones nuevas

En esta versión, se presentan 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 los nombres de la organización y el entorno cuando creas una organización o un entorno nuevos. El valor predeterminado para la cantidad máxima de caracteres es 255. Para establecer un máximo inferior, configura las siguientes propiedades en sus respectivos archivos de propiedades:

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

Si cualquiera de estas propiedades se establece en un valor inferior a 0 o superior a 255, el sistema usará un valor máximo de 1 o 255, respectivamente.

Establece el vencimiento de los tokens de acceso

Con esta versión, puedes establecer el vencimiento de los tokens de acceso si configuras la propiedad conf_keymanagement_oauth_access_token_expiry_time_in_millis con el tiempo de vencimiento deseado en milisegundos. Esta función está inhabilitada de forma predeterminada. Para habilitarla, establece conf_keymanagement_oauth_access_token_is_apply_limit en true en Message Processor.

Esta función les brinda a los administradores de Apigee un mayor 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, las políticas no eran visibles en el seguimiento.

Ya se solucionó 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 se solucionó este problema.
234544436

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

Ya se solucionó este problema.
293268203

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

Ya se solucionó este problema.
261616264

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

279065586

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

283310836

Se mejoró el mensaje de error que se producía cuando se analizaban archivos XML grandes.

245936798

Un problema con los nombres de la organización y los entornos causaba que las consultas Postgresql <code<create< code="" dir="ltr" translate="no"> fallaran.</code<create<>

Esto se corrigió mediante el manejo mejorado de los conflictos de nombres de índices de postgres para nombres largos de organizaciones y entornos.
293733533

La biblioteca de terceros de Spring en los componentes de Edge Gateway se actualizó de la versión 5.3.20 a la 5.3.27.

294363158

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

Ya se solucionó este problema.
297889765

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

Errores conocidos

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

Aplica varias versiones de parche

En esta sección, se describe cómo aplicar varias versiones de parche en caso de que estés actualizando desde una versión de Edge para la nube privada anterior a la versión de 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 parche, debes actualizar cada componente de Edge incluido en una versión de parche posterior a la versión instalada actualmente. Para encontrar estos componentes, consulta las notas de la versión de Edge para nube privada de todas las versiones posteriores a la actual y revisa la lista de RPM de esas versiones. Consulta las Notas de la versión de Apigee para ver los vínculos a todas las notas de la versión de Edge para la nube privada.

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

Nota: La actualización de un componente instala automáticamente la versión de parche más reciente de un componente. Si deseas actualizar a una versión de parche que no es la más reciente, debes mantener tu propia copia de archivo comprimido del repositorio de Apigee con la duplicación de Apigee y usar esta duplicación para las instalaciones de Apigee. Para obtener más información, consulta Usa un repositorio de Edge local para mantener tu versión de Edge.