Compartir a través de

Adaptador de WCF-BasicHttp

  • Artículo

Microsoft BizTalk Server usa el adaptador de WCF-BasicHttp para recibir y enviar solicitudes de servicio WCF a través de la clase BasicHttpBinding. El adaptador de WCF-BasicHttp permite publicar orquestaciones y esquemas como servicios WCF y consumir servicios WCF externos con BasicHttpBinding.

Puede usar el adaptador de WCF-BasicHttp para realizar una comunicación entre equipos con servicios Web basados en ASMX antiguos y con clientes compatibles con el Perfil básico de servicios Web WS-I, versión 1.1, mediante el transporte HTTP o HTTPS con codificación de texto. No obstante, no podrá utilizar las características compatibles con los protocolos WS-*.

En la tabla siguiente se resumen las características del adaptador de WCF-BasicHttp:

Descripción Característica
Nivel de interoperabilidad Perfil básico
Codificación de mensaje Texto o MTOM
Límite Entre equipos
Protocolo de transporte HTTP o HTTPS
Modo de seguridad Ninguno, Mensaje, Transporte, TransportWithMessageCredential y TransportCredentialOnly
Mecanismo de autenticación de cliente Seguridad de transporte y seguridad de mensaje
Compatibilidad con WS-ReliableMessaging No
Compatibilidad con WS-AtomicTransaction No
Compatibilidad con mensajería unidireccional Sí
Compatibilidad con mensajería bidireccional Sí
Tipo de host para adaptador de recepción Aislado
Tipo de host para adaptador de envío En proceso

El adaptador de WCF-BasicHttp consta de dos adaptadores: un adaptador de recepción y un adaptador de envío.

En este tema se muestra cómo crear la ubicación de recepción y el puerto de envío mediante la administración de BizTalk. También puede crear la ubicación de recepción y el puerto de envío mediante programación.

Antes de empezar

  • A partir de BizTalk Server 2016, este adaptador de envío puede usar Access Control Service (ACS) o la firma de acceso compartido (SAS) para athenticar con Service Bus. Se recomienda usar la firma de acceso compartido (SAS) al autenticarse con Service Bus.

    Al crear un espacio de nombres de Service Bus, el espacio de nombres de Access Control (ACS) no se crea automáticamente. Si usa ACS para autenticarse, es posible que tenga que crear un nuevo espacio de nombres de ACS. Consulte SB-Messaging adapter (Adaptador de SB-Messaging ) para obtener información más detallada, incluidos los pasos para recuperar los valores de clave de ACS.

  • El adaptador de WCF-BasicHttp se prefiere sobre el adaptador SOAP en los escenarios siguientes:

    • La velocidad de documentos por segundo de los adaptadores WCF suele ser mejor que el adaptador SOAP.
    • El adaptador SOAP tiene la desventaja de serializar y deserializar mensajes entre tipos .NET y datos XML sin procesar; lo que en algunos casos podría dar lugar a modificaciones de datos no deseadas. Los adaptadores de WCF adoptan el enfoque de conservación de la secuencia de datos.
    • Los adaptadores de WCF publican lo que es básicamente el mismo esquema que se usará en el tiempo de ejecución de BizTalk. Por el contrario, el adaptador de SOAP devuelve los metadatos generados mediante el reflejo de las clases .NET generadas para representar los esquemas. Dado que .NET no conserva todos los matices de los esquemas XSD, puede que el WSDL expuesto no refleje de forma precisa los esquemas usados por el tiempo de ejecución de BizTalk.
    • Es más fácil migrar de WCF-BasicHttp a WCF-WSHttp, si es necesario.

  • Utilice el adaptador de recepción WCF-BasicHttp para recibir solicitudes de Servicio WCF a través del protocolo HTTP o HTTPS. Utilice el adaptador de envío WCF-BasicHttp para llamar a un Servicio WCF a través del contrato sin tipo mediante el protocolo HTTP o HTTPS.

Creación de la ubicación de recepción

Esta ubicación de recepción se puede configurar como unidireccional o solicitud-respuesta (bidireccional).

Nota

Antes de completar los pasos siguientes, debe haber agregado ya un puerto de recepción. Consulte Cómo crear un puerto de recepción.

También puede crear la ubicación de recepción mediante programación.

  1. En la consola de administración de BizTalk, expanda administración de BizTalk Server, grupo de BizTalk, aplicaciones y, a continuación, expanda la aplicación en la que desea crear una ubicación de recepción.

  2. En la consola de administración de BizTalk, en el panel izquierdo, haga clic en el nodo Puerto de recepción . A continuación, en el panel de la derecha, haga clic con el botón secundario en el puerto de recepción asociado con una ubicación de recepción existente o que desee asociar con una nueva ubicación de recepción. A continuación, haga clic en Propiedades.

  3. En el cuadro de diálogo Propiedades de puerto de recepción , en el panel de la izquierda, seleccione Ubicaciones de recepcióny, a continuación, en el panel de la derecha, haga doble clic en una ubicación de recepción existente o haga clic en Nuevo para crear una nueva ubicación de recepción.

  4. En el cuadro de diálogo Propiedades de ubicación de recepción, en la sección Transporte junto a Tipo, seleccione WCF-BasicHttp en la lista desplegable y, a continuación, haga clic en Configurar.

  5. En Propiedades de transporte WCF-BasicHttp, en la pestaña General , configure la dirección del punto de conexión y la identidad de servicio para la ubicación de recepción del WCF-BasicHttp:

    Nota

    Si usa Transport o TransportWithMessageCredential para el modo de seguridad, debe configurar capa de sockets seguros (SSL) en Microsoft Internet Information Services (IIS).

    Use Para hacer esto
    Dirección (URI) Necesario. Especificar el URI de esta ubicación de recepción. Especifique el directorio virtual más el nombre de archivo .svc que genera el Asistente para publicación del servicio WCF de BizTalk; por ejemplo, /path/service.svc.

    Valor predeterminado: /

    Longitud mínima: 1

    Longitud máxima: 255
    Identidad de extremo Opcional. Especifique la identidad del servicio que proporciona esta ubicación de recepción haciendo clic en el botón Editar . Los valores que se pueden especificar para la propiedad Endpoint Identity difieren según la configuración de seguridad. Esta configuración hace posible que el cliente autentique la ubicación de recepción. En el proceso de negociación entre el cliente y el servicio, la infraestructura de Windows Communication Foundation (WCF) asegurará que la identidad del servicio esperado coincide con los valores de este elemento.

    El valor predeterminado es una cadena vacía.

    Longitud mínima: 0

    Longitud máxima: 32767

  6. En el cuadro de diálogo Propiedades de transporte WCF-BasicHttp , en la pestaña Enlace , configure las propiedades de tiempo de espera y codificación:

    Use Para hacer esto
    Tiempo de espera de apertura (hh:mm:ss) Especificar un valor de marco temporal que indica el intervalo de tiempo proporcionado para que se complete una operación de apertura del canal. Este valor debe ser mayor o igual que System.TimeSpan.Zero.

    Valor predeterminado: 00:01:00

    Valor máximo: 23:59:59
    Tiempo de espera de envío (hh:mm:ss) Especificar un valor de marco temporal que indica el intervalo de tiempo proporcionado para que se complete una operación de envío. Este valor debe ser mayor o igual que System.TimeSpan.Zero. Si usa un puerto de recepción solicitud-respuesta, este valor especifica un marco temporal para que se complete la interacción, incluso cuando el cliente devuelva un mensaje grande.

    Valor predeterminado: 00:01:00

    Valor máximo: 23:59:59
    Tiempo de espera de cierre (hh:mm:ss) Especificar un valor de marco temporal que indica el intervalo de tiempo proporcionado para que se complete una operación de cierre del canal. Este valor debe ser mayor o igual que System.TimeSpan.Zero.

    Valor predeterminado: 00:01:00

    Valor máximo: 23:59:59
    Tamaño máximo de mensaje recibido (bytes) Especificar el tamaño máximo, en bytes, para mensajes, con encabezados incluidos, que se pueden recibir a través de la red. El tamaño de los mensajes se limita mediante la cantidad de memoria asignada a cada mensaje. Puede usar esta propiedad para limitar la exposición a ataques por denegación de servicio (DoS).

    El adaptador de WCF-BasicHttp aprovecha la clase BasicHttpBinding en el modo de transferencia almacenada en búfer para comunicarse con un punto de conexión. Para el modo de transporte almacenado en búfer, la propiedad BasicHttpBinding.MaxBufferSize siempre es igual al valor de esta propiedad.

    Valor predeterminado: 65536

    Valor máximo: 2147483647
    Codificación de mensajes Especificar el codificador que se usa para codificar el mensaje SOAP. Los valores válidos incluyen los siguientes:

    - Texto: use un codificador de mensajes de texto.
    - Mtom: use un codificador de organización de transmisión de mensajes 1.0 (MTOM).

    El valor predeterminado es Text.
    Codificación de texto Especifique la codificación del juego de caracteres que se va a usar para emitir mensajes en el enlace cuando la propiedad de codificación Message esté establecida en Text. Los valores válidos incluyen los siguientes:

    - utf-16BE (unicodeFFFE):codificación Unicode BigEndian.
    - utf-16: codificación de 16 bits.
    - utf-8: codificación de 8 bits

    El valor predeterminado es utf-8.
    Número máximo de llamadas concurrentes Especificar el número de llamadas concurrentes en una instancia de servicio única. Las llamadas que superan el límite se ponen en cola. Establecer este valor en 0 equivale a establecerlo en Int32.MaxValue.

    El valor predeterminado es 200

  7. En el cuadro de diálogo Propiedades de transporte WCF-BasicHttp , en la pestaña Seguridad , defina las funcionalidades de seguridad:

    Use Para hacer esto
    Modo de seguridad Especificar el tipo de seguridad que se usa. Los valores válidos incluyen los siguientes:

    - Ninguno: los mensajes no se protegen durante la transferencia.
    - Transporte: la seguridad se proporciona mediante el transporte HTTPS. Los mensajes SOAP están protegidos mediante HTTPS. Para usar este modo, debe configurar Capa de sockets seguros (SSL) en los Servicios de Microsoft Internet Information Server (IIS).
    - Mensaje: La seguridad se proporciona mediante la seguridad del mensaje SOAP a través del transporte HTTP. De forma predeterminada, el cuerpo soap está cifrado y firmado. El único tipo de credencial de cliente de mensaje válido para el adaptador de WCF-Basic es Certificate. Este modo necesita el transporte HTTP. Al usar este modo de seguridad, es necesario proporcionar el certificado de servicio para esta ubicación de recepción a través de la propiedad Service certificate - Thumbprint .
    - TransportWithMessageCredential: el transporte HTTPS proporciona integridad, confidencialidad y autenticación del servicio. Para usar este modo, debe configurar Capa de sockets seguros (SSL) en los Servicios de Microsoft Internet Information Server (IIS).
    - TransportCredentialOnly: este modo no proporciona integridad y confidencialidad de los mensajes. Proporciona la autenticación del cliente basada en HTTP. Este modo se debe utilizar con precaución. Se debe usar en entornos donde la seguridad de transporte se proporcione por otros medios (por ejemplo, IPSec) y solo se proporcione la autenticación de cliente a través de la infraestructura de WCF. Si selecciona Certificado para la propiedad Tipo de credencial de cliente de transporte en este modo de seguridad, el certificado de servicio de esta ubicación de recepción debe proporcionarse a través de la propiedad Certificado de servicio - Huella digital .

    El valor predeterminado es None (Ninguno).
    Tipo de credenciales de cliente de transporte Especificar el tipo de credenciales que se va a usar a la hora de realizar la autenticación del cliente. Los valores válidos incluyen los siguientes:

    - Ninguno: no se produce ninguna autenticación en el nivel de transporte.
    - Básico: autenticación básica. En la autenticación básica, los nombres de usuario y las contraseñas se envían en texto sin formato por la red. Debe crear las cuentas de dominio o de usuario local correspondientes a las credenciales.
    - Resumen: autenticación implícita. Este método de autenticación funciona de forma muy similar a la autenticación básica, excepto que las contraseñas se envían a través de la red como un valor hash para obtener más seguridad. La autenticación implícita está disponible sólo en dominios con controladores de dominio que ejecutan la autenticación de sistemas operativos de Windows Server. Debe crear las cuentas de dominio o de usuario local correspondientes a las credenciales del cliente.
    - Ntlm: autenticación NTLM. Los clientes pueden enviar las credenciales sin enviar una contraseña a esta ubicación de recepción. Debe crear las cuentas de dominio o de usuario local correspondientes a las credenciales del cliente.
    - Windows: autenticación integrada de Windows. Windows Communication Foundation negocia Kerberos o NTLM; prefiere Kerberos si hay un dominio presente. Si desea usar Kerberos, es importante que el cliente identifique el servicio con un nombre principal de servicio (SPN). Debe crear las cuentas de dominio o de usuario local correspondientes a las credenciales del cliente.
    - Certificado: autenticación de cliente mediante el certificado de cliente. La cadena de certificados de CA de los certificados X.509 del cliente debe estar instalada en el almacén de certificados Entidades emisoras de certificados raíz de confianza del equipo de modo que se puedan autenticar los clientes en esta ubicación de recepción. Nota: La propiedad Tipo de credencial de cliente de transporte debe coincidir con el esquema de autenticación del directorio virtual IIS que hospeda esta ubicación de recepción. Por ejemplo, si la propiedad está establecida como Windows, necesita habilitar también Autenticación de Windows integrada para el directorio virtual que la aloja. De forma parecida, si la propiedad está establecida como Ninguna, debe permitir el acceso anónimo al directorio virtual que aloja esta ubicación de recepción.

    El valor predeterminado es None (Ninguno).
    Tipo de credenciales de cliente de mensajes Especificar el tipo de credenciales que se va a usar a la hora de realizar la autenticación de cliente mediante la seguridad basada en mensajes. Los valores válidos incluyen los siguientes:

    - UserName: permita que esta ubicación de recepción requiera que los clientes se autentiquen con la credencial UserName . Debe crear las cuentas de usuario de dominio o local correspondientes a las credenciales de cliente.
    - Certificado: los clientes se autentican en esta ubicación de recepción mediante el certificado de cliente. La cadena de certificados de CA de los certificados X.509 del cliente debe estar instalada en el almacén de certificados Entidades emisoras de certificados raíz de confianza del equipo de modo que se puedan autenticar los clientes en esta ubicación de recepción.

    El valor predeterminado es UserName.
    Conjunto de algoritmos Especificar el cifrado de mensajes y los algoritmos de encapsulado de claves. Estos algoritmos se asignan a los que se indican en la especificación Security Policy Language (WS-SecurityPolicy). Los valores posibles son:

    - Basic128: use el cifrado Aes128, Sha1 para la síntesis de mensajes y Rsa-oaep-mgf1p para el ajuste de claves.
    - Basic128Rsa15: use Aes128 para el cifrado de mensajes, Sha1 para la síntesis de mensajes y Rsa15 para el ajuste de claves.
    - Basic128Sha256: use Aes256 para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa-oaep-mgf1p para el ajuste de claves.
    - Basic128Sha256Rsa15: use Aes128 para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa15 para el ajuste de claves.
    - Basic192: use el cifrado Aes192, Sha1 para la síntesis de mensajes y Rsa-oaep-mgf1p para el ajuste de claves.
    - Basic192Rsa15: use Aes192 para el cifrado de mensajes, Sha1 para la síntesis de mensajes y Rsa15 para el ajuste de claves.
    - Basic192Sha256: use Aes192 para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa-oaep-mgf1p para el ajuste de claves.
    - Basic192Sha256Rsa15: use Aes192 para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa15 para el ajuste de claves.
    - Basic256: use el cifrado Aes256, Sha1 para la síntesis de mensajes y Rsa-oaep-mgf1p para el ajuste de claves.
    - Basic256Rsa15: use Aes256 para el cifrado de mensajes, Sha1 para la síntesis de mensajes y Rsa15 para el ajuste de claves.
    - Basic256Sha256: use Aes256 para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa-oaep-mgf1p para el ajuste de claves.
    - Basic256Sha256Rsa15: use Aes256 para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa15 para el ajuste de claves.
    - TripleDes: use el cifrado TripleDes, Sha1 para la síntesis de mensajes, Rsa-oaep-mgf1p para el ajuste de claves.
    - TripleDesRsa15: use el cifrado TripleDes, Sha1 para la síntesis de mensajes y Rsa15 para el ajuste de claves.
    - TripleDesSha256: use TripleDes para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa-oaep-mgf1p para el ajuste de claves.
    - TripleDesSha256Rsa15: use TripleDes para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa15 para el ajuste de claves.

    El valor predeterminado es Basic256.
    Huella digital de certificado de servicio Especificar la huella digital del certificado X.509 para esta ubicación de recepción que los clientes utilizan para autenticar el servicio. La huella digital puede seleccionarse desplazándose por Mi almacén, dentro de Usuario actual , con el botón Examinar . Nota: Debe instalar el certificado de servicio en la ubicación Usuario actual de la cuenta de usuario para el controlador de recepción que hospeda esta ubicación de recepción.

    Longitud mínima: 0

    Longitud máxima: 40

    El valor predeterminado es una cadena vacía.
    Uso del inicio de sesión único Usar el inicio de sesión único (SSO) para recuperar credenciales de cliente y emitir, así, un vale de SSO. Esta opción solo es válida para las configuraciones de seguridad que se enumeran en la sección siguiente "Compatibilidad de inicio de sesión único empresarial del adaptador de recepción WCF-BasicHttp".

    Esta opción está desactivada de forma predeterminada.

    Compatibilidad de Sign-On única empresarial para el adaptador de recepción de WCF-BasicHttp Este adaptador puede emitir un vale de SSO desde el servidor SSO solo en las configuraciones de seguridad que se muestran en la tabla siguiente:

    Modo de seguridad Tipo de credenciales de cliente de transporte Tipo de credenciales de cliente de mensajes
    Transporte Basic N/D
    Transporte Digest N/D
    Transporte Ntlm N/D
    Transporte Windows N/D
    Transporte Certificate N/D
    Mensaje N/D UserName
    TransportWithMessageCredential N/D UserName
    TransportCredentialOnly Basic N/D
    TransportCredentialOnly Digest N/D
    TransportCredentialOnly Ntlm N/D
    TransportCredentialOnly Windows N/D
    TransportCredentialOnly Certificate N/D

  8. En el cuadro de diálogo Propiedades de transporte WCF-BasicHttp , en la pestaña Mensajes , especifique la selección de datos para el elemento Cuerpo SOAP:

    Use Para hacer esto
    Sobre :- todo <soap:Envelope> Cree la parte del cuerpo del mensaje de BizTalk a partir del sobre SOAP completo de un mensaje entrante.

    Esta opción está desactivada de forma predeterminada.
    Cuerpo: contenido del <elemento soap:Body> Use el contenido del elemento Cuerpo SOAP de un mensaje entrante para crear la parte del cuerpo del mensaje de BizTalk. Si el elemento Body tiene más de un elemento secundario, solo el primer elemento se convierte en la parte del cuerpo del mensaje de BizTalk.

    Esta es la configuración predeterminada.
    Ruta – contenido ubicado por la ruta del cuerpo Use la expresión de ruta de acceso del cuerpo en el cuadro de texto Expresión de ruta de acceso del cuerpo para crear la parte del cuerpo del mensaje de BizTalk. La expresión de ruta de acceso del cuerpo se evalúa con el elemento secundario inmediato del elemento Cuerpo SOAP de un mensaje entrante.

    Esta opción está desactivada de forma predeterminada.
    Expresión de ruta de cuerpo Escribir la expresión de ruta de cuerpo para identificar una parte específica de un mensaje entrante utilizada para crear la parte del cuerpo del mensaje de BizTalk. Esta expresión de ruta de acceso del cuerpo se evalúa con el elemento secundario inmediato del elemento Cuerpo SOAP de un mensaje entrante. Si esta expresión de ruta de cuerpo devuelve varios nodos, solo se elegirá el primero de ellos para la parte del cuerpo del mensaje de BizTalk. Esta propiedad es necesaria si se selecciona la opción Ruta de acceso : contenido ubicado por ruta de acceso del cuerpo .

    Escriba: String

    Longitud mínima: 0

    Longitud máxima: 32767

    El valor predeterminado es una cadena vacía.
    Codificación de nodo Especifique el tipo de codificación que usa el adaptador de recepción de WCF-BasicHttp para descodificar el nodo identificado por la expresión de ruta de acceso del cuerpo en el cuadro de texto Expresión de ruta de acceso del cuerpo.

    Esta propiedad es necesaria si se selecciona la opción Ruta de acceso : contenido ubicado por ruta de acceso del cuerpo . Los valores válidos incluyen los siguientes:

    - Base64: codificación base64.
    - Hex: codificación hexadecimal.
    - Cadena: codificación de texto - UTF-8
    - XML: los adaptadores WCF crean el cuerpo del mensaje de BizTalk con el XML externo del nodo seleccionado por la expresión de ruta de acceso del cuerpo en el cuadro de texto Expresión de ruta de acceso del cuerpo.

    El valor predeterminado es XML.
    Cuerpo – cuerpo de mensaje de respuesta de BizTalk Use la parte del cuerpo del mensaje de BizTalk para crear el contenido del elemento Cuerpo SOAP de un mensaje de respuesta saliente. Esta propiedad sólo es válida para las ubicaciones de recepción de solicitud-respuesta.

    Esta es la configuración predeterminada.
    Plantilla: contenido especificado por plantilla Use la plantilla proporcionada en el cuadro de texto XML para crear el contenido del elemento Cuerpo SOAP para un mensaje saliente. Esta propiedad sólo es válida para las ubicaciones de recepción de solicitud-respuesta.

    Esta opción está desactivada de forma predeterminada.
    XML Escriba la plantilla con formato XML para el contenido del elemento Cuerpo SOAP de un mensaje saliente. Esta propiedad es necesaria si se selecciona la opción Plantilla- Cuerpo del mensaje de respuesta de BizTalk . Esta propiedad sólo es válida para las ubicaciones de recepción de solicitud-respuesta.

    Escriba: String

    Longitud mínima: 0

    Longitud máxima: 32767

    El valor predeterminado es <bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml">.
    Suspender mensaje de solicitud en caso de error Especificar si se va a suspender el mensaje de solicitud cuyo procesamiento de entrada no se puede realizar correctamente debido a un error de canalización de recepción o de enrutamiento.

    Esta opción está desactivada de forma predeterminada.
    Incluir detalle de excepción en errores Especificar si se van a devolver errores de SOAP cuando se produce un error para una depuración sencilla.

    Esta opción está desactivada de forma predeterminada.

Crear el puerto de envío

Nota

También puede crear el puerto de envío mediante programación.

  1. En la consola de administración de BizTalk, 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 WCF-BasicHttp 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 WCF-BasicHttp , en la pestaña General , configure la dirección del punto de conexión, la identidad del servicio y el encabezado HTTP SOAPAction para el puerto de envío de WCF-BasicHttp:

    Nota

    Si especifica el esquema https para la propiedad Address (URI), debe configurar la propiedad Modo de seguridad en Transport o TransportWithMessageCredential. Puede usar la pestaña Seguridad para configurar la propiedad Modo de seguridad .

    Use Para hacer esto
    Dirección (URI) Necesario. Especificar el URI completo de este puerto de envío. Use el esquema https o http en función de la configuración de seguridad.

    Longitud máxima: 255

    Valor predeterminado: http://localhost/
    Identidad de extremo Opcional. Especifique la identidad de servicio que espera este puerto de envío. Esta configuración permite al puerto de envío autenticar el servicio. En el proceso de negociación entre el cliente y el servicio, la infraestructura de Windows Communication Foundation (WCF) asegurará que la identidad del servicio esperado coincide con los valores de este elemento. Los valores que se pueden especificar para la propiedad Identity difieren según la configuración de seguridad.

    Esta opción está desactivada de forma predeterminada.
    Acción Especifique el campo de encabezado HTTP SOAPAction para los mensajes salientes. Esta propiedad también se puede establecer a través de la propiedad de contexto del mensaje WCF. Acción en una canalización o orquestación.

    Puede especificar este valor de dos maneras diferentes: el formato de acción única y el formato de asignación de acciones. Si establece esta propiedad en el formato de acción única, por ejemplo, http://contoso.com/Svc/Op1, el encabezado SOAPAction para los mensajes salientes siempre se establece en el valor especificado en esta propiedad.

    Si establece esta propiedad en el formato de asignación de acciones, el encabezado SOAPAction saliente viene determinado por BTS. Propiedad de contexto de la operación . Por ejemplo, si esta propiedad se establece en el siguiente formato XML y BTS. La propiedad Operation se establece en Op1, el adaptador de envío de WCF usa http://contoso.com/Svc/Op1 para el encabezado SOAPAction saliente.

    <BtsActionMapping>
    <Operation Name="Op1" Action="http://contoso.com/Svc/Op1" />
    <Operation Name="Op2" Action="http://contoso.com/Svc/Op2"/>
    </BtsActionMapping>

    Si los mensajes salientes proceden de un puerto de orquestación, las instancias de orquestación establecen dinámicamente el BTS. Propiedad Operation con el nombre de la operación del puerto. Si los mensajes salientes se enrutan con enrutamiento basado en contenido, puede establecer bts. Propiedad Operation en los componentes de canalización.

    Longitud mínima: 0

    Longitud máxima: 32767

    El valor predeterminado es una cadena vacía.

  4. En PROPIEDADES de transporte WCF-BasicHttp, en la pestaña Enlace , configure las propiedades de tiempo de espera y codificación:

    Use Para hacer esto
    Tiempo de espera de apertura (hh:mm:ss) Especificar un valor de marco temporal que indica el intervalo de tiempo proporcionado para que se complete una operación de apertura del canal. Este valor debe ser mayor o igual que System.TimeSpan.Zero.

    Valor predeterminado: 00:01:00

    Valor máximo: 23:59:59
    Tiempo de espera de envío (hh:mm:ss) Especificar un valor de marco temporal que indica el intervalo de tiempo proporcionado para que se complete una operación de envío. Este valor debe ser mayor o igual que System.TimeSpan.Zero. Si usa un puerto de envío de petición-respuesta, este valor especifica un marco temporal para que se complete la interacción, incluso cuando el servicio devuelva un mensaje grande.

    Valor predeterminado: 00:01:00

    Valor máximo: 23:59:59
    Tiempo de espera de cierre (hh:mm:ss) Especificar un valor de marco temporal que indica el intervalo de tiempo proporcionado para que se complete una operación de cierre del canal. Este valor debe ser mayor o igual que System.TimeSpan.Zero.

    Valor predeterminado: 00:01:00

    Valor máximo: 23:59:59
    Tamaño máximo de mensaje recibido (bytes) Especificar el tamaño máximo, en bytes, para mensajes, con encabezados incluidos, que se pueden recibir a través de la red. El tamaño de los mensajes se limita mediante la cantidad de memoria asignada a cada mensaje. Puede usar esta propiedad para limitar la exposición a ataques por denegación de servicio (DoS).

    El adaptador de WCF-BasicHttp aprovecha la clase BasicHttpBinding en el modo de transferencia almacenada en búfer para comunicarse con un punto de conexión. Para el modo de transporte almacenado en búfer, la propiedad BasicHttpBinding.MaxBufferSize siempre es igual al valor de esta propiedad.

    Valor predeterminado: 65536

    Valor máximo: 2147483647
    Codificación de mensajes Especificar el codificador que se usa para codificar el mensaje SOAP. Los valores válidos incluyen los siguientes:

    - Texto: use un codificador de mensajes de texto.
    - Mtom: use un codificador de la organización de transmisión de mensajes 1.0 (MTOM).

    Valor predeterminado: Texto
    Codificación de texto Especifique la codificación del juego de caracteres que se usará para emitir mensajes en el enlace cuando la propiedad Codificación de mensajes esté establecida en Texto. Los valores válidos incluyen los siguientes:

    - utf-16BE (unicodeFFFE):codificación Unicode BigEndian.
    - utf-16: codificación de 16 bits.
    - utf-8: codificación de 8 bits

    Valor predeterminado: utf-8

  5. En el cuadro de diálogo Propiedades de transporte WCF-BasicHttp , en la pestaña Seguridad , defina las funcionalidades de seguridad del puerto de envío de WCF-BasicHttp:

    Use Para hacer esto
    Modo de seguridad Especificar el tipo de seguridad que se usa. Los valores válidos incluyen los siguientes:

    - Ninguno: los mensajes no están protegidos durante la transferencia.
    - Transporte: la seguridad se proporciona mediante el transporte HTTPS. Los mensajes SOAP están protegidos mediante HTTPS. La cadena de certificados de CA del certificado X.509 del servicio debe estar instalada en el almacén de certificados Entidades emisoras de certificados raíz de confianza del equipo de modo que se pueda autenticar el servicio en el puerto de envío mediante el certificado del servicio.
    - Mensaje: La seguridad se proporciona mediante la seguridad del mensaje SOAP. De forma predeterminada, el elemento Cuerpo soap está cifrado y firmado. El único tipo de credencial de cliente de mensaje válido para el adaptador de envío de WCF-BasicHttp es Certificate. Este modo necesita el transporte HTTP.
    - TransportWithMessageCredential: el transporte HTTPS proporciona integridad, confidencialidad y autenticación del servicio. La cadena de certificados de CA del certificado X.509 del servicio debe estar instalada en el almacén de certificados Entidades emisoras de certificados raíz de confianza en este equipo de modo que se pueda autenticar el servicio en el puerto de envío mediante el certificado del servicio. La seguridad de mensajes de SOAP proporciona la autenticación del puerto de envío.
    - TransportCredentialOnly: este modo no proporciona integridad y confidencialidad de los mensajes. Proporciona la autenticación del cliente basada en HTTP. Este modo se debe utilizar con precaución. Se debe usar en entornos donde la seguridad de transporte se proporcione por otros medios (por ejemplo, IPSec) y solo se proporcione la autenticación de cliente a través de la infraestructura de WCF.

    El valor predeterminado es None (Ninguno).
    Tipo de credenciales de cliente de transporte Especificar el tipo de credenciales que se va a usar a la hora de realizar la autenticación del puerto de envío. Los valores válidos incluyen los siguientes:

    - Ninguno: no se produce ninguna autenticación en el nivel de transporte.
    - Básico: autenticación básica. En la autenticación básica, los nombres de usuario y las contraseñas se envían en texto sin formato por la red. Esta opción requiere configurar la propiedad Credenciales de cliente .
    - Resumen: autenticación implícita. Este método de autenticación funciona de forma muy similar a la autenticación básica, excepto que las contraseñas se envían a través de la red como un valor hash para obtener más seguridad. La autenticación implícita está disponible sólo en dominios con controladores de dominio que ejecutan la autenticación de sistemas operativos de Windows Server. Esta opción requiere configurar la propiedad Credenciales de cliente .
    - Ntlm: autenticación NTLM. La cuenta de usuario en la que se ejecuta este puerto de envío se usa para que los servicios autentiquen este puerto de envío.
    - Windows: autenticación integrada de Windows. La cuenta de usuario en la que se ejecuta este puerto de envío se usa para que los servicios autentiquen este puerto de envío.
    - Certificado: autenticación de cliente mediante el certificado de cliente especificado a través de la propiedad Certificado de cliente - Huella digital . Al usar este tipo de credencial, el certificado de servicio debe proporcionarse a través de la propiedad Service certificate - Thumbprint .

    El valor predeterminado es None (Ninguno).
    Tipo de credenciales de cliente de mensajes Especificar el tipo de credenciales que se va a usar a la hora de realizar la autenticación de cliente mediante la seguridad basada en mensajes. Los valores válidos incluyen los siguientes:

    - UserName: este puerto de envío se autentica en el servicio con una credencial UserName . En el caso del adaptador de envío WCF-BasicHttp, esto no es compatible.
    - Certificado: este puerto de envío se autentica en los servicios mediante el certificado de cliente especificado a través de la propiedad Certificado de cliente - Huella digital . Además, al usar este tipo de credencial, el certificado de servicio debe proporcionarse a través de la propiedad Service certificate - Thumbprint .

    El valor predeterminado es UserName.
    Conjunto de algoritmos Especificar el cifrado de mensajes y los algoritmos de encapsulado de claves. Estos algoritmos se asignan a los que se indican en la especificación Security Policy Language (WS-SecurityPolicy). Los valores posibles son:

    - Basic128: use el cifrado Aes128, Sha1 para la síntesis de mensajes y Rsa-oaep-mgf1p para el ajuste de claves.
    - Basic128Rsa15: use Aes128 para el cifrado de mensajes, Sha1 para la síntesis de mensajes y Rsa15 para el ajuste de claves.
    - Basic128Sha256: use Aes256 para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa-oaep-mgf1p para el ajuste de claves.
    - Basic128Sha256Rsa15: use Aes128 para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa15 para el ajuste de claves.
    - Basic192: use el cifrado Aes192, Sha1 para la síntesis de mensajes y Rsa-oaep-mgf1p para el ajuste de claves.
    - Basic192Rsa15: use Aes192 para el cifrado de mensajes, Sha1 para la síntesis de mensajes y Rsa15 para el ajuste de claves.
    - Basic192Sha256: use Aes192 para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa-oaep-mgf1p para el ajuste de claves.
    - Basic192Sha256Rsa15: use Aes192 para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa15 para el ajuste de claves.
    - Basic256: use el cifrado Aes256, Sha1 para la síntesis de mensajes y Rsa-oaep-mgf1p para el ajuste de claves.
    - Basic256Rsa15: use Aes256 para el cifrado de mensajes, Sha1 para la síntesis de mensajes y Rsa15 para el ajuste de claves.
    - Basic256Sha256: use Aes256 para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa-oaep-mgf1p para el ajuste de claves.
    - Basic256Sha256Rsa15: use Aes256 para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa15 para el ajuste de claves.
    - TripleDes: use el cifrado TripleDes, Sha1 para la síntesis de mensajes, Rsa-oaep-mgf1p para el ajuste de claves.
    - TripleDesRsa15: use el cifrado TripleDes, Sha1 para la síntesis de mensajes y Rsa15 para el ajuste de claves.
    - TripleDesSha256: use TripleDes para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa-oaep-mgf1p para el ajuste de claves.
    - TripleDesSha256Rsa15: use TripleDes para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa15 para el ajuste de claves.

    El valor predeterminado es Basic256.
    Huella digital de certificado de cliente Especificar la huella digital del certificado X.509 para la autenticación de este puerto de envío en servicios. Para seleccionar la huella digital, vaya a Mi almacén en la ubicación Usuario actual con el botón Examinar . Nota: Debe instalar el certificado de cliente en la ubicación Usuario actual de la cuenta de usuario para el controlador de envío que hospeda este puerto de envío.

    Longitud mínima: 0

    Longitud máxima: 40

    El valor predeterminado es una cadena vacía.
    Huella digital de certificado de servicio Especificar la huella digital del certificado X.509 para la autenticación del servicio al que este puerto de envío envía mensajes. Puede seleccionar la huella digital que va al almacén Otros Personas en la ubicación del equipo local con el botón Examinar.

    Longitud mínima: 0

    Longitud máxima: 40

    El valor predeterminado es una cadena vacía.
    Credenciales de nombre de usuario Especificar las credenciales para enviar mensajes. Para especificar la propiedad, haga clic en el botón Editar . Esta opción solo es válida para la configuración de seguridad que se enumera en la sección siguiente "Compatibilidad de inicio de sesión único empresarial del adaptador de envío WCF-BasicHttp".

    El valor predeterminado es No usar el inicio de sesión único.
    Información de conexión de Service Bus Novedades a partir de BizTalk Server 2016.

    Elija usar la firma de acceso compartido (SAS) o Access Control Service (ACS) del espacio de nombres de Service Bus.

    Seleccione una opción y, a continuación, seleccione Editar para escribir la información de clave:

    - Firma de acceso compartido : escriba el nombre de la clave de acceso y la clave de acceso. Ambos valores se enumeran en el Azure Portal.
    - Access Control Servicio: escriba el URI de STS (https://<yourNamespace>-sb.accesscontrol.windows.net/), el nombre del emisor y la clave del emisor. Use Windows PowerShell para recuperar estos valores, como se describe en SB-Messaging adapter (Adaptador de SB-Messaging).

    Compatibilidad de Sign-On única empresarial para el adaptador de envío de WCF-BasicHttp El adaptador de envío de WCF-BasicHttp puede canjear un vale de SSO desde el servidor SSO para obtener la credencial de usuario solo en las configuraciones de seguridad que se muestran en la tabla siguiente.

    Modo de seguridad Tipo de credenciales de cliente de transporte Tipo de credenciales de cliente de mensajes
    Transporte Basic N/D
    Transporte Digest N/D
    TransportCredentialOnly Basic N/D
    TransportCredentialOnly Digest N/D
    Mensaje N/D UserName
    TransportWithMessageCredential N/D UserName

  6. En el cuadro de diálogo Propiedades de transporte WCF-BasicHttp , en la pestaña Proxy , configure el valor de proxy para el puerto de envío de WCF-BasicHttp:

    Use Para hacer esto
    Utilizar la configuración predeterminada del servidor proxy del controlador Especificar si el puerto de envío usa la configuración de proxy en el controlador de envío que aloja este puerto de envío.

    Esta es la configuración predeterminada.
    No utilizar proxy Indicar si el puerto de envío usa un servidor proxy.

    Esta opción está desactivada de forma predeterminada.
    Utilizar proxy Indique si este puerto de envío usa el servidor proxy especificado en la propiedad Address .

    Esta opción está desactivada de forma predeterminada.
    Dirección Especifique la dirección del servidor proxy. Use el esquema https o http en función de la configuración de seguridad. Esta dirección puede ir seguida de dos puntos y el número de puerto. Por ejemplo, http://127.0.0.1:8080.

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

    Escriba: String

    Longitud máxima: 256

    El valor predeterminado es una cadena vacía.
    Nombre de usuario Especificar el nombre de usuario que se utilizará para la autenticación. Si se usa la autenticación integrada, el nombre de usuario incluye el dominio, es decir, dominio\nombre de usuario. Si se utiliza la autenticación básica o implícita, el nombre de usuario no incluye dominio\. Esta propiedad solo requiere un valor si se selecciona Usar proxy . Nota: El WCF-BasicHttp adaptador de envío usa la autenticación básica para el proxy.

    Escriba: String

    Longitud mínima: 0

    Longitud máxima: 256

    El valor predeterminado es una cadena vacía.
    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

    El valor predeterminado es una cadena vacía.

  7. En el cuadro de diálogo Propiedades de transporte WCF-BasicHttp , en la pestaña Mensajes , especifique la selección de datos para el elemento Cuerpo SOAP.

    Use Para hacer esto
    Cuerpo: cuerpo de mensaje de solicitud de BizTalk Use la parte del cuerpo del mensaje de BizTalk para crear el contenido del elemento Cuerpo soap para un mensaje saliente.

    Esta es la configuración predeterminada.
    Plantilla: contenido especificado por plantilla Use la plantilla proporcionada en el cuadro de texto XML para crear el contenido del elemento Cuerpo SOAP para un mensaje saliente.

    Esta opción está desactivada de forma predeterminada.
    XML Escriba la plantilla con formato XML para el contenido del elemento Cuerpo SOAP de un mensaje saliente. Esta propiedad es necesaria si se selecciona la opción Plantilla: cuerpo del mensaje de respuesta de BizTalk .

    Escriba: String

    Longitud mínima: 0

    Longitud máxima: 32767

    El valor predeterminado es <bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/>.
    Sobre: jabón completo <:Sobre> Cree la parte del cuerpo del mensaje de BizTalk a partir del sobre SOAP completo de un mensaje entrante. Esta propiedad sólo es válida para puertos de petición-respuesta.

    Esta opción está desactivada de forma predeterminada.
    Cuerpo: contenido del <elemento soap:Body> Use el contenido del elemento Cuerpo soap de un mensaje entrante para crear la parte del cuerpo del mensaje de BizTalk. Si el elemento Body tiene más de un elemento secundario, solo el primer elemento se convierte en la parte del cuerpo del mensaje de BizTalk. Esta propiedad sólo es válida para puertos de petición-respuesta.

    Esta es la configuración predeterminada.
    Ruta – contenido ubicado por la ruta del cuerpo Use la expresión de ruta de acceso del cuerpo en el cuadro de texto Expresión de ruta de acceso del cuerpo para crear la parte del cuerpo del mensaje de BizTalk. La expresión de ruta de acceso del cuerpo se evalúa con respecto al elemento secundario inmediato del elemento Body soap de un mensaje entrante. Esta propiedad sólo es válida para puertos de petición-respuesta.

    Esta opción está desactivada de forma predeterminada.
    Expresión de ruta de cuerpo Escribir la expresión de ruta de cuerpo para identificar una parte específica de un mensaje entrante utilizada para crear la parte del cuerpo del mensaje de BizTalk. Esta expresión de ruta de acceso del cuerpo se evalúa con el elemento secundario inmediato del nodo Cuerpo SOAP de un mensaje entrante. Si esta expresión de ruta de cuerpo devuelve varios nodos, solo se elegirá el primero de ellos para la parte del cuerpo del mensaje de BizTalk. Esta propiedad es necesaria si se selecciona la opción Ruta de acceso : contenido ubicado por ruta de acceso del cuerpo . Esta propiedad sólo es válida para puertos de petición-respuesta.

    Escriba: String

    Longitud mínima: 0

    Longitud máxima: 32767

    El valor predeterminado es una cadena vacía.
    Codificación de nodo Especifique el tipo de codificación que usa el adaptador de envío WCF-BasicHttp para descodificar el nodo identificado por la expresión de ruta de acceso del cuerpo en el cuadro de texto Expresión de ruta de acceso del cuerpo. Esta propiedad es necesaria si se selecciona la opción Ruta de acceso : contenido ubicado por ruta de acceso del cuerpo . Esta propiedad sólo es válida para puertos de petición-respuesta. Los valores válidos incluyen los siguientes:

    - Base64: codificación base64.
    - Hexadecimal: codificación hexadecimal.
    - Cadena: codificación de texto - UTF-8
    - XML: los adaptadores WCF crean el cuerpo del mensaje de BizTalk con el XML externo del nodo seleccionado por la expresión de ruta de acceso del cuerpo en el cuadro de texto Expresión de ruta de acceso del cuerpo.

    El valor predeterminado es XML.
    Propagar mensaje de error Active esta casilla para enrutar el mensaje que genere un error de procesamiento de salida a una aplicación de suscripción (por ejemplo, otro puerto de recepción o programación de orquestación). Desactive la casilla para suspender los mensajes con error y generar una confirmación negativa (NACK). Esta propiedad sólo es válida para puertos de petición-respuesta.

    El valor predeterminado es activada.

Agregar un proxy al controlador de envío

Puede agregar un proxy al puerto de envío o al controlador de envío. Si va a agregar un proxy en el puerto de envío, omita esta sección.

  1. En la consola de administración de BizTalk Server, expanda administración BizTalk Server, expanda Grupo de BizTalk, expanda Configuración de la plataforma y, a continuación, expanda Adaptadores.

  2. Seleccione WCF-BasicHttp y, a continuación, haga doble clic en el controlador de envío.

  3. En Propiedades del controlador de adaptadores, en la pestaña General , seleccione Propiedades.

  4. En la pestaña Proxy , haga lo siguiente.

    Use Para hacer esto
    Utilizar proxy Indica si este controlador de envío usa un servidor proxy.

    Esta opción está desactivada de forma predeterminada.
    Dirección Especifique la dirección del servidor proxy. Use el esquema https o http en función de la configuración de seguridad. Esta dirección puede ir seguida de dos puntos y el número de puerto. Por ejemplo, http://127.0.0.1:8080.

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

    Escriba: String

    Longitud máxima: 256

    El valor predeterminado es una cadena vacía.
    Nombre de usuario Especificar el nombre de usuario que se utilizará para la autenticación. Si se usa la autenticación integrada o básica, el nombre de usuario incluye el dominio, es decir, dominio\nombre de usuario. Si se utiliza la autenticación implícita, el nombre de usuario no incluye dominio\.

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

    Escriba: String

    Longitud mínima: 0

    Longitud máxima: 256

    El valor predeterminado es una cadena vacía.
    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

    El valor predeterminado es una cadena vacía.

  5. Haga clic en Aceptar hasta que salga de todos los cuadros de diálogo.

    Vea también

¿Qué son los adaptadores de WCF?

Adaptador de SB-Messaging

Uso de adaptadores