Adaptador WCF-BasicHttpRelay

Artículo
07/21/2023

Microsoft BizTalk Server usa el adaptador WCF-BasicHttpRelay para recibir y enviar solicitudes de servicio WCF a través de la clase BasicHttpRelayBinding. El adaptador WCF-BasicHttpRelay usa puntos de conexión de retransmisión de Service Bus mediante BasicHttpRelayBinding.

Antes de empezar

A partir de BizTalk Server 2016, este adaptador 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.

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

Nota

Antes de completar el procedimiento siguiente, debe haber agregado ya un puerto de recepción unidireccional. Consulte Cómo crear un puerto de recepción.

En la consola de administración de BizTalk Server, expanda BizTalk Server Administración, expanda Grupo de BizTalk, expanda Aplicaciones y, a continuación, expanda la aplicación en la que desea crear una ubicación de recepción.
En el panel izquierdo, haga clic en el nodo Puertos de recepción y, en el panel derecho, haga clic con el botón derecho en el puerto de recepción al que desea asociar la nueva ubicación de recepción y, a continuación, haga clic en Propiedades.
En el panel de la izquierda del cuadro de diálogo Propiedades de puerto de recepción , seleccione Ubicaciones de recepcióny, en el panel de la derecha, haga clic en Nueva para crear una nueva ubicación de recepción.
En el cuadro de diálogo Propiedades de ubicación de recepción, en la sección Transporte , seleccione WCF-BasicHttpRelay en la lista desplegable Tipo y, a continuación, haga clic en Configurar para configurar las propiedades de transporte para la ubicación de recepción.

En el cuadro de diálogo Propiedades de transporte WCF-BasicHttpRelay , en la pestaña General , configure la dirección del punto de conexión donde se hospeda el punto de conexión de Retransmisión de Service Bus y la identidad de servicio de la ubicación de recepción del WCF-BasicHttpRelay.

Use	Para hacer esto
Dirección (URI)	Necesario. Especifique el URI donde se implementa el extremo de retransmisión del Service Bus.
Identidad de extremo	Opcional. Especifique la identidad del extremo. Esta configuración habilita al extremo para autenticar la ubicación de recepción. En el proceso de negociación entre el extremo y la ubicación de recepción, 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.

Use

Para hacer esto

Dirección (URI)

Necesario. Especifique el URI donde se implementa el extremo de retransmisión del Service Bus.

Identidad de extremo

Opcional. Especifique la identidad del extremo. Esta configuración habilita al extremo para autenticar la ubicación de recepción. En el proceso de negociación entre el extremo y la ubicación de recepción, 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.

En el cuadro de diálogo Propiedades de transporte WCF-BasicHttpRelay , en la pestaña Enlace , configure las propiedades relacionadas con el tiempo de espera y la 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-BasicHttpRelay aprovecha la clase BasicHttpRelayBinding 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 BasicHttpRelayBinding.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.

En el cuadro de diálogo Propiedades de transporte WCF-BasicHttpRelay , en la pestaña Seguridad , defina las funcionalidades de seguridad de la ubicación de recepción del WCF-BasicHttpRelay.

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). El valor predeterminado es Transporte.
Tipo de credenciales de cliente de mensajes	Especifique las opciones de seguridad de nivel de mensaje solo si establece el modo de seguridad anterior en Message o TransportWithMessageCredential. Los valores válidos incluyen los siguientes: - UserName: permite 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	Especifique el cifrado de mensajes y los algoritmos de ajuste de claves solo si establece el modo de seguridad anterior en Message o TransportWithMessageCredential. Esto no es aplicable si establece el modo de seguridad en Ninguno o Transporte. 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: Solo debe establecer esta propiedad si establece el modo de seguridad anterior en Message o TransportWithMessageCredential. Esto no es aplicable si establece el modo de seguridad en Ninguno o Transporte. 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.
Tipo de autenticación de cliente de retransmisión	Especifique la opción para autenticar con el extremo de retransmisión del Service Bus desde donde se recibe el mensaje. Los valores válidos incluyen los siguientes: - Ninguno: no se requiere autenticación. - RelayAccessToken: especifique esto para usar un token de seguridad para autorizar con el punto de conexión de Service Bus Relay. El valor predeterminado es RelayAccessToken.
Habilitar la detección del servicio	Seleccione esta casilla para especificar si el comportamiento del servicio se publica en el Registro de Servicio. - Nombre para mostrar : especifique el nombre con el que se publica el servicio en el Registro de servicios. - Modo de detección : establezca el modo de detección para el servicio publicado en el Registro de servicios. Para obtener más información, vea DiscoveryType Enum.
Access Control Service	Se aplica a BizTalk Server 2013 R2 y BizTalk Server 2013. Si establece el Tipo de autenticación de cliente de retransmisión en RelayAccessToken, haga clic en el botón Editar e indique los siguientes detalles: - Access Control Uri de STS de servicio: establézcalo `https://<Namespace>-sb.accesscontrol.windows.net/`en , donde <el espacio de nombres> es el espacio de nombres de Service Bus. - Nombre del emisor : especifique el nombre del emisor. Normalmente, este valor está establecido en el propietario. - Clave del emisor: especifique la clave del emisor.
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).

En el cuadro de diálogo Propiedades de transporte WCF-BasicHttpRelay , 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-BasicHttpRelay 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.

Haga clic en OK.
Especifique los valores apropiados en el cuadro de diálogo Propiedades de la ubicación de recepción para completar la configuración de la ubicación de recepción y haga clic en Aceptar para guardar la configuración. Para información sobre el cuadro de diálogo Propiedades de ubicaciones de recepción , vea Cómo crear una ubicación de recepción.

Crear el puerto de envío

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. Consulte Cómo crear un puerto de envío. Configure todas las opciones de puerto de envío y especifique WCF-BasicHttpRelay para la opción Tipo en la sección Transporte de la pestaña General .
En la pestaña General , en la sección Transporte , haga clic en el botón Configurar .

En el cuadro de diálogo Propiedades de transporte WCF-BasicHttpRelay , en la pestaña General , especifique lo siguiente:

Use	Para hacer esto
Dirección (URI)	Necesario. Especifique la dirección URL donde se implementa el punto de conexión de retransmisión en Service Bus. Normalmente, la dirección URL tiene el siguiente formato: `https://<namespace>.servicebus.windows.net/`
Identidad de extremo	Opcional. Especifique la identidad del extremo. Esta configuración permite que el puerto de envío se autentique con el extremo. En el proceso de negociación entre el extremo y el puerto de envío, la infraestructura de Windows Communication Foundation (WCF) asegurará que la identidad del extremo coincide con los valores de este elemento. 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 de 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 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 el BTS. Propiedad Operation en componentes de canalización. Importante: Service Bus exige que se establezca una acción SOAP al enviar mensajes a puntos de conexión de retransmisión. Longitud mínima: 0 Longitud máxima: 32767 El valor predeterminado es una cadena vacía.

En el cuadro de diálogo Propiedades de transporte WCF-BasicHttpRelay , 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-BasicHttpRelay 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). Valor predeterminado: Texto
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 Valor predeterminado: utf-8

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

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. 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-BasicHttpRelay 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. El valor predeterminado es None (Ninguno).
Tipo de credenciales de cliente de mensajes	Especifique las opciones de seguridad de nivel de mensaje solo si establece el modo de seguridad anterior en Message o TransportWithMessageCredential. Los valores válidos incluyen los siguientes: - UserName: este puerto de envío se autentica en el punto de conexión con una credencial UserName . Esto no es compatible con el adaptador de envío WCF-BasicHttpRelay. - Certificado: este puerto de envío se autentica en el punto de conexión 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 encapsulado de claves. - Basic128Rsa15: use Aes128 para el cifrado de mensajes, Sha1 para la síntesis de mensajes y Rsa15 para el encapsulado de claves. - Basic128Sha256: use Aes256 para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa-oaep-mgf1p para el encapsulado de claves. - Basic128Sha256Rsa15: use Aes128 para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa15 para el encapsulado de claves. - Basic192: Use el cifrado Aes192, Sha1 para la síntesis de mensajes y Rsa-oaep-mgf1p para el encapsulado de claves. - Basic192Rsa15: use Aes192 para el cifrado de mensajes, Sha1 para la síntesis de mensajes y Rsa15 para el encapsulado de claves. - Basic192Sha256: use Aes192 para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa-oaep-mgf1p para el encapsulado de claves. - Basic192Sha256Rsa15: use Aes192 para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa15 para el encapsulado de claves. - Basic256: Use el cifrado Aes256, Sha1 para la síntesis de mensajes y Rsa-oaep-mgf1p para el encapsulado de claves. - Basic256Rsa15: use Aes256 para el cifrado de mensajes, Sha1 para la síntesis de mensajes y Rsa15 para el encapsulado de claves. - Basic256Sha256: use Aes256 para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa-oaep-mgf1p para el encapsulado de claves. - Basic256Sha256Rsa15: use Aes256 para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa15 para el encapsulado de claves. - TripleDes: use el cifrado TripleDes, Sha1 para la síntesis de mensajes, Rsa-oaep-mgf1p para el encapsulado de claves. - TripleDesRsa15: use el cifrado TripleDes, Sha1 para la síntesis de mensajes y Rsa15 para el encapsulado de claves. - TripleDesSha256: use TripleDes para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa-oaep-mgf1p para el encapsulado de claves. - TripleDesSha256Rsa15: use TripleDes para el cifrado de mensajes, Sha256 para la síntesis de mensajes y Rsa15 para el encapsulado de claves. El valor predeterminado es Basic256.
Huella digital de certificado de cliente	Especifique la huella digital del certificado X.509 para autenticar este puerto de envío en el extremo. 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	Especifique la huella digital del certificado X.509 para autenticar el extremo 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 Máquina 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 . Debe establecer las credenciales si seleccionó la opción Nombre de usuario para tipo de credencial de cliente de mensaje. El valor predeterminado es No usar inicio de sesión único.
Usar la identidad del servicio de ACS	Se aplica a BizTalk Server 2013 R2 y BizTalk Server 2013. Active esta casilla y haga clic en Editar y proporcione los valores siguientes para autenticarse con Service Bus. - Access Control URI de STS de servicio: establézcalo `https://<Namespace>-sb.accesscontrol.windows.net/`en , donde <espacio de nombres es el espacio de nombres> de Service Bus. - Nombre del emisor : especifique el nombre del emisor. Normalmente, este valor está establecido en el propietario. - Clave del emisor: especifique la clave del emisor.
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 la clave: - Firma de acceso compartido : escriba el nombre de la clave de acceso y la clave de acceso. Ambos valores se muestran 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, tal y como se describe en el adaptador de SB-Messaging.

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

Use	Para hacer esto
Uso de la configuración del proxy de controlador de envío	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 adaptador de envío WCF-BasicHttpRelay 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.

En el cuadro de diálogo Propiedades de transporte WCF-BasicHttpRelay , 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 soap ody 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-BasicHttpRelay 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.

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

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.

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.
Seleccione WCF-BasicHttpRelay y, a continuación, seleccione el controlador de envío.
En Propiedades del controlador de adaptadores, en la pestaña General , seleccione Propiedades.

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.

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

Consulte también

Adaptador de SB-Messaging

Uso de adaptadores

Compartir a través de