Compartir vía

Cómo configurar un puerto de envío SOAP

  • Artículo

Los puertos de de envío SOAP pueden configurarse mediante programación, o bien utilizando la consola de administración de BizTalk Server.

Cómo configurar un puerto de envío SOAP mediante programación

El modelo de objetos de BizTalk Explorer expone una interfaz específica del adaptador para los puertos de envío denominados ITransportInfo que tiene la propiedad de lectura y escritura TransportTypeData . Esta propiedad acepta una bolsa de propiedades de puerto de envío SOAP en forma de par nombre-valor de cadenas XML. Tenga en cuenta que para establecer esta propiedad en el modelo de objetos del Explorador de BizTalk debe establecer primero la propiedad OutboundTransportLocation de la interfaz ITransportInfo .

La propiedad TransportTypeData de la interfaz ITransportInfo no es necesaria. Si no se define, el adaptador utiliza los valores predeterminados de configuración del puerto de envío SOAP, tal como se indica en la tabla siguiente.

En la tabla siguiente se enumeran las propiedades de configuración que pueden definirse en el modelo de objetos del Explorador de BizTalk para los puertos de envío de SOAP.

Nombre de propiedad Tipo Descripción
URI String Directorio virtual que contiene el servicio Web en el servidor de implementación.
Nombre de usuario String Nombre de usuario que se especifica para tener acceso al servicio Web de destino.

Valor predeterminado: en blanco
Contraseña String Contraseña de usuario que se va a usar para la autenticación con el servidor.

Valor predeterminado: en blanco
ClientCertificate String Huella digital del certificado SSL de cliente.

Valor predeterminado: en blanco
AffiliateApplicationName String Nombre de la aplicación de SSO que se utilizará para canjear el vale de credenciales de cliente.

AffiliateApplicationName es mutuamente excluyente de un par nombre de usuario y contraseña.

Valor predeterminado: en blanco
UseProxy Boolean Indica si el puerto de envío de SOAP utiliza un servidor proxy para tener acceso al servicio Web de destino. Todos los puertos de envío SOAP pueden compartir el servidor proxy.

Valor predeterminado: False
ProxyAddress String Dirección de proxy HTTP que se utilizará para llamar al servicio Web.

Valor predeterminado: en blanco
ProxyPort Entero Puerto del proxy HTTP que se utilizará para llamar al servicio Web.

Valor predeterminado: en blanco
ProxyUsername String Nombre de usuario que se va a utilizar para el proxy.

Valor predeterminado: en blanco
ProxyPassword String Contraseña que se va a utilizar para el proxy.

Valor predeterminado: en blanco

El código siguiente muestra el formato que debe utilizarse para definir estas propiedades:

<CustomProps>  
   <URI vt="8"/>  
   <ClientCertificate vt="8"/>  
   <Password vt="8">Encrypted</Password>  
   <ProxyAddress vt="8"/>  
   <ProxyPassword vt="8">Encrypted</ProxyPassword>  
   <ProxyPort vt="3"/>  
   <ProxyUsername vt="8"/>  
   <UseProxy vt="11"/>  
   <Username vt="8"/>  
   <AffiliateApplicationName vt="8"/>  
</CustomProps>

Cómo configurar un puerto de envío SOAP con la consola de administración de BizTalk Server.

Puede definir variables del adaptador de puerto de envío SOAP 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.

Para configurar variables para un puerto de envío SOAP

  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. Para obtener más información, vea Cómo crear un puerto de envío. Configure todas las opciones de puerto de envío y especifique SOAP 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 situada junto a Tipo, haga clic en Configurar.

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

    Use Para hacer esto
    Dirección URL del servicio web Especificar la dirección del servicio Web al que desea llamar. Nota: El URI de un puerto de envío o una ubicación de recepción no puede superar los 256 caracteres.
    Autenticación Indicar el método de autenticación que utiliza el servicio Web al que está llamando.

    Opciones:

    - Anónimo. Configuración predeterminada.
    - Básica. La conexión SOAP envía el nombre de usuario y la contraseña en texto sin formato.
    - Digerir. La conexión SOAP envía la contraseña en un formato cifrado.
    - NTLM. Ni el nombre de usuario ni la contraseña se envían a través de una conexión SOAP. El adaptador de SOAP utiliza siempre las credenciales del proceso en el que se ejecuta el adaptador de envío SOAP para este tipo de autenticación.
    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.

    Opciones:

    - 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 NTLM, 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 NTLM, 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. Para obtener información sobre cómo rellenar esta lista, consulte Aplicaciones afiliadas de SSO.
    Longitud mínima: 0
    Longitud máxima: 256
    Huella digital del certificado de cliente Especificar la huella digital de certificado de cliente que se utilizará para establecer una conexión.

    Ejemplo: 01 23 45 67 89 AB CD EF 01 23 45 67 89 AB CD EF 01 23 45 67

    Longitud mínima: 0

    Longitud máxima: 59

  4. En el cuadro de diálogo Propiedades de transporte SOAP , en la pestaña Proxy , haga lo siguiente:

    Use Para hacer esto
    Uso de la configuración de proxy predeterminada del controlador Especificar la configuración de controlador del servidor proxy del puerto de envío. Cuando se establece como true, el puerto 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.

    El valor de configuración predeterminado es true.
    No utilizar proxy Indicar si el controlador de envío de SOAP utiliza un servidor proxy.
    Utilizar proxy Indicar si el controlador de envío de SOAP utiliza un servidor proxy. Todos los puertos de envío SOAP pueden compartir el servidor proxy.
    Servidor Especifica el nombre del servidor proxy.

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

    Escriba: String

    Longitud mínima: 0

    Longitud máxima: 256
    Puerto Especificar el puerto que utiliza el controlador de envío de SOAP.

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

    Valor predeterminado: 80

    Tipo: long

    Valor mínimo: 0

    Valor máximo: 65535 Nota: Especificar un valor de 0 indica que se debe usar el valor predeterminado, que es el puerto 80.
    Nombre de usuario Especificar el nombre de usuario que se utilizará para la autenticación. Si usa la autenticación integrada de Windows, el nombre de usuario incluye el dominio, domain\username. Si usa la autenticación básica o implícita, el nombre de usuario no incluye domain\.

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

    Escriba: String

    Longitud mínima: 0

    Longitud máxima: 256
    Contraseña Especificar la contraseña que se utilizará para la autenticación.

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

    Escriba: String

    Longitud mínima: 0

    Longitud máxima: 256

  5. En el cuadro de diálogo Propiedades de transporte SOAP , en la pestaña Servicio web , haga lo siguiente:

    Use Para hacer esto
    Puerto Web de orquestación Especifique para usar el servicio web que se expone en la dirección URL del servicio web que aparece en la pestaña General .

    Esta es la configuración predeterminada.
    Nombre del ensamblado Especificar el nombre del ensamblado que contiene el proxy de servicio Web. Este campo se puede rellenar haciendo clic en el botón Examinar para buscar un ensamblado. Después de seleccionar el ensamblado, este cuadro se rellena con el nombre completo del mismo. Nota: El ensamblado especificado debe estar presente en todos los servidores de BizTalk Server en tiempo de ejecución.
    Nombre de tipo Especificar el nombre de la clase que contiene el método Web que se va a invocar. Este nombre puede seleccionarse de una lista de tipos incluida en el ensamblado.
    Nombre del método Especificar uno de los métodos del cuadro de lista o seleccionar la opción a "Especificar más tarde". Si se selecciona la opción "Especificar más tarde", el método Web deberá definirse por cualquier otro medio como, por ejemplo, un componente de canalización. En este escenario, el método web debe escribirse en la propiedad de contexto MethodName del adaptador soap.
    SOAP 1.2 Especificar que se genere código de proxy que proporcione compatibilidad con el protocolo SOAP 1.2. Si no habilita esta opción, se generará el código de proxy para compatibilidad con SOAP 1.1.

    Valor predeterminado: borrado

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

Consulte también

Publicación de servicios web