19.03.01: Notas de la versión de Apigee Edge para nube pública

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

El martes 3 de diciembre de 2019, comenzamos a lanzar una actualización de esta versión de Apigee Edge para la nube pública. (El lanzamiento original fue el jueves 18 de abril de 2019).

Nuevas funciones y actualizaciones

A continuación, presentamos las nuevas funciones y actualizaciones de esta versión.

ID del problema Nombre del componente Description
Apigee comenzó a lanzar las siguientes actualizaciones el 1 de octubre de 2019
110995050 Entorno de ejecución de API

Balanceo de cargas: Más control para quitar servidores con errores

Cuando configuras un balanceador de cargas para un proxy de API, puedes determinar cuántos errores de respuesta ocurren antes de que se quite un servidor de la rotación del balanceo de cargas. Un error de respuesta significa que Apigee no recibe ninguna respuesta de un servidor de destino. Cuando esto sucede, el contador de fallas suma una. Cuando Apigee recibe una respuesta de un destino, incluso si la respuesta es un error de HTTP (como 500), se cuenta como una respuesta del servidor de destino y el contador de fallas se restablece. Para ayudar a garantizar que las respuestas HTTP incorrectas (como 500) también aumenten el recuento del contador de fallas a fin de eliminar un servidor en mal estado de la rotación del balanceo de cargas lo antes posible, puedes agregar un nuevo elemento <ServerUnhealthyResponse> con elementos secundarios <ResponseCode> a la configuración de tu balanceador de cargas. Edge también contará las respuestas con esos códigos como fallas.

<HTTPTargetConnection>
  <LoadBalancer>
    <Algorithm>RoundRobin</Algorithm>
    <Server name="target1" />
    <Server name="target2" />
    <ServerUnhealthyResponse>
        <ResponseCode>500</ResponseCode>
        <ResponseCode>502</ResponseCode>
        <ResponseCode>503</ResponseCode>
    </ServerUnhealthyResponse>
    <MaxFailures>5</MaxFailures>
  </LoadBalancer>
</HTTPTargetConnection>
  
  
130416715 Seguridad

Mejoras en la política AccessControl

La política AccessControl determina qué direcciones IP pueden realizar llamadas a un proxy de API. Un nuevo elemento en esa política brinda a los desarrolladores de APIs más control para identificar qué direcciones IP evaluar.

<IgnoreTrueClientIPHeader>: Opcional (el valor predeterminado es falso). Cuando se establece esto como verdadero, la política ignora el encabezado True-Client-IP y evalúa las direcciones IP en el encabezado X-Forwarded-For, con el comportamiento de evaluación X-Forwarded-For que hayas configurado.

<AccessControl async="false" continueOnError="false"
    enabled="true" name="Access-Control-1">
    <DisplayName>Access Control-1</DisplayName>
    <IgnoreTrueClientIPHeader>true</IgnoreTrueClientIPHeader>
    ...
</AccessControl>
Apigee lanzó las siguientes actualizaciones el 18 de abril de 2019
117558815,
119856499,
110548137,
79526748,
72989449,
70712859,
69049041
Entorno de ejecución de API JWS y JWT
Agregamos políticas nuevas para la compatibilidad con JWS y mejoramos nuestras políticas de JWT existentes.

Para obtener más información, consulta esta publicación de la Comunidad.

122610025 Entorno de ejecución de API Permite que RaiseFault también establezca el motivo de la falla y variables arbitrarias como en AssignMessage

Hay dos elementos nuevos disponibles en la política RaiseFault para que el control de FaultRules sea más limpio y potente.

  • ShortFaultReason es un valor booleano que, cuando se establece en verdadero, coloca el nombre de la política en la variable fault.reason.
  • AssignVariable, disponible en FaultResponse, te permite asignar la respuesta de error a una variable para que la usen otras políticas en el flujo del proxy de API.
121149811 Destinos alojados Límites aplicados para los destinos alojados

Ahora se aplican límites a los destinos alojados. Consulta Límites para obtener más detalles.

117659213 Entorno de ejecución de API Parametriza rangos de IP en la política de AccessControl

Ahora puedes usar variables de plantillas de mensajes para establecer direcciones IP y máscaras de CIDR en la política de AccessControl. Por ejemplo, si deseas almacenar una dirección IP y una máscara en un mapa de clave-valor (KVM), puedes recuperar esos valores de una variable que establezcas en el flujo del proxy de API. Esto te permite cambiar los valores de IP con mayor facilidad en el tiempo de ejecución sin tener que cambiar la configuración de tu política.

Por ejemplo, en lugar de hacer lo siguiente:

<MatchRule action="DENY">
    <SourceAddress mask="24">198.51.100.1</SourceAddress>
</MatchRule>
     

Podrías configurar la política de esta manera, suponiendo que los valores se almacenan en un KVM y que usas la política KeyValueMapOperations para recuperar los valores y asignarlos a las variables que se muestran aquí:

<MatchRule action="DENY">
    <SourceAddress mask="{kvm.mask.ref}">{kvm.ip.ref}</SourceAddress>
</MatchRule>
     
113599885 Supervisión de API Roles de supervisión de la API

La supervisión de la API proporciona dos roles: Administrador de supervisión de la API y Usuario de supervisión de la API, que se describen en Accede a la supervisión de la API. Estas se pusieron a disposición en diciembre de 2018.

132256772 Entorno de ejecución de API Se agregó el encabezado X-Apigee.Message-Timeout a la solicitud

Ahora, Edge agrega el encabezado X-Apigee.Message-Timeout a cada solicitud. Edge usa este encabezado de forma interna. No confíes en los valores de los encabezados X-Apigee.* en tus proxies de API, ya que estos encabezados no están destinados para el uso del cliente y Apigee los puede quitar o cambiar en cualquier momento.

78575018 Nube privada o OPDK Omitir el servidor de administración para omitir el registro del almacén de datos de la puerta de enlace cuando hay varios pods de puerta de enlace

Errores corregidos

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.

ID del problema Nombre del componente Description
Apigee comenzó a lanzar las siguientes correcciones el 3 de diciembre de 2019
Se corrigieron problemas de seguridad.
Apigee comenzó a lanzar las siguientes correcciones el 29 de octubre de 2019
139381794 Servidor de administración

Controla los errores de eliminación del almacén de claves para que no falle la llamada a la API

Apigee comenzó a lanzar las siguientes correcciones el 1 de octubre de 2019
140761319 Entorno de ejecución de API

x-apigee.edge.execution.sense.action siempre se establece en nulo

139091614 Entorno de ejecución de API

En la política ResponseCache, NIOTheread se ejecuta sin rechazo del grupo de subprocesos

131331305 Core Services

Varios exportadores de registros en los routers de Apigee causan un uso elevado de la CPU

136690640 Entorno de ejecución de API

Errores 404 intermitentes en organizaciones específicas

140948100 Entorno de ejecución de API

El flujo compartido implementado no se ejecuta en algunos procesadores de mensajes

Apigee lanzó las siguientes correcciones el 13 de septiembre de 2019
132654321 Servidor de administración Los registros de auditoría no muestran datos
131246911 Servidor de administración Habilita la compatibilidad con dominios más nuevos, como *.games y *.asia, para los correos electrónicos de desarrolladores en un portal
Apigee lanzó las siguientes correcciones el 18 de abril de 2019
123844598 Servidor de administración Las claves de apps borradas no se pueden volver a importar después de 24 horas
123588156 Entorno de ejecución de API Quitar el encabezado Content-Length de la respuesta falla con un 304
122732400 Entorno de ejecución de API El parámetro de configuración api.timeout anula io.timeout.millis
122545281 Entorno de ejecución de API La máscara de datos de DebugSession para JSON debe tener en cuenta el caso en el que jsonPayload es un array
122355807 Servidor de administración Comportamiento incorrecto de los permisos para usuarios con varios roles
121393556 Entorno de ejecución de API x_apigee_fault_code se establece como "org/codehaus/jackson/map/ObjectMapper"
120998548 IU de Edge Error de escritura en el mensaje de error: El certificado no es válido o no se puede confiar en él
120990929 Entorno de ejecución de API La respuesta HTTP-413 de Nginx/Apigee Router revela el tipo de servidor
120799489 Entorno de ejecución de API Cuando se usa httpClient con una devolución de llamada asíncrona de JavaScript httpComplete(), se silencia el resultado de debugsession (registro de seguimiento)
120794339 Entorno de ejecución de API MPs que se desviaron para la organización
120277011 Servidor de administración Se necesita validación de entrada: No se puede implementar el proxy si el nombre de host del servidor de destino tiene **
119976417 Supervisión de API La supervisión de API muestra un tiempo de respuesta del proxy alto, mientras que las estadísticas muestran un tiempo de respuesta del objetivo alto
119947481 Entorno de ejecución de API En el caso de excepción, la carga útil que se debe enmascarar se registra como texto sin formato
119877164 Nube privada o OPDK Los routers generan errores y el procesador de mensajes se desconecta con TLS habilitado

Esta corrección se incluirá en la próxima versión de Edge para la nube privada.

119816218 Entorno de ejecución de API La caché de respuestas ignora el encabezado Expires si se resuelve en 0 o en un número negativo
119770242 Entorno de ejecución de API La comunicación del router con el MP falló, lo que provocó un tiempo de inactividad completo: El error en PostClientFlow provoca un bucle infinito
119443145 Servidor de administración El proxy de API devuelve el error 404 cuando se cambia el nombre de ProxyEndpoint y se vuelve a implementar
119260281 Entorno de ejecución de API Error de registro "No se pudo analizar como una cadena3000.0"
118743407 Servidor de administración Duración de la implementación del proxy de Apigee
118447966 Entorno de ejecución de API Error en los textos destacados de JavaScript en la versión 180608_07 de MP
117549719 Entorno de ejecución de API No coincide el URI de la solicitud con la ruta base del proxy
117219520 Entorno de ejecución de API MessageLogging: El registrador de Syslog usa un formato de fecha incorrecto como predeterminado y muestra los milisegundos de forma incorrecta
117116435 Entorno de ejecución de API Errores intermitentes del archivo JavaScript
117091520 Entorno de ejecución de API Los JavaCallouts fallan después de la versión 18.06.08 del procesador de mensajes
116165318 Entorno de ejecución de API Las implementaciones simultáneas del mismo paquete provocan RepositoryException
116055025 Servicio de Configstore Faltan hosts virtuales y aplicaciones en los procesadores de mensajes después del inicio
115614498 Entorno de ejecución de API Necesitas asistencia para el ILB en el OPDK

Esta corrección se incluirá en la próxima versión de Edge para la nube privada.

113972537 Entorno de ejecución de API Varios P1: Se genera NullPointerException desde el código de Node.js en los proxies de Trireme - 500 Internal Server Error
113904969 Asistencia de Apigee Problema con el borrado de proxies de API en organizaciones de demostración
113554802 Entorno de ejecución de API La validación de la aserción de SAML falla con NullPointerException
113315737 Servidor de administración No se pudo implementar el proxy debido a que faltan registros de implementación en Zookeeper
112767195 Entorno de ejecución de API Errores intermitentes de DataStore al acceder a la política de KVM
112162179 Entorno de ejecución de API Almacenar en caché un objeto JavaScript sin convertirlo en cadena puede provocar bloqueos
111860576 Entorno de ejecución de API Falta un error en la política de cuotas
111671525 Destinos alojados Los códigos de respuesta no exitosos de los destinos alojados activan el flujo de fallas en el proxy
111523933 Extensiones(conectores) Problema de almacenamiento en caché de la política ExtensionCallout
111420263 Entorno de ejecución de API Excepción ConcurrentModification en MessageLogging
110843526 Servidor de administración La API de administración para crear o actualizar el hook de flujo debe validar el flujo compartido
110805739 Entorno de ejecución de API El TTL no se establece como -1 en el flujo de CPS cuando Reuserefreshtoken es verdadero y el vencimiento del token de actualización no se establece de forma explícita
110429629 Entorno de ejecución de API La política BasicAuthentication emite la variable request.headers.Authorization en DebugSession
110425503 Entorno de ejecución de API La recarga de Nginx causa problemas de disponibilidad de MP
110311540 Entorno de ejecución de API NPE cuando se cierra MP
110161455 Entorno de ejecución de API AccessEntity debería usar el método de recuperación por nombre de la app en lugar de recuperar todas las apps para las organizaciones de CPS
90695522 Entorno de ejecución de API context.proxyRequest.asForm generates java.lang.ArrayIndexOutOfBoundsException: 1
79734096 Servidor de administración Los registros de auditoría de los proxies ya no se filtran en función de los proxies
78105568 Servidor de administración Las implementaciones de flujo compartido no aparecen en las llamadas a la API de administración de /org/{org}/sharedflows/{sharedflow}/deployments después de actualizar un flujo compartido implementado
77528868 Trireme Regresión de Trireme: El servidor de script server.js salió con el código de estado -1: No se encontró la propiedad 0
73766568 Entorno de ejecución de API La actualización de 170213_02 a 171117_01 provocó un gran aumento en la latencia del proxy con el destino Trireme/Node
72710481 Entorno de ejecución de API CacheServiceImpl/CacheMemoryLimiter NullPointerException
68861063 Entorno de ejecución de API Controla la NPE durante el cierre de los routers
68833699 Entorno de ejecución de API A veces, no se quita la información sobre el proxy de API del árbol de clasificación de APIs
67377575 Destinos alojados No coincide el registro de Analytics con lo que se envía al cliente en un proxy de Node.js
112481174 Destinos alojados No se debe fallar la anulación de la implementación del proxy debido a un error de Turbo
117171470 Destinos alojados Cómo corregir el mensaje de error de app.yaml no válido
67169139 Entorno de ejecución de API El formato de la marca de tiempo de syslog de la política MessageLogging no es correcto
67165418 Entorno de ejecución de API Error de licencia sobre el uso de más procesadores de mensajes, incluso cuando se usan menos de los que permite la licencia

Esta corrección se incluirá en la próxima versión de Edge para la nube privada.

67165195 Entorno de ejecución de API ValidateSAMLAssertion no verifica la firma en una aserción incorporada en una respuesta firmada
66214414 Entorno de ejecución de API La variable currentstep.flowstate siempre devuelve "SHARED_FLOW" cuando se hace referencia a ella desde un flujo compartido
65731656 Entorno de ejecución de API La API de Protección contra amenazas falla de forma intermitente para la misma solicitud
133197060 Entorno de ejecución de API Se recibe el error 57 de tiempo de espera de la puerta de enlace desde MP hasta el destino
110535186 Entorno de ejecución de API ServiceCallout sin elemento Response y HTTPTargetConnection que apunta al proxy: A VECES no hay llamada
132443137 Entorno de ejecución de API Cambia el comportamiento del procesador de mensajes para ignorar los encabezados que comienzan con X-Apigee-*. Como resultado, debes refactorizar cualquier código que use encabezados X-Apigee-* y reemplazarlos por los que se admiten.
125709964 Entorno de ejecución de API Invalidate Cache with purgeChildEntries no funciona como se esperaba