Adaptador de recepción de HTTP

Artículo
05/04/2023

La ubicación de recepción del adaptador de recepción HTTP es una dirección URL distinta configurada a través de la consola de administración de BizTalk Server.

Puede configurar el adaptador de recepción HTTP para el envío asincrónico o sincrónico desde el cliente. Los envíos asincrónicos unidireccionales, mientras que los envíos sincrónicos son bidireccionales o envíos de solicitud-respuesta.

Utilice la seguridad de IIS para la autenticación y autorización de solicitudes entrantes.

Solicitudes HTTP GET y HTTP POST

El adaptador de recepción HTTP puede recibir mensajes de dos maneras diferentes, mediante una solicitud HTTP POST o una solicitud HTTP GET.

Cuando un adaptador de recepción HTTP obtiene mensajes con una solicitud HTTP POST, se produce esta secuencia de sucesos:

La dirección URL configurada en BizTalk Server recibe un mensaje nuevo en la ubicación de recepción.
El adaptador de recepción crea un objeto de mensaje de BizTalk para poder enviar el mensaje al servidor.
El adaptador de recepción crea el objeto Message de BizTalk con una sola parte, la parte del cuerpo.
Una vez que se ha leído el mensaje y se ha enviado correctamente al servidor, el adaptador de recepción HTTP envía un código HTTP 202 al cliente para indicar que se aceptó la solicitud.

Opcionalmente, el adaptador de recepción HTTP puede enviar un token de correlación de mensaje en la respuesta HTTP. Este token de correlación representa el mensaje en BizTalk Server. Si la ubicación de recepción HTTP se encuentra en un puerto de solicitud-respuesta, el adaptador devuelve el código de recepción correcta 200 junto con el mensaje de respuesta.

Cuando un adaptador de recepción HTTP procesa mensajes de una solicitud HTTP GET, el adaptador de recepción crea un objeto de mensaje de BizTalk y pone la cadena de consulta descodificada de la solicitud HTTP GET en la parte del cuerpo del mensaje de BizTalk. El adaptador de HTTP selecciona la cadena de consulta que se pone en la parte del cuerpo del mensaje de BizTalk con el siguiente algoritmo:

Si el adaptador de recepción HTTP recibe una solicitud HTTP GET, divide la cadena de URI entrante en dos partes, utilizando el signo de interrogación (?) como delimitador.
La primera parte de la cadena de URI, la parte anterior al delimitador de signo de interrogación, se copia en la propiedad InboundTransportLocation en el contexto del mensaje. La propiedad InboundTransportLocation identifica de forma única la ubicación donde BizTalk Server recibió el mensaje. El motor utiliza esta propiedad para determinar la ubicación de recepción que se debe ejecutar para el mensaje.
El adaptador de HTTP toma el resto de la cadena de URI (después del signo de interrogación) y la descodifica y copia en la parte del cuerpo del mensaje de BizTalk.
Si el adaptador de recepción HTTP recibe una operación HTTP GET o HTTP POST vacía, se rechaza.

Cómo procesa el adaptador de recepción HTTP una solicitud GET

A continuación se muestran algunos ejemplos de cómo procesa el adaptador de recepción HTTP los mensajes recibidos con solicitudes HTTP GET. Estos mensajes asumen que el adaptador de recepción HTTP está configurado con las siguientes ubicaciones de recepción:

/vroot/BTSHTTPReceive.dll  
/vroot/BTSHTTPReceive.dll?LocationID=1

Dada la siguiente solicitud HTTP GET para el cliente:
```
http://servername/vroot/BTSHTTPReceive.dll?LocationID=1  
```
El adaptador de recepción HTTP actúa del siguiente modo:

Establezca la propiedad InboundTransportLocation en el contexto del mensaje igual a /vroot/BTSHTTPReceive.dll y la parte del cuerpo del objeto Message de BizTalk igual a LocationID=1.
Dada la siguiente solicitud HTTP GET para el cliente:
```
http://servername/vroot/BTSHTTPReceive.dll?LocationID=1&MyParam=My%20Value  
```
El adaptador de recepción HTTP actúa del siguiente modo:

Establezca la propiedad InboundTransportLocation igual a /vroot/BTSHTTPReceive.dll y la parte del cuerpo del objeto Message de BizTalk igual a LocationID=1&MyParam=My Value.
Dada la siguiente solicitud HTTP GET para el cliente:
```
http://servername/vroot/BTSHTTPReceive.dll  
```
La acción realizada por el adaptador de recepción HTTP es+ de la siguiente manera:

Rechace la solicitud debido al formato incorrecto de la solicitud HTTP GET.

Compatibilidad del adaptador de recepción HTTP con el procesamiento por lotes

El adaptador de recepción HTTP envía mensajes al servidor en lotes. El tamaño del lote utilizado para enviar mensajes al servidor se puede configurar en el controlador de recepción del adaptador de HTTP.

Capacidad del adaptador de recepción HTTP para suspender solicitudes con errores

El adaptador de recepción HTTP BizTalk Server tiene una configuración, Suspend Failed Requests, para controlar lo que sucede con una solicitud HTTP si se produce un error de procesamiento entrante debido a un error de canalización de recepción, un error de asignación o un error de enrutamiento. Esta opción de configuración tiene dos valores posibles:

Falso. Esta es la configuración predeterminada. El adaptador de recepción HTTP descarta los mensajes que dan error en el procesamiento de entrada debido a un error de canalización de recepción, un error de asignación o un error de enrutamiento. Además, se envía un código de estado de error 401 o 500 al cliente.
Verdadero. El adaptador de recepción HTTP suspende los mensajes que dan error en el procesamiento de entrada debido a un error de canalización de recepción, un error de asignación o un error de enrutamiento. Para los puertos de recepción unidireccionales, se envía un código de estado aceptado 202 al cliente. En el caso de los puertos de recepción bidireccionales, se envía un código de estado de error 500 al cliente.

Compatibilidad del adaptador de recepción HTTP con la codificación fragmentada

El adaptador de recepción HTTP acepta solicitudes HTTP con mensajes que tienen el cuerpo con codificación fragmentada. El adaptador de recepción utiliza la codificación fragmentada para enviar mensajes de respuesta cuando el tamaño del cuerpo es superior a 4 KB. La codificación fragmentada se puede desactivar estableciendo la entrada del Registro DWORD descrita en Parámetros de ajuste y configuración del adaptador HTTP.

Certificados de cliente para el adaptador de recepción HTTP

Siempre que se utiliza una conexión segura con un certificado de cliente para la ubicación de recepción HTTP, el adaptador de recepción HTTP obtiene la huella digital del certificado de cliente de Microsoft Internet Information Services (IIS) y la agrega al contexto de todos los mensajes que se recibieron mediante HTTPS en esa ubicación. El adaptador de recepción HTTP establece las siguientes propiedades del sistema:

SourcePartyEvidenceQualifier = "Certificate"  
SourcePartyEvidence = <certificate thumbprint>

Códigos de estado devueltos por el adaptador de recepción HTTP

La lista siguiente contiene los códigos de estado devueltos por el adaptador de recepción HTTP.

200 Correcto. El adaptador procesó correctamente el mensaje de solicitud y generó una respuesta. El adaptador devuelve este código de estado en la respuesta HTTP del puerto de solicitud-respuesta HTTP.
202 Message Accepted. El adaptador envió correctamente el mensaje al servidor o una solicitud unidireccional está suspendida. El adaptador devuelve este código de estado en la respuesta HTTP del puerto de recepción HTTP unidireccional.
401 Access Denied. La solicitud HTTP se recibe en un puerto de recepción que requiere autenticación y la comprobación de seguridad de ese mensaje da error. Por ejemplo, no se resolvió la entidad o no se descifró el mensaje.
500 Internal Server Error. Error general al procesar la solicitud HTTP. El mensaje no se suspende por BizTalk Server a menos que el valor de configuración Suspender solicitudes con error esté establecido en True para un puerto de recepción bidireccional.

Consulte también

Adaptador de HTTP

Compartir a través de