4.16.01: 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 jueves 24 de marzo de 2016, lanzamos una nueva versión de Apigee Edge para la nube privada.

Desde la versión trimestral anterior de Edge para la Nube privada (4.15.07.00), se lanzaron las siguientes versiones, que se incluyen en esta versión de funciones:

• Cloud: 15.07.08, 15.07.22, 15.08.05, Migración de Nginx, 15.09.02, 15.09.30, 16.01.20
• Nube privada: 4.15.07.01, 4.15.07.03

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.

Bajas

Nube privada 4.15.07.03

curl http:// <qpid_IP>:8083/v1/servers/self/queues

Análisis: Vista del panel de informes personalizados de varios informes (Cloud 15.09.30)

La función específica del Panel de informes personalizados que proporciona una vista de hasta cuatro informes personalizados dejará de estar disponible y se quitará en una versión futura. (MGMT-2673). Todos los demás aspectos de los informes personalizados seguirán estando disponibles.

No se puede anular la longitud del nombre de la organización en la nube privada

Ya no puedes anular la longitud del nombre de la organización de 20 caracteres con el siguiente parámetro de configuración:

• APIGEE_ORG_NAME_LENGTH=25

• APIGEE_ENV_NAME_LENGTH=25

Nuevas funciones y mejoras

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ó compatibilidad con RedHat, CentOS y Oracle 6.7 a 7.2

En esta versión, se agregó compatibilidad con las versiones 6.7 a 7.2 de Red Hat Enterprise Linux, CentOS y Oracle Linux.

Para obtener una lista completa de los requisitos del sistema, consulta Software y versiones compatibles.

Instalación basada en RPM

En esta versión de Edge, se usa un mecanismo de instalación basado en RPM que simplifica en gran medida los procedimientos de instalación y migración.

Nuevo directorio base

Cambió la estructura de directorios de la versión Edge 4.16.01. En versiones anteriores de Edge, instalaste Edge en el directorio base:

/<install-dir>/apigee4

install-dir puede ubicarse en cualquier lugar, con un valor predeterminado de /opt. Por ejemplo:

/opt/apigee4

Para la versión 4.16.01, debes instalar Edge en el siguiente directorio:

/opt/apigee

Observa también que el directorio apigee4 se cambió a apigee.

La ubicación de tu directorio de datos no se verá afectada. Puede estar en /opt/apigee o en otra ubicación.

Nuevo requisito de host virtual

La secuencia de comandos de migración de Edge controla la mayoría de las tareas necesarias para migrar un enrutador Netty existente a Nginx. Sin embargo, como parte de la actualización, también debes asegurarte de que todas tus definiciones de host virtual incluyan un alias de host antes de migrar.

Consulta la Guía de instalación de Edge, disponible en el sitio FTP de Apigee: ftp://ftp.apigee.com/

Código con configuración

En la versión 4.16.01 de Edge, ya no se usan archivos .properties en el directorio /<install-dir>/apigee4/conf para configurar los componentes de Edge. A partir de la versión 4.16.01, aún puedes configurar los componentes de Edge con archivos .properties, pero ahora se encuentran en el siguiente directorio:

/opt/apigee/customer/application

Para cada componente de Edge instalado en un nodo, habrá un archivo .properties en ese directorio. Para configurar un componente, edita el archivo .properties correspondiente para cambiar el valor de una propiedad existente o agregar una propiedad y un valor nuevos. Si el archivo aún no existe, puedes crearlo.

A diferencia de las versiones anteriores de Edge, los archivos .properties de Edge 4.16.01 no contienen todas las propiedades de un componente. Uno de los cambios de esta versión es que los archivos .properties solo contienen anulaciones de los valores de propiedad predeterminados.

El beneficio de esta arquitectura es que, en una migración a una versión posterior de Edge, el instalador de Edge nunca sobrescribe los archivos en /opt/apigee/customer/application. Esto elimina la posibilidad de que Edge sobrescriba accidentalmente tu configuración.

En una migración, el instalador de Edge examina los archivos .properties existentes y copia los cambios en los valores de propiedad predeterminados en el directorio /opt/apigee/token. Por lo tanto, no deberías tener que realizar ninguna edición después de la migración.

Para obtener más información, consulta la Guía de operaciones de Apigee Edge, disponible en el sitio FTP de Apigee: ftp://ftp.apigee.com/

Se reemplazaron las secuencias de comandos de configuración de Edge

Se quitaron las secuencias de comandos de configuración que usaste en versiones anteriores de Edge y se reemplazaron por una de las siguientes opciones:

• Comandos que ejecutas a través de utilidades de Apigee, como apigee-service, apigee-all, apigee-setup, apiee-provision o apigee-migrate
  Por ejemplo, los comandos all-start.sh y all-stop.sh se reemplazaron por los siguientes:> /opt/apigee/apigee-service/bin/apigee-all start
  > /opt/apigee/apigee-service/bin/apigee-all stop
  
• Son los comandos que ejecutas directamente en los componentes de Edge. Por ejemplo, en versiones anteriores, usabas la secuencia de comandos chpasswd-openldap.sh para cambiar la contraseña de OpenLDAP. Esa secuencia de comandos se reemplazó por el siguiente comando que se ejecuta en el componente apigee-openldap:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-password -o oldPword -n newPword

Consulta la Guía de operaciones de Apigee Edge, disponible en el sitio FTP de Apigee: ftp://ftp.apigee.com/, para obtener más información sobre cómo realizar la configuración a través de comandos.

Nuevo router perimetral

Esta versión de Edge para la nube privada incluye una nueva arquitectura de router basada en el router de Nginx. El Nginx Router reemplaza al Netty Router que se usaba en las versiones de Edge anteriores a la 4.16.01.

Los enrutadores de Nginx tienen los mismos requisitos de hardware y puertos que el enrutador de Netty, por lo que no se requieren cambios en los nodos existentes.

Para obtener más información, consulta el Apéndice A: Acerca del Router Nginx, en la Guía de instalación de Edge, disponible en el sitio FTP de Apigee: ftp://ftp.apigee.com/.

Se quitó el balanceador de cargas de BaaS

Se quitó el balanceador de cargas interno del portal de BaaS de la API. Ahora, debes usar tu propio balanceador de cargas entre el portal de API BaaS y los tres nodos de la pila de API BaaS.

Como alternativa a un balanceador de cargas, puedes usar el DNS round robin. En este caso, crearás una entrada de DNS con varios registros A que corresponden a las direcciones IP de la pila de BaaS. Durante una búsqueda de DNS, el servidor DNS devuelve automáticamente los valores del registro A de forma rotativa.

Documentación nueva que describe cómo agregar nodos de Cassandra y ZooKeeper, y cómo agregar un centro de datos a un centro de datos existente

El archivo ZIP de documentación en el sitio FTP de Apigee ahora contiene "Scaling Edge for Private Cloud", que describe cómo agregar nodos de Cassandra y ZooKeeper, y cómo agregar un centro de datos a un centro de datos existente.

Se quitó Orgtool

La herramienta orgtool podría consultar una instalación de Edge para obtener información sobre una organización. Ya se quitó esa herramienta. Ahora puedes usar la IU de Edge o las llamadas a la API para obtener información sobre la organización.

Cómo realizar tareas en la versión 4.16.01

En la siguiente tabla, se muestra cómo realizabas las tareas en la versión 4.15.07.03 y cómo las realizas ahora en la versión 4.16.01. Para obtener más información, consulta la Guía de operaciones de Edge, disponible en el sitio FTP de Apigee: ftp://ftp.apigee.com/

Lanzamiento alfa de la herramienta y el panel de supervisión

En esta versión, se incluye una versión alfa de la nueva herramienta y el nuevo panel de supervisión para Edge. Esta herramienta te permite comprender el estado de varios componentes (routers, procesadores de mensajes, ZooKeeper y Cassandra), así como los códigos de error HTTP para varias organizaciones y entornos en tu implementación. También puedes tomar una instantánea de los datos de tu panel y compartirla con Apigee para ayudar a resolver incidentes de asistencia.

La documentación, incluidas las instrucciones de instalación, se incluye en el archivo ZIP de la documentación de Edge 4.16.01 disponible en el sitio FTP de Apigee: ftp://ftp.apigee.com/.

Sin embargo, antes de instalar y usar el panel, debes completar el Acuerdo de Evaluación de Apigee incluido en el archivo ZIP del documento y enviarlo a Apigee por correo electrónico a orders@apigee.com.

Plataforma Edge

Rediseño de la IU de administración (Cloud 15.09.30)

Se actualizó el aspecto de varias páginas en la IU de administración. (MGMT-2627)

Servicios de APIs

Se rediseñó el asistente de proxy de API (Cloud 16.01.20)

Se rediseñó el asistente de proxy de API. Cuando haces clic en "+ API Proxy" en la página Proxies de API de la IU de administración, el asistente nuevo te guía por el proceso de creación del proxy de API. Están disponibles todos los mismos parámetros de configuración que en el asistente anterior del proxy de API. (MGMT-1376)

Crea proxies de API con documentos de OpenAPI (Swagger) (Cloud 16.01.20)

Como parte del nuevo rediseño del asistente de proxy de API, ahora puedes crear un proxy de API a partir de un documento de OpenAPI (Swagger). En la primera página del asistente de proxy de API, haz clic en Usar OpenAPI cuando selecciones Proxy inverso, App de Node.js o Sin destino. En el campo que aparece, ingresa la URL de tu documento de OpenAPI. Para obtener más información, consulta Compila un proxy de API simple. (MGMT-1376)

Compatibilidad con WSDL 1.2 para proxies de SOAP (Cloud 16.01.20)

Apigee Edge admite WSDL 1.2 para crear proxies de API que llamen a servicios SOAP. (MGMT-2835)

Variables de SSLInfo en la configuración de TargetEndpoint (Cloud 16.01.20)

En un TargetEndpoint de proxy de API, puedes establecer de forma dinámica los detalles de SSL/TLS para admitir requisitos de entorno de ejecución flexibles. En el siguiente ejemplo de cómo se configuraría SSLInfo en una configuración de TargetEndpoint, los valores se pueden proporcionar en el entorno de ejecución a través de un texto destacado de Java, una política de JavaScript o una política de Assign Message. Usa las variables de mensajes que contengan los valores que deseas establecer.

<TargetEndpoint>
...
  <SSLInfo>
    <Enabled>{myvars.ssl.enabled}</Enabled>
    <ClientAuthEnabled>{myvars.ssl.client.auth.enabled}</ClientAuthEnabled>
    <KeyStore>{myvars.ssl.keystore}</KeyStore>
    <KeyAlias>{myvars.ssl.keyAlias}</KeyAlias>
    <TrustStore>{myvars.ssl.trustStore}</TrustStore>
  </SSLInfo>
...
</TargetEndpoint>

Esta función se aborda en los siguientes documentos:

• Referencia de la configuración del proxy de API
• SSLInfo dinámico para TargetEndpoint con referencia de variable

(APIRT-1475)

Compatibilidad con el algoritmo RSA_SHA256 para las políticas de confirmación de SAML (Cloud 16.01.20)

Las políticas de aserción SAML ahora admiten el algoritmo RSA_SHA256 además de RSA_SHA1. (APIRT-1779)

Validación de cargas de certificados (Cloud, 16/01/20)

Para evitar que se suban certificados vencidos o no válidos a los almacenes de claves y de confianza, la API de administración valida los certificados cuando se suben. Los certificados se validan para garantizar que el tamaño del archivo no sea superior a 50 KB y que el formato sea PEM o DER. También se valida el vencimiento del certificado. Para anular la validación de vencimiento predeterminada (para no validar el vencimiento del certificado en la carga), usa el siguiente parámetro de consulta: ?ignoreExpiryValidation=true

Para obtener más información, consulta Cómo subir un archivo JAR a un almacén de claves y Cómo subir un certificado a un almacén de confianza. (SECENG-516) y (APIRT-2213)

Actualización automática en la página de registros de Node.js (Cloud 16.01.20)

Cuando ves los registros de Node.js desde el editor de proxy, la página Registros de Node.js se actualiza automáticamente de forma periódica para mostrar los registros nuevos que están disponibles. Haz clic en "Detener la actualización automática" para desactivarla. (MGMT-1692)

Encabezado HTTP X-Forwarded-For (Cloud 15.09.30)

Para mayor seguridad, Edge quita de forma predeterminada el encabezado de solicitud HTTP X-Forwarded-For, que puede contener una o más direcciones IP. El nuevo comportamiento predeterminado significa que la dirección IP del cliente que recibe Edge será la dirección IP que recibió del último protocolo de enlace TCP externo, no una dirección que podría suplantarse para eludir la política de Control de acceso.

Para cambiar este comportamiento predeterminado y permitir que las direcciones X-Forwarded-For lleguen a tus proxies de API, debes establecer la propiedad feature.enableMultipleXForwardCheckForACL=true en tu organización.

Acceso de JavaScript a las propiedades de la política (Cloud 15.07.08)

Cuando usas JavaScript en flujos de proxy de API, puedes acceder a las propiedades definidas en la política de JavaScript. Esto es especialmente útil si deseas usar variables conocidas en tu código JavaScript. Por ejemplo, supongamos que tu política de JavaScript contenía la siguiente definición de propiedad:

<Properties>
    <Property name='source'>response.content</Property>
</Properties>

En tu código JavaScript, puedes acceder a la respuesta del mensaje con una referencia a la propiedad "source", de la siguiente manera:
var source = properties.get('source'); // returns: response.content
o
var source = properties.source
o
var source = properties['source']

Para obtener más información, consulta la política de JavaScript. (APIRT-1460)

Auditorías a nivel de la organización (Cloud 15.07.08)

Los administradores de la organización pueden auditar el historial de las acciones realizadas a nivel de la organización. En la IU de administración, selecciona Administrador > Historial de la organización. Para obtener más información, consulta Auditorías: historial de la organización, el producto y la API. (MGMT-2232)

El administrador de la organización se quita a sí mismo del rol (Cloud 15.07.08)

Los administradores de la organización pueden quitarse del rol de administrador de la organización en la IU de administración. Para ello, deben ir a Administrador > Usuarios de la organización y hacer clic en Quitar junto a su nombre. (MGMT-934)

Indicador de progreso de la importación del paquete de proxy de API (Cloud 15.07.08)

Cuando subes un paquete grande de proxy de API en la IU de administración, se muestra una animación de "en proceso" para indicar que la importación aún se está realizando, lo que te impide interactuar con la IU de administración hasta que se complete la importación. (MGMT-1285)

Comportamiento y configuración de la caché (Cloud 15.07.22)

Para mejorar la administración y el uso de la caché en memoria, la configuración de "Maximum Elements in Memory" en los recursos de caché del entorno dejó de estar disponible a partir de la versión 15.06.10 de la nube de Edge. En la versión 15.07.22 de Edge Cloud, este parámetro de configuración se quitó de la IU de Create Cache en la parte de Environment Configuration de la IU de administración de Apigee Edge.

La cantidad total de elementos presentes en todos los recursos de caché (incluida la caché predeterminada) depende de la memoria total asignada a la caché. De forma predeterminada, la memoria total asignada para el almacenamiento en caché en memoria en un procesador de mensajes determinado es el 40% de la memoria total disponible. Los elementos se expulsarán de la caché en memoria solo cuando no haya suficiente memoria caché o cuando venzan los elementos. (MGMT-2413, APIRT-1140)

Configuración del servidor de destino en la IU de administración (Cloud 15.07.22)

La página APIs > Configuración del entorno de la IU de administración ahora te permite agregar, editar y borrar servidores de destino.

Además, se rediseñó la página para que las memorias caché también se puedan crear, agregar y borrar de forma intercalada en lugar de ir a una página nueva. Varias propiedades de caché, incluida "Máximo de elementos en la memoria", ya no están disponibles en la IU, ya que configurar estas propiedades ya no tiene ningún efecto en el comportamiento de la caché en el tiempo de ejecución. (MGMT-280)

SSL con registro de mensajes en syslog (Cloud 15.07.22)

La política Message Logging admite el envío de syslog a proveedores de administración de registros de terceros a través de SSL/TLS. Usa lo siguiente en la configuración de la política como elemento secundario directo del elemento principal:

<SSLInfo>
    <Enabled>true</Enabled>
</SSLInfo>

Para obtener más información, consulta la política de registro de mensajes. (APIRT-942)

IU de administración (Cloud 15.07.22)

El equipo de ingeniería de Apigee realizó varias correcciones de errores menores y mejoras de usabilidad en la IU de administración.

cURL en Trace (Cloud 15.09.02)

Cuando realizas un seguimiento de una llamada al proxy de API que hace una solicitud a un servidor de destino, puedes ver la solicitud al servidor de destino como un comando cURL. Selecciona la etapa "Solicitud enviada al servidor de destino" en el diagrama del mapa de transacciones y, luego, haz clic en el botón "Mostrar Curl" en la columna "Solicitud enviada al servidor de destino" del panel Detalles de la fase. (MGMT-2589)

Caracteres especiales de enmascaramiento de datos (Cloud 15.09.02)

Cuando se usa el enmascaramiento de datos para enmascarar datos sensibles en cargas útiles de JSON, ahora se pueden enmascarar caracteres especiales, como $, *, y {. (APIRT-1727)

Mapas de par clave-valor en la IU de administración (Cloud 15.09.30)

Ahora puedes crear y administrar mapas de clave-valor (KVM) con alcance de entorno en la IU de administración de Edge. Los KVM con permiso de entorno contienen pares clave-valor a los que puede acceder cualquier proxy de API en un entorno, como test o prod. En el menú de la IU de administración, ve a APIs > Environment Configuration > selecciona el entorno que desees > pestaña Key Value Maps. Para obtener más información, consulta Crea y edita mapas de clave-valor del entorno. (MGMT-1393)

Vencimiento predeterminado de la política PopulateCache en la IU de administración (Cloud 15.09.30)

Cuando agregas una política PopulateCache con el editor de proxy de API, el elemento <TimeoutInSec> para el vencimiento de la caché se completa previamente con un valor de 3,600 segundos (1 hora). El valor predeterminado anterior era de 300 segundos (5 minutos). (MGMT-2622)

Servicios para desarrolladores

Rendimiento de la página del producto de API, no se muestran apps para desarrolladores (Cloud, 16/01/20)

Cuando ves un producto de API en la IU de administración, se muestran las apps para desarrolladores asociadas a ese producto. Para mejorar el rendimiento de la IU, no se muestra la lista de apps para desarrolladores cuando se edita el producto de API. (MGMT-2869)

Columna Key en la página Developer Apps (Cloud 15.08.05)

En las organizaciones con una gran cantidad de apps para desarrolladores (miles), mostrar la columna Key en la página Developer Apps (que muestra la cantidad de claves por app) puede dificultar el rendimiento de la pantalla. Para mejorar el rendimiento de la pantalla en esta situación, comunícate con el equipo de asistencia de Apigee para establecer la siguiente propiedad a nivel de la organización: features.appsNoCredentialsEnabled = true. Esta propiedad quita la columna Key. Sin embargo, ten en cuenta que, si quitas la columna Key, también se quitará la capacidad de buscar por clave y secreto del consumidor. (MGMT-2486)

Spinner de progreso de la página Detalles del desarrollador (Cloud 15.09.30)

Cuando se carga la página Developer Details en la IU de administración, la sección Apps de la página muestra un ícono giratorio de progreso si aún se están cargando las apps. Esto mejora el comportamiento anterior, en el que la sección Apps aparecía vacía mientras se cargaban las apps. (MGMT-2667)

Monetización

Edita los nombres de los paquetes de la API (Cloud 16.01.20)

Puedes actualizar el nombre de un paquete de API en cualquier momento durante el ciclo de vida de la monetización, incluso cuando el paquete de API contiene un plan de tarifas publicado. (DEVRT-2177)

Se permiten decimales en los atributos personalizados (Cloud 16.01.20)

Cuando se usa un plan de "Tarifa con atributo personalizado", el atributo personalizado del encabezado del mensaje que se usa como multiplicador para la transacción ahora puede ser un valor decimal de hasta cuatro posiciones decimales. Para obtener más información sobre este tipo de plan, consulta Cómo especificar detalles de atributos personalizados de la hoja de tarifas (DEVRT-2191).

Nombre y ID del plan de tarifas en los informes de resumen (Cloud 15.09.02)

Cuando generas un informe de ingresos resumido con la API de administración, puedes agregar las columnas "Plan de tarifas" y "ID del plan" al informe. Para ello, agrega "RATEPLAN" como un atributo groupBy en la llamada a la API, como se describe en Crea informes. (Ten en cuenta que esta función aún no está disponible en la IU del informe de monetización). En los informes detallados, las columnas existentes de ID y nombre del plan de tarifas ahora se encuentran cerca del comienzo del informe, junto con las demás columnas de agrupación. (DEVRT-1740)

Servicios de estadísticas

Función sum( ) en las métricas de tiempo de respuesta (Cloud, 16/01/20)

En los informes personalizados de Analytics y las llamadas a la API, la función de agregación "sum" ahora está disponible para Target Response Time, Total Response Time y end_point_response_time. Por ejemplo, en la API de /stats (http://docs.apigee.com/management/apis/get/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/stats/%7Bdimension_name%7D-0), ahora puedes usar el siguiente parámetro de consulta "select": ?select=sum(total_response_time). (AXAPP-2006)

Informe de Latency Analysis: Nombres de proxy de API ordenados (Cloud, 16/01/20)

En la IU del informe de Latency Analysis (solo para planes empresariales de Apigee Edge), los proxies de API se enumeran alfabéticamente en la lista desplegable Proxy. (MGMT-2858)

Apps para desarrolladores en el panel que se muestran por nombre visible (Cloud, 16/01/20)

En el panel de la IU de administración, el gráfico de barras de las apps para desarrolladores enumera las apps para desarrolladores por nombre visible en lugar de por nombre interno. (MGMT-2853)

Nuevo widget de fecha y hora en los informes personalizados (Cloud 16.01.20)

Se mejoró el widget del selector de fecha y hora en una página de informes personalizados en la IU de administración. (MGMT-2881)

Desglose por ciudad en el mapa geográfico (Cloud, 15/7/2022)

El mapa geográfico de Analytics incluye un desglose de "Ciudad" para Estados Unidos y Canadá. Cuando haces clic en un estado o provincia en el mapa, se muestra una lista de las ciudades desde las que se originaron las llamadas. (MGMT-2282)

Caracteres | (barra vertical) y = en informes personalizados de Analytics (Cloud 15.09.02)

Las definiciones de informes personalizados de Analytics admiten el uso de los símbolos | (barra vertical) y =. Antes de esto, era necesario usar la codificación %7C y %3D para esos símbolos. (MGMT-2504)

Dimensión Sufijo de la ruta del proxy (Cloud 15.09.30)

Hay una nueva dimensión Proxy Path Suffix (proxy_pathsuffix) disponible en los informes personalizados de Analytics y las llamadas a la API. El sufijo de la ruta del proxy es la parte de una URL de proxy de API que viene después de la ruta base, como la ruta creada para los flujos condicionales. (AXAPP-1902)

Los informes muestran los IDs de desarrollador, no los nombres visibles (Cloud 15.09.30)

Cuando se realizan llamadas a la API de estadísticas de Edge con la API de /stats que devuelve desarrolladores, se muestra el nombre visible del desarrollador junto con su ID. Anteriormente, solo se devolvía el ID de desarrollador. (AXAPP-1759)

Fallas corregidas

En esta versión, se corrigieron los siguientes errores.

Private Cloud 4.16.01

En la siguiente tabla, se enumeran los errores corregidos desde la versión 4.16.01 de Edge para nubes privadas. Para obtener estas correcciones, sigue las instrucciones para actualizar tu instalación de 4.16.01 a los RPM y archivos de asistencia más recientes, como se describe en Actualiza Apigee Edge 4.16.01.x a la versión 4.16.01 más reciente.

Cloud 16.01.20

Cloud 15.07.08

Cloud 15.07.22

Cloud 15.08.05

Cloud 15.09.02

Cloud 15.09.30

Nube privada 4.15.07.03

Nube privada 4.15.07.01

Problemas conocidos

Esta versión tiene los siguientes problemas conocidos.

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart