Proxy

Aplicar la política Proxy para invocar otra API dentro del ensamblaje, especialmente si la API separada contiene una carga útil grande. La respuesta del programa de fondo se almacena en message.body y en la variable de objeto de respuesta si es que está definida. Únicamente se permite ejecutar una política por flujo de ensamblaje exclusivo.

Soporte de pasarela

Tabla 1. Tabla que muestra qué pasarelas soportan esta política y la versión de política correspondiente
Pasarela	Versión de política
DataPower® Gateway (v5 compatible)	1.0.0
DataPower API Gateway, funcionalidad proporcionada por Invoke

En este tema se describe cómo configurar la política en la interfaz de usuario de ensamblaje. Para obtener detalles sobre cómo configurar la política en el origen de OpenAPI , consulte proxy.

Acerca de

Sólo se permite ejecutar una política Proxy por flujo exclusivo del ensamblaje. Se puede aplicar más de una política Proxy , si están contenidas en ramas mutuamente excluyentes del ensamblaje.

Puede utilizar la política Proxy para devolver datos de formulario de varias partes, es decir, cuando la respuesta se establece enContent-Type: multipart/related. Sin embargo, Proxy debe ser la última política del ensamblaje, de lo contrario, la respuesta que se recibe se puede manipular durante los pasos posteriores, lo que hace que se pierdan los datos de formulario de varias partes.

La política proxy , si está dentro de una política condicional, debe ser la política final que se va a ejecutar en la API. Si necesita más proceso después, utilice la política invoke en lugar de la política proxy .

Propiedades

En la tabla siguiente se listan las propiedades de política, se indica si se requiere una propiedad, y se especifica los valores válidos y predeterminados para la entrada, así como el tipo de datos de los valores.

Tabla 2. Propiedades de política de Proxy
Etiqueta de propiedad	Obligatorio	Descripción	Tipo de datos
Título	Sí	El título de la política. El valor predeterminado es `proxy`.	serie
Descripción	Nee	Una descripción de la política.	serie
URL invoke	Sí	Especifica un URL para el servicio de destino. Para una API SOAP, se añade un URL de forma predeterminada. Cuando es posible, se proporciona el valor URL de proxy a partir de información definida en el WSDL importado.	serie
Perfil TLS	Nee	Especifica un perfil TLS que se va a utilizar para la transmisión segura de datos.	serie
Timeout	Sí	El tiempo durante el que se va a esperar una respuesta del punto final (en segundos). El valor predeterminado es `60`.	entero
Nombre de usuario	Nee	El nombre de usuario que se va a utilizar para la autenticación básica HTTP.	serie
Contraseña	Nee	La contraseña que se va a utilizar para la autenticación básica HTTP.	serie
Método HTTP	Sí	El método HTTP que se va a utilizar para el proxy. Los valores válidos son: Conservar GET POST PUT SUPRIMIR PARCHE HEAD OPCIONES El valor predeterminado es `Keep`. Al utilizar `Keep` o eliminar la propiedad del origen, se utiliza el método HTTP de la solicitud entrante.	serie
Compresión	Nee	Marque este recuadro de selección si desea habilitar la compresión Contenido-Codificación al cargar. El recuadro de selección está sin marcar de forma predeterminada.	booleano
Tipo de memoria caché	Nee	El tipo de caché determina si se guardan documentos en caché, respetando o anulando las directrices de control de caché HTTP recibidas en la respuesta del URL de destino. Esta propiedad solamente entra en vigor cuando se recibe una respuesta, de lo contrario la política siempre devuelve la respuesta no caducada guardada anteriormente en caché. Los valores válidos son: protocolo El comportamiento de la caché está determinado por las cabeceras Cache-Control de la respuesta, conforme a RFC 7234. Para optimizar el rendimiento, si la pasarela recibe más de una solicitud de un recurso que no está en caché pero que podría guardarse en caché cuando al recibirse la respuesta del URL de destino recibe, la pasarela solo envía una solicitud al URL de destino; el resto de peticiones no se procesan mientras no se recibe la respuesta de la primera solicitud y se determina el comportamiento de la caché a partir de dicha respuesta. Si la respuesta indica que guardar en caché es posible, la pasarela responderá con el recurso guardado caché a todas las solicitudes en espera. Si la respuesta indica que la no es posible guardar en caché, la pasarela envía todas las solicitudes en espera al URL de destino. Utilice esta opción solo si espera que las respuestas del URL de destino se pueden guardar en caché, en cuyo caso se debería mejorar el rendimiento y limitar la demanda del URL de destino. Sin embargo, si el URL de destino nunca indica que la pasarela tiene que guardar en caché su respuesta, el rendimiento podría verse penalizado respecto de la opción Sin caché. Sin memoria caché Las respuestas del URL de destino no están no se guardan en caché en la pasarela independientemente de las cabeceras de guardado en caché devueltas. En este caso, cada solicitud del cliente se envía al URL de destino. Utilice esta opción si no desea guardar en caché ninguna respuesta del backend en la pasarela, o si no es probable que una respuesta del URL de destino permita el guardado en caché mediante valores de la cabecera Cache-Control. tiempo de vida Esta opción es similar a la opción Protocolo, salvo que permite especificar la cantidad de tiempo que se desea que permanezca en caché una respuesta satisfactoria de la invocación o del proxy. Utilice esta opción solo si espera que las respuestas del URL de destino se pueden guardar en caché. El valor predeterminado es Protocolo.	serie
tiempo de vida	Nee	Especifica el tiempo en segundos que la respuesta permanece en la memoria caché. Sólo se aplica si la propiedad Tipo de memoria caché se establece en `Time to Live`. Entreun valor en el rango de 5 a 31708800. El valor predeterminado es `900`.	entero
Clave de memoria caché	Nee	Especifica el identificador exclusivo de la entrada de memoria caché de documento. Si se omite, se utiliza la serie URL completa como clave.	serie
Detener en caso de error	Nee	Seleccione los errores que, si se generan durante la ejecución de la política, hacen que se detenga el flujo de ensamblaje. Si hay un flujo `catch` configurado para el error, se desencadena para manejar el error generado. Si se emite un error y no hay errores seleccionados para el valor de Detener en caso de error o si el error emitido no es uno de los errores seleccionados, se permite que se complete la ejecución de la política y el flujo de ensamblaje continúa.	serie
Variable de objeto de respuesta	Nee	El nombre de una variable que se utilizará para almacenar los datos de respuesta de la solicitud. Se puede hacer referencia a esta variable en otras acciones, como por ejemplo 'Map'.	serie
Cabecera X-Forwarded	Nee	Esta cabecera la puede proporcionar Si `X-Forwarded-Host` existe, el proceso continúa. Si no existe antes de llamar a la política de proxy, se establece con el valor de la cabecera `Host`. Los 2 `X-Forwarded-For` cabecera siempre está establecida, en todos los casos. Esta cabecera mantiene rastros de navegación, mostrando una lista de IPs separada por comas, desde el cliente hasta cualquier proxy precedente. Si las tres cabeceras `X-Forwarded-Host` , `X-Forwarded-Port` , y `X-Forwarded-Proto` no están presentes a la hora de invocar la política de proxy, se establecen automáticamente. Para evitarlo, establezca la cabecera `X-Forwarded-Host` en algún valor antes de llamar a la política de proxy.	serie