4.17.05: 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

Desde la versión anterior de Edge para la nube privada, se lanzaron las siguientes versiones, que se incluyen en esta versión de funciones:

Consulta Acerca de la numeración de versiones para comprender cómo puedes determinar si una versión específica de la nube se incluye en tu versión de Edge para Private Cloud.

Resumen de la versión

Esta versión incluye varias funciones destacadas que te ayudan a controlar y proteger mejor tus APIs, incluidas las siguientes:

• Los flujos compartidos admiten la implementación sin tiempo de inactividad.
• Ahora se admite el borrado de datos de monetización de una organización.
• A continuación, se describen otras funciones nuevas.

En cuanto a la baja, se dieron de baja las bóvedas.

El resto de este tema contiene detalles sobre todas las funciones nuevas, las actualizaciones y las correcciones de errores que se incluyen en la versión.

Bajas y retiros

En esta versión, se retiraron o dejaron de estar disponibles las siguientes funciones. Consulta la Política de baja de Edge para obtener más información.

Retirado: Se agregaron rutas en la pestaña Rendimiento del proxy de API

Hasta esta versión, podías navegar a un proxy de API en la IU de administración, ir a la pestaña Rendimiento y crear diferentes rutas para una comparación basada en gráficos en la pestaña Rendimiento del proxy y en el panel de Transacciones comerciales. Esta función ya no está disponible en la IU. Para obtener una alternativa a esta funcionalidad, consulta el siguiente artículo de la comunidad de Apigee: Alternativa a la API de transacciones comerciales. (EDGEUI-902)

Retirada: URL de buildInfo para el portal de Developer Services

En versiones anteriores del portal, para determinar la versión del portal, abrías la siguiente URL en un navegador:

http://yourportal.com/buildInfo

En la versión 4.17.05, se quitó este vínculo. Para determinar la versión, abre la entrada de menú Informes > Informe de estado en Drupal. La versión del portal aparece en la tabla, en la fila llamada Install profile.

Baja de la tienda segura (bóvedas) de Apigee

El almacén seguro de Apigee, también conocido como "bóvedas", dejará de estar disponible y se retirará un año después de la fecha del anuncio de baja que se muestra en la página de bajas y retiros. Las bóvedas, que proporcionan almacenamiento encriptado de pares clave-valor, se crean con la API de administración y se accede a ellas en el tiempo de ejecución con funciones en el módulo apigee-access de Node.js.

En lugar de usar el almacén seguro, usa mapas de clave-valor (KVM) encriptados, como se describe en Trabaja con mapas de clave-valor. Las KVM encriptadas son tan seguras como las bóvedas y ofrecen más opciones para la creación y la recuperación. (MGMT-3848)

Nuevas funciones y actualizaciones

A continuación, se indican las nuevas funciones y mejoras de esta versión. Además de las siguientes mejoras, esta versión también incluye varias mejoras de usabilidad, rendimiento, seguridad y estabilidad.

Nube privada

Se agregó un nuevo parámetro de configuración de SMTP obligatorio a la instalación

Ahora debes usar el parámetro SMTPMAILFROM en el archivo de configuración de la instalación de Edge. Este parámetro especifica la dirección de correo electrónico que se usa cuando Edge envía correos electrónicos automatizados, por ejemplo, cuando un usuario solicita restablecer una contraseña. Consulta Instala componentes de Edge en un nodo para obtener más información.

(EDGEUI-1020)

Ahora se puede configurar el tiempo de espera que usa la IU de Edge para las llamadas de administración de la API de Edge.

Ahora puedes especificar la duración del tiempo de espera de la API que usa la IU de Edge para controlar cuánto tiempo espera la IU a que se devuelva una llamada de administración de la API. Las siguientes propiedades definen el tiempo de espera:

• conf_apigee_apigee.feature.apitimeout establece el tiempo, en segundos, que la IU espera a que vuelva una llamada al backend, independientemente de cualquier actividad en él. Si la llamada no se completa en ese tiempo, la IU arroja un error de tiempo de espera. El valor predeterminado es 180 segundos (3 minutos).
• conf_apigee_play.ws.timeout.idle establece cuánto tiempo espera la IU, en milisegundos, para que haya actividad en el servidor. Se puede establecer en el mismo valor que conf_apigee_apigee_apitimeout o en un valor menor. Establecer un valor mayor no tiene ningún efecto. El valor predeterminado es 180,000 milisegundos (3 minutos).
• conf_apigee_play.ws.timeout.connection establece cuánto tiempo espera la IU para que se establezca una conexión. Se puede establecer en el mismo valor que conf_apigee_apigee_apitimeout o en un valor menor. Establecer un valor mayor no tiene ningún efecto. El valor predeterminado es 120,000 milisegundos (2 minutos).

Consulta Cómo establecer el tiempo de espera que usa la IU de Edge para las llamadas de administración de la API de Edge para obtener más información.

(EDGEUI-816)

Se agregó el tiempo de espera de reintento del procesador de mensajes a los routers

Se agregó un tiempo de espera para que los routers dejen de reintentar una solicitud a los procesadores de mensajes y muestren un mensaje de error.

Consulta Cómo configurar el Router para que vuelva a intentar las conexiones a un Message Processor para obtener más información.

(APIRT-2912)

Se agregó un procedimiento para cambiar el administrador del sistema predeterminado

Ahora se incluye documentación para cambiar el administrador del sistema predeterminado.

Consulta Cómo administrar usuarios, roles y permisos para obtener más información.

(DOS-4895)

Se agregó documentación sobre la separación de las tareas de instalación de Edge entre el usuario raíz y el usuario no raíz

La nueva documentación describe los pasos para separar las tareas de instalación de Edge entre el usuario raíz y el usuario no raíz.

Consulta la Descripción general de la instalación en el borde para obtener más información.

(DOS-4573)

Se agregó una propiedad para establecer el nombre de host de los vínculos en los correos electrónicos generados

Edge envía correos electrónicos automáticamente en respuesta a ciertos eventos, como cuando se agrega un usuario a una organización. Muchos de estos correos electrónicos contienen un vínculo. Por ejemplo, cuando se agrega un usuario nuevo a una organización, la IU de Edge le envía un correo electrónico que contiene una URL de acceso con el siguiente formato:

https://domain/login

Edge determina el dominio automáticamente y, por lo general, es correcto para la organización. Sin embargo, es posible que, cuando la IU de Edge se encuentre detrás de un balanceador de cargas, el nombre de dominio generado automáticamente sea incorrecto. Si es así, puedes usar la propiedad conf_apigee_apigee.emails.hosturl para establecer de forma explícita la parte del nombre de dominio de la URL generada.

Consulta Cómo configurar el nombre de host para los vínculos en los correos electrónicos generados para obtener más información.

(EDGEUI-1044)

Cómo configurar la URL base que muestra la IU de Edge para un proxy de API

La IU de Edge muestra la URL de un proxy de API según la configuración del host virtual correspondiente al lugar donde se implementa el proxy. Esta pantalla puede incluir el número de puerto del router del host virtual.

En la mayoría de los casos, la URL que se muestra en la IU de Edge es la correcta para realizar solicitudes externas al proxy. Sin embargo, en algunas configuraciones, la URL que se muestra no es correcta. Por ejemplo, cualquiera de las siguientes configuraciones puede hacer que la URL que se muestra no corresponda a la URL real que se usa para realizar solicitudes externas al proxy:

• La terminación SSL se produce en un balanceador de cargas
• Se realiza una asignación de puertos entre un balanceador de cargas y los routers de Apigee
• Un balanceador de cargas configurado con reescritura de rutas de acceso

Edge para Nube privada 4.17.05 y versiones posteriores admiten un atributo en el host virtual llamado <BaseUrl> que te permite anular la URL que muestra la IU de Edge. A continuación, se muestra un ejemplo del objeto de host virtual con el nuevo atributo <BaseURL>. En este ejemplo, el valor "http://myCo.com" aparece en la IU de Edge:

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:9005</HostAlias>
   </HostAliases>
   <BaseUrl>http://myCo.com</BaseUrl>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

Si no se configura <BaseUrl>, el valor predeterminado, la URL predeterminada que renderiza la IU de Edge aparecerá como "http://DNS_name_or_IP:9005/", mientras que la configuración real del alias de host es "http://myCo.com".

También puedes configurar la URL base cuando creas una organización con la propiedad VHOST_BASEURL y la utilidad apigee-provision.

Para obtener más información, consulta Configura el acceso TLS a una API para la Nube privada.

(EDGEUI-5008)

Se agregó documentación sobre cómo habilitar el registro de depuración

Se agregó documentación para describir cómo habilitar o inhabilitar el registro de depuración para los componentes de Edge.

Consulta Habilita el registro de depuración para obtener más información.

(APIRT-4018)

Nueva sintaxis de comando y del instalador para la utilidad apigee-analytics-collector

Todos los clientes de Edge para Private Cloud deben enviar a Apigee estadísticas sobre el tráfico del proxy de API con la versión beta de la utilidad de línea de comandos apigee-analytics-collector. Esta utilidad envía el informe de volumen de llamadas a la API a Apigee.

Esta versión de Edge contiene nuevas instrucciones de instalación y sintaxis de comandos para la utilidad apigee-analytics-collector. En esta versión, ahora usas apigee-service para instalar la utilidad apigee-analytics-collector, en lugar de npm, y para invocar la utilidad apigee-analytics-collector a través de apigee-service en lugar de como un comando independiente.

Para obtener más información, consulta Cómo subir datos de tráfico de la API a Apigee: versión beta.

Nuevo directorio de instalación predeterminado después de la actualización del portal de Developer Services de Nginx/Postgres desde una nueva instalación de la versión 4.17.01

Después de actualizar una instalación nueva de la versión 4.17.01 que usa Nginx/Postgres, el directorio raíz cambió de:

/opt/apigee/apigee-drupal

para:

/opt/apigee/apigee-drupal/wwwroot

Servicios de APIs

Validación de entrada más estricta para las entidades

Se aplicó una validación de entrada más estricta en todas las entidades de la organización de Apigee Edge. Los caracteres permitidos suelen ser alfabetos (en todos los casos), números y guiones bajos.

Entre las entidades afectadas, se incluyen las siguientes:

• Organizaciones
• Entornos
• Proxies de API
• Revisiones del proxy de API
• Nombres de políticas en el proxy de API
• IDs de configuración de la máscara de seguimiento de depuración
• Nombres de recursos (llamada de Java, XSL, todos los recursos)
• Almacén de claves
• CRLstores
• Referencias de recursos
• Servidores de destino

(MGMT-3840)

Implementación sin tiempo de inactividad de flujos compartidos

Cuando desees implementar flujos compartidos y asegurarte de que se rechace poco o nada del tráfico entrante durante la implementación, ahora puedes usar una API de administración de implementaciones sin tiempo de inactividad. El proceso es casi idéntico a la implementación sin tiempo de inactividad para proxies de API con la API de administración. La única diferencia es el recurso de la API de administración.

La siguiente llamada implementa la revisión del flujo compartido indicada en el URI y, luego, anula la implementación de la revisión implementada anteriormente (el parámetro de consulta override=true habilita esta acción):

curl -X POST -H "Content-type:application/x-www-form-urlencoded" \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env-name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
-u email:password

(MGMT-3485)

Monetización

Cómo borrar datos de monetización de una organización

Es posible que desees borrar los datos de monetización de tu organización en los siguientes casos:

• Borra tu organización. En este caso, debes borrar los datos de monetización antes de poder borrar la organización.
• Borra los datos de monetización de una organización de prueba que quieras reutilizar. En este caso, debes sincronizar los datos de Apigee Edge después de borrar los datos de monetización.

Para obtener más información, consulta Cómo borrar los datos de monetización de tu organización. (DEVRT-2581)

Se agregó una API para habilitar la monetización de una organización

Ahora puedes usar una API para habilitar la monetización de una organización.

Consulta Habilita la monetización para una organización para obtener más información.

(DEVRT-2383)

Fallas corregidas

En esta versión, se corrigieron los siguientes errores. Esta lista está dirigida principalmente a usuarios que verifican si sus tickets de asistencia se corrigieron. No está diseñada para proporcionar información detallada a todos los usuarios.

Private Cloud 4.17.05

Cloud 17.04.12 (IU)

Cloud 17.04.05 (IU)

Cloud 17.03.29 (IU)

Cloud 17.03.15.01 (IU)

Cloud 17.03.15 (IU)

Cloud 17.03.13.02 (monetización)

Cloud 17.03.13.01 (monetización)

Cloud 17.03.13 (Administración de APIs)

Cloud 17.03.1 (IU)

Cloud 17.02.15 (IU)

Cloud 17.02.13 (tiempo de ejecución de la API)

Cloud 17.02.13 (administración de APIs)

Cloud 17.01.18 (IU)

Cloud 17.01.16 (administración de APIs)

Cloud 17.01.16 (monetización)