4.18.05.04: 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.
info

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

Procedimiento de actualización

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

  1. En todos los nodos de Edge, haz lo siguiente:

    1. Limpia los repositorios de Yum:
      sudo yum clean all
    2. Descarga el archivo más reciente de Edge 4.18.05 bootstrap_4.18.05.sh en /tmp/bootstrap_4.18.05.sh:
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
    3. Instala la utilidad apigee-service y las dependencias de Edge 4.18.05:
      sudo bash /tmp/bootstrap_4.18.05.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 solicitará que lo ingreses.

    4. Actualiza la utilidad 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 la utilidad apigee validate:
    sudo /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  3. Importa el nuevo proxy de SmartDocs desde el smartdocs.zip en el /opt/apigee/apigee-validate/bundles directorio y realiza la implementación como una revisión nueva. El nuevo proxy se debe importar a la organización en la que SmartDocs está configurado actualmente. La implementación del proxy como una revisión nueva facilitará la reversión, si es necesario.

    Nota: Antes de la implementación, verifica que el <VirtualHost> del proxy nuevo coincida con la configuración de <VirtualHost> establecida actualmente en tu entorno. Si no es así, edita el proxy antes de la implementación.

  4. Desde la IU de Edge, crea y actualiza un KVM llamado “smartdocs_whitelist”, como se muestra en la siguiente figura. El KVM se debe crear en la organización y el entorno en los que se implementa actualmente el proxy de SmartDocs.

    Nota: Asegúrate de que la casilla de encrypted NO esté marcada.

    • Agrega una clave llamada “is_whitelist_configured”, en la que el valor es “YES”.
    • Agrega una segunda clave llamada “allowed_hosts”, en la que los valores son nombres de host o direcciones IP separados por espacios que se llaman desde SmartDocs. El valor de "allowed_hosts" debe incluir cualquier host incluido en las especificaciones de OpenAPI agregadas a SmartDocs. Por ejemplo, si tienes una especificación de OpenAPI que llama a mocktarget.apigee.net, deberás agregar mocktarget.apigee.net al valor "allowed_hosts". Si un host no está incluido en el KVM, la respuesta de SmartDocs será 400 Bad Request con una carga útil de contenido de Bad Request-Hostname not permitted.
    Interfaz de creación de KVM Nota: Si no agregas y configuras este KVM, el proxy no aplicará la lista de entidades permitidas. Esto podría provocar un acceso no autorizado a tus hosts y direcciones IP. Solo los nombres de host y las direcciones IP de los extremos de API documentados con SmartDocs deben incluirse en los valores de "allowed_hosts".

Software compatible

Ninguno

Bajas y retiros

Ninguno

Fallas corregidas

En la siguiente tabla, se enumeran las fallas corregidas en esta versión:

ID del problema Descripción
145340106

Vulnerabilidad de la API de Apigee SmartDocs

Se actualizó el proxy de Apigee SmartDocs para abordar la vulnerabilidad de seguridad. Consulta el procedimiento de actualización para obtener más información y los pasos necesarios.