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

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

En las siguientes fechas, comenzamos a lanzar actualizaciones de componentes para Apigee Edge para la nube pública:

• Procesador de mensajes: viernes, 1 de mayo de 2020
• Administración de APIs: Lunes, 20 de abril de 2020
• Administración de la monetización: lunes, 20 de abril de 2020
• Lanzamiento de parche de API Management: lunes, 22 de junio de 2020
• Lanzamiento de parche de administración de la monetización: lunes, 6 de julio de 2020
• Actualización de seguridad del servidor de administración: lunes, 24 de agosto de 2020
• Lanzamiento de parches del Message Processor con correcciones de errores: jueves, 24 de septiembre de 2020
• Lanzamiento de parche del procesador de mensajes con correcciones de errores: lunes, 26 de octubre de 2020
• Lanzamiento de parche de Message Processor con correcciones de errores: lunes, 1 de febrero de 2021

Nuevas funciones y actualizaciones

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

Políticas de JWT

• Encriptación de JWT

  Las políticas de JWT te permiten generar, verificar y decodificar tokens encriptados. Los elementos nuevos en las políticas incluyen lo siguiente:

  • <Type>: Te permite establecer si los tokens están firmados o encriptados.
  • <EncryptionAlgorithms>: Te permite establecer los algoritmos de encriptación <Key> y <Content>.

  (67165581)

• Compatibilidad con algoritmos PSS en tokens firmados

  Las políticas para generar y verificar JWT y JWS ahora admiten los algoritmos PS256, PS384 y PS512, como se describe en IETF RFC 7518. (119856499)

• Hora de inicio relativa de GenerateJWT para el token

  Cuando generas un JWT con la política de GenerateJWT, el elemento <NotBefore> te permite especificar un tiempo relativo entre el momento en que se genera un token y el momento en que se vuelve válido. Por ejemplo, un valor de <NotBefore> de 2 h significa que un token no es válido hasta 2 horas después de que se genera. Puedes configurar el tiempo de <NotBefore> en milisegundos (ms), segundos (s), minutos (m), horas (h), días (d) o semanas (w). (126261970)

• Cómo hacer referencia a PublicKey/Certificate en VerifyJWT

  En la política VerifyJWT, un elemento <PublicKey> / <Certificate> te permite hacer referencia al certificado con formato PEM con el que se verificarán las firmas de los JWT entrantes. Por ejemplo:

  <PublicKey>
    <Certificate ref='public.certificate_pem'/>
  </PublicKey>

  (132918033)

Funciones de plantillas de mensajes

A continuación, se indican las nuevas funciones de plantillas de mensajes disponibles en esta versión:

• firstnonull: Muestra el valor del primer argumento (el más a la izquierda) que no es nulo. (139698514)
• xpath: Te permite aplicar una expresión de ruta XML (XPath) para analizar variables XML. (123246424)

Política AssignMessage: AssignVariable te permite hacer referencia a una plantilla de mensajes

En la política de AssignMessage, el elemento <AssignVariable> / <Template> permite un atributo ref, lo que te permite incorporar una plantilla predefinida en el tiempo de ejecución que puede cambiar sin tener que modificar la política. (118396082)

Varios alias de certificado

Cuando configuras TLS y usas varios certificados en un almacén de claves, cada uno con un alias diferente, Edge te permite hacer referencia a alias de certificados específicos en tu configuración de <SSLInfo><KeyAlias>. Para habilitar este comportamiento actualizado, establece una nueva propiedad HTTPClient.choose.alias.by.keyalias en true en el archivo http.properties de los procesadores de mensajes. Los usuarios de Edge para la nube pública deben comunicarse con el equipo de asistencia para agregar esta propiedad. (142141620)

Política JSONtoXML: Omitir la declaración XML, aplicar sangría al resultado

Dos nuevas opciones booleanas en la política de JSONtoXML te brindan más control sobre la salida XML.

• <Options> <OmitXmlDeclaration>: Cuando se establece en verdadero (el valor predeterminado es falso), el elemento <OmitXmlDeclaration> omite la declaración XML <?xml version="1.0" encoding="UTF-8"?> predeterminada que genera la política.

• <Options> <Indent>: Cuando se establece en verdadero (el valor predeterminado es falso), el elemento <Indent> aplica sangría al resultado XML. Por ejemplo, en lugar de este resultado:

  <Array><n>1</n><n>2</n><n>3</n></Array>

  El elemento Indent produce lo siguiente:

  <Array>
   <n>1</n>
   <n>2</n>
   <n>3</n>
  </Array>

(65142394)

Respuestas para el análisis de hosts virtuales

Si se realizó una solicitud a la dirección IP de un extremo de Apigee (no se especificó ningún host virtual), Edge devolvió una respuesta HTTP 200 y un documento HTML en blanco del host virtual predeterminado de Apigee asociado a esa dirección IP. Para evitar la impresión incorrecta de que tal respuesta podría representar una vulnerabilidad potencial que se podría explotar, se interrumpe la conexión y no se devuelve ninguna respuesta. (140005396)

Propiedades del servidor de destino en Trace para ayudar a solucionar problemas

Las siguientes propiedades de seguimiento nuevas ayudan a solucionar problemas de conexión de destino, ya que muestran si se almacenó en caché el objeto HTTPClient para el servidor de destino: isHttpClientCached y isFromClientPool. (140574604)

Política MessageLogging: Mensaje de Syslog

En la política de MessageLogging, un nuevo elemento <Syslog> / <PayloadOnly> (booleano) te permite determinar si se antepone automáticamente algo al <Message> que defines. Si configuras <PayloadOnly> como verdadero, no se antepone nada a la definición del mensaje (independientemente de la configuración de <FormatMessage>). Si se configura como falso (predeterminado), el parámetro de configuración <FormatMessage> determina qué se antepone al mensaje de registro. (68722102)

Vencimiento de las políticas de caché

Un nuevo elemento de vencimiento <TimeoutInSeconds> en la política ResponseCache y la política PopulateCache se comporta de la manera en que se pretendía que funcionara el elemento <TimeoutInSecs> existente originalmente. Usa el elemento nuevo. El elemento <TimeoutInSecs> obsoleto aún existe para la retrocompatibilidad. Si se configuran los elementos <TimeoutInSecs> y <TimeoutInSeconds>, Edge usa <TimeoutInSeconds>. (119172893)

Variable de flujo virtualhost.aliases.values

Una nueva variable de flujo de mensajes virtualhost.aliases.values de solo lectura devuelve un array con formato JSON de todos los alias asignados al host virtual al que se llamó en la solicitud entrante. (128453178)

Nuevo parámetro para garantizar el borrado de la revisión del proxy

Se agregó un nuevo parámetro de búsqueda force a la revisión de proxy de API de eliminación. En los casos en que la revisión aparece en la API de List API Proxies, pero no se puede consultar, este parámetro garantiza que se borre la revisión del proxy. (111691721)

Por ejemplo:

DELETE /v1/organizations/myorg/apis/myproxy/revisions/2?force=true

Nueva variable de flujo para los valores de alias de host virtual

Una nueva variable de flujo de mensajes virtualhost.aliases.values de solo lectura devuelve un array con formato JSON de todos los alias asignados al host virtual al que se llamó en la solicitud entrante. (128453178)

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.