Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

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

El jueves 13 de octubre de 2016, comenzamos a lanzar una nueva versión de Apigee Edge para la nube pública.

Nuevas funciones y actualizaciones

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

Flujos y enlaces de flujo compartidos para operacionalizar proxies de API (solo versión beta a pedido)

Una nueva función de "Flujos compartidos" te permite operacionalizar la funcionalidad en los proxies de API. Si combinas políticas y recursos condicionales en un flujo compartido, puedes hacer referencia a él desde cualquier proxy de API para ejecutar una lógica reutilizable de una sola fuente. Por ejemplo, un flujo compartido podría verificar la clave de API, proteger contra las detenciones de picos y registrar datos.

Puedes definir flujos compartidos en la IU de administración (APIs > Flujos compartidos) y, luego, hacer referencia a ellos de dos maneras diferentes:

Con una nueva política de Flow Callout en un proxy de API
En un artefacto nuevo llamado Flow Hooks, que se encuentra en las siguientes ubicaciones:
- Solicitud: Antes del PreFlow de ProxyEndpoint, después del PostFlow de TargetEndpoint
- Respuesta: Antes del PreFlow de TargetEndpoint, después del ProxyEndpoint PostFlow
Estos puntos de conexión te permiten ejecutar lógica operativa antes o después de los puntos de flujo principales del proxy individual. Puedes asignar flujos compartidos a estas ubicaciones de Flow Hook en la IU de administración (APIs > Configuración del entorno > Hooks de flujo).

Mapas de clave-valor encriptados

Puedes crear mapas de clave-valor (KVM) encriptados para almacenar información sensible, como credenciales o datos de HIPAA/PII. Esta función es diferente del almacén seguro (bóveda) de Edge existente y está diseñada para reemplazarlo, ya que solo se puede acceder a los valores de la bóveda con Node.js (además de la API de administración). Puedes acceder a los valores de KVM encriptados con Node.js o la política de operaciones de mapas de clave valor.

Crea KVM encriptados

Usa las APIs de KVM existentes. Cuando incluyes “encrypted”: “true” en la definición de carga útil cuando creas un KVM, Edge encripta el KVM y genera una clave de encriptación que tiene el mismo alcance que el KVM.
No puedes usar la política de operaciones de mapas de clave-valor para crear un KVM encriptado.
No puedes encriptar un KVM no encriptado existente.

Usa KVM encriptados

Usa la política de operaciones de mapas de clave-valor para obtener y actualizar los valores de KVM encriptados.
Cuando obtengas un valor de clave encriptado, agrega el prefijo "private." a la variable para contener el valor. Por ejemplo: <Get assignTo="private.secretVar">. Esa private.secretVar variable contiene el valor desencriptado.
Cuando actualizas un valor con la política, no necesitas hacer nada especial. El valor se encriptará automáticamente en los KVM encriptados.
También puedes acceder al valor desencriptado con el módulo apigee-access en el código de Node.js. Usa la función getKeyValueMap() para recuperar un KVM según el nombre y el alcance. Hay dos funciones disponibles en el objeto que se muestra: getKeys(callback) para obtener un array de nombres de clave y get(key, callback) para obtener el valor de una clave en particular. Por ejemplo:
```
var apigee = require('apigee-access');
  var encryptedKVM = apigee.getKeyValueMap('VerySecureKVM', 'apiproxy');
  encryptedKVM.get('secret1', function(err, secretValue) {
  // use the secret value here
});
```

(APIRT-1197)

Advertencia:

Operaciones PUT de KVM con claves nulas

Si una política de operaciones de mapas de clave-valor intenta colocar una clave-valor nueva en un mapa de clave-valor (KVM) con una clave nula, se crea automáticamente la siguiente clave: __$$_EDGE_KVM_EMPTY_KEY_$$__

Esta situación ocurriría, por ejemplo, si propagas una clave con una referencia de variable y la variable a la que se hace referencia es nula. A medida que se intentan nuevas operaciones PUT con claves nulas, solo se usa esa clave, por lo que los valores existentes para esa clave se pueden reemplazar cada vez que se ejecute la política.

El comportamiento anterior para una clave nula era que la clave-valor no se agregaba al KVM. En cambio, la entrada permanecía en la caché en memoria del procesador de mensajes y estaba temporalmente disponible para las operaciones Get posteriores. Si la implementación de tu política de KVM se basa en el comportamiento anterior, las operaciones Get en claves nulas ahora fallarán porque no hacen referencia al nuevo nombre de clave (anterior) que se crea para las claves nulas. (APIRT-3530)

Advertencia:

Validación de políticas en pasos de FaultRule antes de la implementación

Durante la implementación del proxy de API, Edge ahora valida las políticas que se enumeran en los pasos de FaultRule antes de la implementación. Antes de esta corrección, la implementación se realizaba correctamente con un código de estado HTTP 200, incluso si no existían las políticas que se enumeraban en los pasos de FaultRule, y el error InvalidPolicyReference no se producía hasta el tiempo de ejecución. Ahora, se muestra un estado HTTP 400 junto con un error InvalidPolicyReference durante la implementación. Si usas secuencias de comandos para implementar proxies de API, ahora verás fallas de implementación si FaultRules hace referencia a políticas que no existen. (MGMT-3354)

URLs de especificaciones de OpenAPI incluidas en los metadatos del proxy de API

Cuando creas un proxy de API basado en una especificación de OpenAPI, la ubicación de la especificación de OpenAPI se almacena en los metadatos del proxy de API. Por ejemplo, si usas la API de administración para obtener los detalles de una revisión de proxy, los metadatos incluyen la ruta de acceso a la especificación de OpenAPI en el siguiente formato:

"spec" : "https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget.yaml"

Esta mejora admite la versión de próxima generación de Edge, que vincula las especificaciones de OpenAPI a los proxies de API, los productos de API y los documentos de referencia de la API en el nuevo portal para desarrolladores. (MGMT-2913)

Control de IP de cliente con Sense

Para controlar con mayor precisión dónde encontrar direcciones IP para la detección de bots de Sense cuando se usan productos de enrutamiento como Akamai, Sense te permite definir la ubicación de la IP del cliente con una variable additionalIPVars. Por ejemplo, puedes configurar additionalIPVars para usar el encabezado true-client-ip, que contiene la IP correcta de Akamai para evaluar en las reglas de bots. (APIRT-3332)

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.

ID del problema	Descripción
APIRT-3507	Errores intermitentes (como errores de SNI) en las llamadas de servicio de JavaScript
APIRT-3408	El módulo de estadísticas de apigee-access de la versión 160817 de MP procesa los mensajes de manera diferente
APIRT-3390	Cambio en la respuesta de falla que muestra la política de token de acceso de actualización Advertencia: Cambio en el código de error "invalid_client" de OAuthV2. Ten en cuenta el siguiente cambio en un código de error que arrojan las operaciones OAuthV2 policy GenerateAccessToken y RefreshAccessToken cuando la propiedad <GenerateResponse> de la política de OAuthV2 se establece en false: `{"ErrorCode" : "invalid_client", "Error" :"Client identifier is required"}` se cambió a: `{"ErrorCode" : "InvalidClientIdentifier", "Error" :"Client identifier is required"}` Te recomendamos que cambies las condiciones de las reglas de falla que detectan "`invalid_client`" para detectar los códigos antiguos y nuevos. Por ejemplo, en tu regla de falla, cambia: `(fault.name = "invalid_client")` a lo siguiente: `(fault.name = "invalid_client") OR (fault.name = "InvalidClientIdentifier")`
APIRT-3389	Advertencia: Error al subir cargas útiles de Node.js de más de 25 KB Ahora se permite subir cargas útiles de Node.js de más de 25 KB.
APIRT-3381	Latencias altas en los proxies de producción del cliente
APIRT-3366	Las políticas de JavaScript fallan en todas las organizaciones de prueba nuevas
APIRT-3363	El análisis de URL no válido muestra un estado 500 con ApplicationNotFound
APIRT-3356	Mensaje de token no válido de OAuth
APIRT-3355	Error 403 intermitente en el proxy de OAuth
APIRT-3285	Advertencia: Vencimiento de token de OAuth2 incoherente Cuando generas un token de OAuth con la política de OAuth v2.0, puedes establecer el vencimiento del token por referencia o por un valor predeterminado codificado. Por ejemplo: `<ExpiresIn ref="kvm.oauth.expires_in">1800000</ExpiresIn>`. La primera vez que se estableció el vencimiento del token por referencia, Edge almacenó y usó ese valor para cada vencimiento de token nuevo. Se corrigió este error para usar el valor de referencia o, si no se proporciona ningún valor de referencia, el vencimiento predeterminado definido en la política. Esta corrección puede cambiar la duración de los vencimientos de tus tokens, y es posible que experimentes efectos secundarios, como más errores de token no válidos, lo que puede requerir que implementes actualizaciones de tokens más frecuentes o cambies el vencimiento predeterminado en tus políticas de OAuth.
APIRT-3261	Las credenciales se validan con otra app para desarrolladores en producción
APIRT-3234	La app de Node.js muestra NPE
APIRT-3223	Problema de caché obsoleta de Apigee
APIRT-3193	El servidor de destino de Node.js se bloquea después de la migración a ASG
APIRT-3152	La llamada de administración de cachedlogs hace que los mensajes de registro se interrumpan
APIRT-3117	El MP alcanzó el 100% de uso de CPU y dejó de entregar tráfico
APIRT-3064	Router: Mensaje de error 503 personalizado del router
APIRT-2620	Grupo de subprocesos separado para algunos pasos de bloqueo para mejorar el manejo de cargas
CORESERV-774	El acceso con una clave válida con una referencia de apiproduct no válida causa un error interno del servidor