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

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X.
info

El 29 de septiembre de 2020, lanzamos una nueva versión de Apigee Edge para la nube privada.

Procedimiento de actualización

La actualización de esta versión actualizará los componentes de la siguiente lista de RPM:

  • edge-gateway-4.19.01-0.0.20095.noarch.rpm
  • edge-management-server-4.19.01-0.0.20095.noarch.rpm
  • edge-message-processor-4.19.01-0.0.20095.noarch.rpm
  • edge-postgres-server-4.19.01-0.0.20095.noarch.rpm
  • edge-qpid-server-4.19.01-0.0.20095.noarch.rpm
  • edge-router-4.19.01-0.0.20095.noarch.rpm
  • apigee-cassandra-2.1.16-0.0.2507.noarch.rpm
  • edge-management-ui-static-4.19.01-0.0.20017.noarch.rpm
  • apigee-setup-4.19.01-0.0.1123.noarch.rpm
  • apigee-mtls-consul-4.19.01-0.0.20129.noarch.rpm
  • apigee-mtls-4.19.01-0.0.20190.noarch.rpm

Para verificar las versiones de RPM que tienes instaladas actualmente y ver si necesitan actualizarse, ingresa lo siguiente:

apigee-all version

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

  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.19.01.sh de Edge 4.19.01 más reciente en /tmp/bootstrap_4.19.01.sh:
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    3. Instala la utilidad apigee-service de Edge 4.19.01 y las dependencias:
      sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

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

    4. Actualiza la utilidad de apigee-setup:
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    5. Usa el comando source para ejecutar la secuencia de comandos apigee-service.sh:
      source /etc/profile.d/apigee-service.sh
  2. Actualiza todos los nodos de Cassandra:

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

    donde configFile especifica el archivo de configuración que usaste para instalar Apigee Edge para la nube privada. Por ejemplo, /opt/silent.conf

  3. En todos los nodos perimetrales, ejecuta la secuencia de comandos update.sh para el proceso edge. Para ello, ejecuta el siguiente comando en cada nodo:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. Si usas la nueva experiencia de Edge, ejecuta el siguiente comando:
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
  5. (Solo para mTLS de Apigee) Para actualizar mTLS de Apigee, sigue el procedimiento que se describe en Actualiza mTLS de Apigee.

    Para obtener más información, consulta Introducción a mTLS de Apigee.

Software compatible

Sin cambios.

Bajas y retiros

No hay bajas ni obsolescencias nuevas.

Nuevas funciones

En esta sección, se enumeran las funciones nuevas de esta versión.

Encripta contraseñas de JMX

Ahora puedes encriptar las contraseñas de JMX. Consulta Cómo habilitar la encriptación de contraseñas de JMX y Cómo habilitar la autenticación de JMX para Cassandra para obtener más detalles. (150633039)

Fallas corregidas

En la siguiente tabla, se enumeran los errores corregidos en esta versión:

ID del problema Descripción
159360654

Los certificados de apigee-mtls solo eran válidos por 30 días.

Los certificados nuevos ahora son válidos por un año. Para actualizar un certificado antiguo de 30 días con uno nuevo, válido por un año, consulta Actualiza Apigee MTLS.

160890634

Cuando se reiniciaron los procesadores de mensajes, no se implementaron algunos proxies.

130416715

Vulnerabilidad potencial debido al encabezado "True-Client-IP"

En esta versión, se introduce un nuevo elemento de política de control de acceso, IgnoreTrueClientIPHeader, que corrige el problema. Consulta el elemento IgnoreTrueClientIPHeader.

132654321

Los registros de auditoría no mostraban a los usuarios cuyos roles se actualizaron.

Después de realizar cambios de roles para usuarios existentes o agregar un usuario existente a una organización, el registro de auditoría mostraba "Update user undefined", lo que impedía que vieras sobre quién se realizó la acción.

160951701

La instalación de mTLS fallaba debido a una versión binaria de Consul desactualizada.

Se actualizó el objeto binario de Consul de la versión 1.6.2 a la versión estable más reciente, la 1.8.0.

160916451

La instalación de mTLS fallaba debido a que faltaba una entrada para el campo bindaddr de Consul.

Ahora apigee-mtls controla correctamente los servidores con varias interfaces y direcciones de red.

133145969

Faltaba la documentación para inhabilitar protocolos en la IU

Para obtener información sobre la documentación nueva, consulta Cómo inhabilitar protocolos TLS.

Problemas conocidos

En la siguiente tabla, se enumeran los problemas conocidos en esta versión:

ID del problema Descripción
149245401

Problema de agrupación de conexiones de la política de LDAP

Las propiedades del grupo de conexiones LDAP especificadas con el recurso LDAP no tienen efecto. Como resultado, las conexiones se abren y cierran cada vez para un solo uso, lo que crea una gran cantidad de conexiones por hora al servidor LDAP.

Solución alternativa:

Para cambiar las propiedades del grupo de conexiones LDAP, sigue estos pasos para establecer un cambio global en todas las políticas de LDAP.

  1. Crea un archivo de propiedades de configuración si aún no existe:
    /opt/apigee/customer/application/message-processor.properties
  2. Agrega lo siguiente al archivo (reemplaza los valores de las propiedades de la interfaz de Java Naming and Directory Interface [JNDI] según el requisito de configuración de tu recurso 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. Asegúrate de que el archivo /opt/apigee/customer/application/message-processor.properties sea propiedad de apigee:apigee.
  4. Reinicia cada Message Processor.

Para verificar que las propiedades JNDI del grupo de conexiones estén surtiendo efecto, puedes realizar un tcpdump para observar el comportamiento del grupo de conexiones LDAP con el tiempo.