Compartir a través de

Cómo configurar un puerto de envío HTTP

  • Artículo

Un puerto de envío HTTP se puede configurar mediante programación o mediante la consola de administración de BizTalk Server.

Configuración de un puerto de envío HTTP mediante programación

El adaptador de HTTP almacena la información de configuración en la base de datos de administración de BizTalk (también conocida como la base de datos de configuración). La información de configuración se almacena en una bolsa de propiedades XML personalizada. Durante la inicialización del adaptador de HTTP y durante su tiempo de ejecución, el servidor pasa la configuración al adaptador del modo siguiente:

  • Para el controlador de envío HTTP, la información de configuración pasa al adaptador llamando al método Load de la interfaz IPersistPropertyBag .

  • Para los puertos de envío HTTP, la información de configuración se pasa al adaptador como un conjunto de propiedades en un contexto de mensaje. El espacio de nombres HTTP agrupa estas propiedades.

    El modelo de objetos del Explorador de BizTalk expone la ItransportInfo interfaz de configuración del adaptador para los puertos de envío, que contiene la TransportTypeData propiedad de lectura y escritura. Esta propiedad acepta la bolsa de propiedades de configuración del puerto de envío HTTP como una cadena XML de par nombre/valor. Tenga en cuenta que para establecer esta propiedad en el modelo de objetos del Explorador de BizTalk, primero debe establecerse en la Address propiedad de la interfaz ITransportInfo .

    No es necesario establecer la propiedad TransportTypeData de la interfaz ITransportInfo . Si no se establece, el adaptador de HTTP utilizará los valores predeterminados del controlador de envío HTTP.

    Si no se definen las propiedades de configuración del puerto de envío que duplican la configuración del controlador, se utilizan las propiedades de configuración del controlador. Si el controlador de envío HTTP no tiene valores de configuración, el adaptador de envío HTTP registra un error en el registro de sucesos y mueve el mensaje al adaptador de copia de seguridad.

    Puede establecer propiedades de configuración mediante programación en un contexto de mensaje. Estas propiedades se pueden establecer en una programación de orquestación de BizTalk Server o en componentes de canalización personalizados. Las reglas siguientes se aplican cuando se utilizan estas propiedades:

  • Si la propiedad de configuración se establece en una orquestación o en un componente de canalización personalizado en una canalización de recepción, haga lo siguiente:

    • Si se envía un mensaje a un puerto de envío estático, el valor de la propiedad se sobrescribirá con el valor configurado para dicho puerto de envío.

    • Si el mensaje se envía a un puerto de envío dinámico, el valor de la propiedad no se sobrescribirá.

  • Si la propiedad de configuración se establece en un componente de canalización personalizado de una canalización de envío, entonces:

    • El valor no se sobrescribirá independientemente de que el mensaje se envíe a un puerto de envío estático o dinámico.

    En la siguiente tabla se enumeran las propiedades de configuración que se pueden establecer en el modelo de objetos del Explorador de BizTalk para la ubicación de envío HTTP.

Nombre de propiedad Tipo Descripción Restricciones Comentarios
RequestTimeout xs:int Período de tiempo de espera de una respuesta del servidor. Si se establece como cero (0), el sistema calcula el tiempo de espera en función del tamaño del mensaje de solicitud. Valor mínimo: 0

Valor máximo: MAX_LONG		 Valor predeterminado: 0
ContentType xs:string Tipo de contenido de los mensajes de solicitud. Longitud mínima: 0

Longitud máxima: 256		 Valor predeterminado: Texto/XML
MaxRedirects xs:int Número máximo de veces que el adaptador HTTP puede redirigir la solicitud. Valor mínimo: 0

Valor máximo: 10		 Valor predeterminado: 5
UseHandlerProxySettings xs:boolean Especifica si el puerto de envío HTTP utilizará la configuración del servidor proxy para el controlador de envío. None Valor predeterminado: Verdad

Cuando se establece como true, el puerto de envío utilizará la configuración del proxy en el nivel del controlador. Cuando se establece como false, el adaptador de envío utilizará la información del proxy especificado en el puerto de envío.
UseProxy xs:boolean Especifica si el adaptador de HTTP utilizará el servidor proxy. Todos los puertos de envío HTTP pueden compartir el servidor proxy. None Valor predeterminado: Falso

Esta propiedad se omite si UseHandlerProxySettings es True.
ProxyName xs:string Especifica el nombre del servidor proxy. Longitud mínima: 0

Longitud máxima: 256		 Valor predeterminado: Vacío

El adaptador de envío HTTP omite esta propiedad si la propiedad UseHandlerProxySettings está establecida en True. De lo contrario, el adaptador de envío HTTP usa esta propiedad solo si UseProxy es True. Esta propiedad es necesaria si UseProxy es True.
ProxyPort xs:int Especifica el puerto del servidor proxy. Valor mínimo: 0

Valor máximo: 65535		 Valor predeterminado: 80

El adaptador de envío HTTP omite esta propiedad si UseHandlerProxySettings es True. De lo contrario, el adaptador de envío HTTP usa esta propiedad solo si UseProxy es True. Esta propiedad es necesaria si UseProxy es True.
ProxyUsername xs:string Especifica el nombre de usuario para la autenticación con el servidor proxy. Longitud mínima: 0

Longitud máxima: 256		 Valor predeterminado: vacío

El adaptador de envío HTTP omite esta propiedad si UseHandlerProxySettings es True. De lo contrario, el adaptador de envío HTTP usa esta propiedad solo si UseProxy es True.
ProxyPassword xs:string Especifica la contraseña de usuario para la autenticación con el servidor proxy. Longitud mínima: 0

Longitud máxima: 256		 Valor predeterminado: vacío

El adaptador de envío HTTP omite esta propiedad si UseHandlerProxySettings es True. De lo contrario, el adaptador de envío HTTP usa esta propiedad solo si UseProxy es True.
AuthenticationScheme xs:string Tipo de autenticación que se utiliza con el servidor de destino. None Valores válidos:

- Anónimo (valor predeterminado)
- Básica
- Digerir
- Kerberos
Nombre de usuario xs:string Nombre de usuario que se utiliza para la autenticación con el servidor. Longitud mínima: 0

Longitud máxima: 256		 Valor predeterminado: Vacío

Este valor es necesario si selecciona Autenticación básica o implícita . El adaptador HTTP omite el valor de esta propiedad si UseSSO es True.
Contraseña xs:string Contraseña de usuario que se va a usar para la autenticación con el servidor. Longitud mínima: 0

Longitud máxima: 256		 Valor predeterminado: vacío

Este valor es necesario si selecciona Autenticación básica o implícita . El valor de esta propiedad se omite si UseSSO es True.
EnableChunkedEncoding xs:boolean Especifica si el adaptador de HTTP utiliza codificación fragmentada. None Valor predeterminado:

True
Certificate xs:string Huella digital del certificado de cliente SSL. Longitud mínima: 0

Longitud máxima: 59		 Valor predeterminado: Vacío
UseSSO xs:boolean Especifica si SSO se utilizará para el puerto de envío. None Valor predeterminado: Falso
AffiliateApplicationName xs:string Nombre de la aplicación afiliada que se va a usar para el inicio de sesión único. Longitud mínima: 0

Longitud máxima: 256		 Valor predeterminado: vacío

Obligatorio si UseSSO es True.

En el siguiente código se muestra la cadena XML que se utilizará para establecer estas propiedades:

<CustomProps>  
   <ContentType vt="8">text/xml</ContentType>  
   <RequestTimeout vt="3">0</RequestTimeout>  
   <MaxRedirects vt="3">5</MaxRedirects>  
   <UseHandlerProxySettings vt="8">-1</UseHandlerProxySettings>  
   <UseProxy vt="8">-1</UseProxy>  
   <ProxyName vt="8">sdfsd</ProxyName>  
   <ProxyPort vt="3">80</ProxyPort>  
   <ProxyUsername vt="8">Somename</ProxyUsername>  
   <ProxyPassword vt="8">Somepassword</ProxyPassword>  
   <AuthenticationScheme vt="8">Basic</AuthenticationScheme>  
   <Username vt="8">Somename</Username>  
   <Password vt="8">Somepassword</Password>  
   <EnableChunkedEncoding vt="11">1</EnableChunkedEncoding>  
   <Certificate vt="8">AAAA BBBB CCCC DDDD</Certificate>  
   <UseSSO vt="11">0</UseSSO>  
   <AffiliateApplicationName vt="8">Name</AffiliateApplicationName>  
</CustomProps>

Configuración de un puerto de envío HTTP con la consola de administración de BizTalk Server

Se pueden establecer variables del adaptador de puerto de envío HTTP en la consola de administración de BizTalk Server. Si no se establecen las propiedades para el puerto de envío, se utilizan los valores predeterminados del controlador de envío establecidos en la consola de administración de BizTalk Server.

Nota

Las propiedades de configuración que se describen en este tema son comunes a los puertos de envío HTTP unidireccionales y de solicitud-respuesta.

  1. En la consola de administración de BizTalk Server, cree un nuevo puerto de envío o haga doble clic en un puerto de envío existente para modificarlo. Consulte How to Create a Send Port (Cómo crear un puerto de envío ) para obtener más información. Configure todas las opciones de puerto de envío y especifique HTTP para la opción Tipo en la sección Transporte de la pestaña General .

  2. En la pestaña General , en la sección Transporte , haga clic en el botón Configurar situado junto a Tipo.

  3. En el cuadro de diálogo Propiedades de transporte HTTP , en la pestaña General , haga lo siguiente:

    Use Para hacer esto
    Dirección URL de destino Necesario. Especificar la dirección a la que enviar solicitudes HTTP. Incluir cadenas de consulta anexadas a la dirección URL base.

    Tipo: Cadena

    Longitud máxima: 256

    Para obtener más información, vea Restricciones en la propiedad de dirección URL de destino. Nota: El URI de un puerto de envío o una ubicación de recepción no puede superar los 256 caracteres.
    Habilitar codificación fragmentada Especificar el uso de la codificación fragmentada. Si se habilita esta opción, el adaptador de HTTP utilizará la codificación fragmentada HTTP con un tamaño máximo de fragmento de 8 KB. La codificación fragmentada está deshabilitada implícitamente si el controlador de envío HTTP está configurado para Usar proxy.

    Tipo: Booleana

    Valor predeterminado: Verdad
    Tiempo de espera de petición (seg.) Especificar el tiempo de espera en segundos para la transmisión HTTP/HTTPS. Si el adaptador de HTTP no recibe respuesta en este tiempo, el servicio registra el error y vuelve a enviar el mensaje según lo establecido en la infraestructura de reintentos.

    Si se establece como cero (0), el motor de mensajería de BizTalk calcula el tiempo de espera en función del tamaño del mensaje de solicitud. Si no proporciona ningún valor, se usa el valor del controlador.

    Tipo: Largo

    Valor mínimo: 0

    Valor máximo: MAX_LONG
    Redirecciones máximas Especificar el número máximo de redirecciones permitidas para el mensaje que se está enviando.

    Valor predeterminado: 5

    Tipo: Int

    Valor mínimo: 0

    Valor máximo: 10
    Tipo de contenido Especificar el tipo de contenido de los mensajes de solicitud.

    Si no se proporciona ningún valor, se utiliza el valor del controlador.

    Tipo: Cadena

    Longitud mínima: 0

    Longitud máxima: 256

  4. En el cuadro de diálogo Propiedades de transporte HTTP , en la pestaña Proxy (invalidación del controlador), haga lo siguiente:

    Use Para hacer esto
    Uso de la configuración de proxy predeterminada del controlador Especifique que la configuración del puerto de envío debe usar la configuración de proxy especificada para el controlador de envío HTTP.

    Esta es la configuración predeterminada.
    No utilizar proxy Especificar si el controlador de envío HTTP utiliza el servidor proxy.

    Si se selecciona, el controlador de envío HTTP para este puerto de envío no utiliza el servidor proxy.
    Utilizar proxy Especificar si el controlador de envío HTTP utiliza el servidor proxy.

    Si se selecciona, el controlador de envío HTTP utiliza el servidor proxy.
    Servidor Especificar la dirección del servidor proxy para este puerto de envío.

    Esta propiedad solo requiere un valor si se selecciona Usar proxy .

    Tipo: Cadena

    Longitud mínima: 0

    Longitud máxima: 256
    Puerto Especificar el puerto del servidor proxy para este puerto de envío.

    Esta propiedad solo requiere un valor si se selecciona Usar proxy .

    Valor predeterminado: 80

    Tipo: Largo

    Valor mínimo: 0

    Valor máximo: 65535
    Nombre de usuario Especificar el nombre de usuario para la autenticación con el servidor proxy.

    Esta propiedad solo requiere un valor si se selecciona Usar proxy .

    Tipo: Cadena

    Longitud mínima: 0

    Longitud máxima: 256
    Contraseña Especificar la contraseña de usuario para la autenticación con el servidor proxy.

    Esta propiedad solo requiere un valor si se selecciona Usar proxy .

    Tipo: Cadena

    Longitud mínima: 0

    Longitud máxima: 256

  5. En el cuadro de diálogo Propiedades de transporte HTTP , en la pestaña Autenticación , haga lo siguiente:

    Use Para hacer esto
    Tipo de autenticación Especificar el tipo de autenticación que se utilizará con el servidor de destino.

    Las opciones válidas son:

    - Anónimo
    - Básica
    - Digerir
    - Kerberos

    Valor predeterminado: Anónimo
    Credenciales Especificar el tipo de credenciales que se va a utilizar.

    Solo está disponible si el tipo de autenticación es Básico o Implícita.

    Las opciones válidas son:

    - No usar el inicio de sesión único
    Nombre de usuario:
    Nombre de usuario que se utilizará para la autenticación con el servidor de destino. Si la propiedad Tipo de autenticación es Anónima o Kerberos, esta opción está deshabilitada. Esta propiedad requiere un valor si se selecciona Basic o Digest y enterprise Single Sign-On no se usa.
    Longitud mínima: 0
    Longitud máxima: 256
    Contraseña:
    Contraseña que se utilizará para la autenticación con el servidor de destino. Si la propiedad Tipo de autenticación es Anónima o Kerberos, esta opción está deshabilitada. Esta propiedad requiere un valor si se selecciona Basic o Digest y no se usa single Sign-On.
    Longitud mínima: 0
    Longitud máxima: 256
    - Uso del inicio de sesión único
    Especificar si se utiliza el inicio de sesión único (SSO) para recuperar credenciales de cliente para la autenticación con el servidor de destino.
    Affiliate Application
    Especifica la aplicación afiliada que se va a usar para el inicio de sesión único.
    Seleccionar las aplicaciones que desea incluir en el inicio de sesión único (SSO).
    Longitud mínima: 0
    Longitud máxima: 256
    Huella digital de certificado de cliente SSL Especificar la huella digital del certificado de cliente que se utilizará para establecer una conexión de Capa de sockets seguros (SSL).

    Longitud mínima: 0

    Longitud máxima: 59

  6. Haga clic en Aceptar y en Aceptar de nuevo para guardar la configuración.

Consulte también

Configuración de un puerto de envío HTTP