adaptador de WCF-BasicHttp

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 comunicaciones entre equipos con servicios web y clientes basados en ASMX heredados que cumplan con el perfil básico 1.1 de WS-I mediante el transporte HTTP o HTTPS con codificación de texto. Sin embargo, no podrá aprovechar las características compatibles con los protocolos WS-*.

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

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 enviar el puerto mediante programación.

Antes de empezar

• A partir de BizTalk Server 2016, este adaptador de envío puede usar el Servicio de Control de Acceso (ACS) o la Firma de Acceso Compartido (SAS) para autenticar en 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 adaptador 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 tasa de documentos por segundo de los adaptadores WCF es generalmente mejor que la del adaptador SOAP.
  • El adaptador SOAP tiene la desventaja de serializar y deserializar mensajes entre tipos de .NET y datos XML sin procesar; que, en algunos casos, podría dar lugar a modificaciones de datos no deseadas. Los adaptadores de WCF toman el enfoque de conservar el flujo de datos.
  • Los adaptadores de WCF publican lo que es básicamente el mismo esquema que se usará en el entorno de ejecución de BizTalk. Por el contrario, el adaptador SOAP devuelve metadatos generados mediante la reflexión en las clases de .NET generadas para representar los esquemas. Dado que .NET no conserva todos los matices de los esquemas XSD, es posible que el WSDL expuesto no refleje con precisión los esquemas usados por el entorno de ejecución de BizTalk.
  • Es más fácil migrar de WCF-BasicHttp a WCF-WSHttp, si es necesario.

• Use el WCF-BasicHttp adaptador de recepción para recibir solicitudes de servicio WCF a través del protocolo HTTP o HTTPS. Utilizas el adaptador de envío WCF-BasicHttp para llamar a un servicio WCF a través del contrato sin definir 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 de solicitud-respuesta (bidireccional).

1. En la consola de administración de BizTalk, expanda Administración de BizTalk Server, expanda Grupo de BizTalk, expanda Aplicaciones, y luego 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 derecho, haga clic con el botón derecho en el puerto de recepción asociado a una ubicación de recepción existente o que quiera asociar a una nueva ubicación de recepción y, a continuación, haga clic en Propiedades.

3. En el cuadro de diálogo Propiedades del puerto de recepción, en el panel izquierdo, seleccione Ubicaciones de recepción y, a continuación, en el panel derecho, 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 WCF-BasicHttp Propiedades de transporte, en la pestaña General , configure la dirección del punto de conexión y la identidad del 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).

   Usa esto	Para
   Dirección (URI)	Obligatorio. Especifique el URI para 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 del punto de conexión	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 permite al cliente autenticar esta ubicación de recepción. En el proceso de enlace entre el cliente y el servicio, la infraestructura de Windows Communication Foundation (WCF) garantizará que la identidad del servicio esperado coincida 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 WCF-BasicHttp Propiedades de transporte, en la pestaña Enlace, configure las propiedades de tiempo de espera y codificación:

   Usa esto	Para
   Tiempo de espera al abrir (hh:mmss)	Especifique un valor de intervalo de tiempo que indique 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 para el envío (hh:mmss)	Especifique un valor de intervalo de tiempo que indique 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 de solicitud-respuesta, este valor especifica un intervalo de tiempo para que se complete toda la interacción, incluso si el cliente devuelve un mensaje grande. Valor predeterminado: 00:01:00 Valor máximo: 23:59:59
   Tiempo de espera de cierre (hh:mmss)	Especifique un valor de intervalo de tiempo que indique 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)	Especifique el tamaño máximo, en bytes, para un mensaje, incluidos los encabezados, que se puede recibir a través del cable. El tamaño de los mensajes está limitado por la cantidad de memoria asignada para 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	Especifique el codificador usado para codificar el mensaje SOAP. Entre los valores válidos se incluyen los siguientes: - Texto: use un codificador de mensajes de texto. - Mtom: Utilice un codificador del mecanismo de transmisión de mensajes 1.0 (MTOM). El valor predeterminado es Text.
   Codificación de texto	Especifique la codificación del conjunto de caracteres que se usará para emitir mensajes en el enlace cuando la propiedad de codificación de mensajes esté establecida en Texto. Entre los valores válidos se 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 simultáneas	Especifique el número de llamadas simultáneas a una sola instancia de servicio. 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 transporteWCF-BasicHttp , en la pestaña Seguridad , defina las funcionalidades de seguridad:

   Usa esto	Para
   Modo de seguridad	Especifique el tipo de seguridad que se usa. Entre los valores válidos se 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 se protegen mediante HTTPS. Para usar este modo, debe configurar capa de sockets seguros (SSL) en Microsoft Internet Information Services (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 requiere 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 Certificado de servicio : huella digital . - TransportWithMessageCredential: el transporte HTTPS proporciona integridad, confidencialidad y autenticación del servicio. Para usar este modo, debe configurar capa de sockets seguros (SSL) en Microsoft Internet Information Services (IIS). - TransportCredentialOnly: este modo no proporciona integridad y confidencialidad de los mensajes. Proporciona autenticación de cliente basada en HTTP. Este modo debe usarse con precaución. Debe usarse en entornos en los que la infraestructura de WCF proporciona la seguridad de transporte por otros medios (como IPSec) y solo la infraestructura de WCF proporciona la autenticación de cliente. Si selecciona Certificado para la propiedad tipo de credencial de cliente de transporte en este modo de seguridad, el certificado de servicio para esta ubicación de recepción debe proporcionarse a través de la propiedad Certificado de servicio - Huella digital. El valor predeterminado es Ninguno.
   Tipo de credencial de cliente de transporte	Especifique el tipo de credencial que se va a usar al realizar la autenticación de cliente. Entre los valores válidos se incluyen los siguientes: - Ninguno: no se produce ninguna autenticación en el nivel de transporte. - Básico: autenticación básica. En Autenticación básica, los nombres de usuario y las contraseñas se envían en texto sin formato a través de la red. Debe crear las cuentas de usuario de dominio o locales correspondientes a las credenciales. - Digest: autenticación digestiva. Este método de autenticación funciona de forma muy similar a la autenticación básica, salvo que las contraseñas se envían a través de la red como un valor hash para mayor seguridad. La autenticación digest solo está disponible en dominios con controladores de dominio que ejecutan sistemas operativos Windows Server. Debe crear las cuentas de usuario de dominio o locales correspondientes a las credenciales de 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 usuario de dominio o locales correspondientes a las credenciales de cliente. - Windows: autenticación integrada de Windows. Windows Communication Foundation negocia entre Kerberos y NTLM, prefiriendo 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 usuario de dominio o locales correspondientes a las credenciales de cliente. - Certificado: autenticación de cliente mediante el certificado de cliente. La cadena de certificados CA para los certificados X.509 del cliente debe instalarse en el almacén de certificados de entidades de certificación raíz de confianza de este equipo para que los clientes puedan autenticarse en este punto de recepción. Nota: La propiedad del tipo de credencial del cliente de transporte debe coincidir con el esquema de autenticación del directorio virtual de IIS que hospeda esta ubicación de recepción. Por ejemplo, si la propiedad está establecida en Windows, también debe habilitar la autenticación integrada de Windows para el directorio virtual que lo hospeda. Del mismo modo, si la propiedad está establecida en None, debe permitir el acceso anónimo al directorio virtual que hospeda esta ubicación de recepción. El valor predeterminado es Ninguno.
   Tipo de credencial de cliente de mensaje	Especifique el tipo de credencial que se va a usar al realizar la autenticación de cliente mediante la seguridad basada en mensajes. Entre los valores válidos se incluyen los siguientes: - UserName: permita que esta ubicación de recepción requiera que los clientes se autentiquen mediante la credencial UserName . Debe crear las cuentas de usuario de dominio o locales 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 CA para los certificados X.509 del cliente debe instalarse en el almacén de certificados de entidades de certificación raíz de confianza de este equipo para que los clientes puedan autenticarse en este punto de recepción. El valor predeterminado es UserName.
   Conjunto de algoritmos	Especifique el cifrado de mensajes y los algoritmos de encapsulado de claves. Estos algoritmos se asignan a los especificados en la especificación del Lenguaje de Política de Seguridad (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 ajuste 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 ajuste 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 ajuste 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 ajuste 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 ajuste 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 ajuste 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.
   Certificado de servicio:huella digital	Especifique la huella digital del certificado X.509 para esta ubicación de recepción que los clientes usan para autenticar el servicio. Para seleccionar la huella digital, navegue a Mi tienda en la ubicación 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.
   Utilizar inicio de sesión único	Use single Sign-On para recuperar las credenciales de cliente para emitir un vale de SSO. Esta opción solo es válida para las configuraciones de seguridad enumeradas en la sección siguiente, "Compatibilidad de Sign-On única de empresa para el adaptador de recepción de WCF-BasicHttp". Se borra el valor predeterminado.

   Compatibilidad de Sign-On única de empresa 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 credencial de cliente de transporte	Tipo de credencial de cliente de mensaje
   Transporte	Básico	No disponible
   Transporte	Resumen	No disponible
   Transporte	Ntlm	No disponible
   Transporte	Windows	No disponible
   Transporte	Certificado	No disponible
   Mensaje	No disponible	Nombre de usuario
   TransportWithMessageCredential	No disponible	Nombre de usuario
   TransportCredentialOnly	Básico	No disponible
   TransportCredentialOnly	Resumen	No disponible
   TransportCredentialOnly	Ntlm	No disponible
   TransportCredentialOnly	Windows	No disponible
   TransportCredentialOnly	Certificado	No disponible

8. En el cuadro de diálogo Propiedades de transporte deWCF-BasicHttp, en la pestaña Mensajes, especifique cómo seleccionar datos para el elemento Cuerpo SOAP.

   Usa esto	Para
   Sobre- todo <soap:Envelope>	Cree la parte del cuerpo de BizTalk a partir del Envelope SOAP completo de un mensaje entrante. Se borra el valor predeterminado.
   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 de acceso: contenido ubicado por 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 hijo inmediato dentro del elemento Body del mensaje SOAP entrante. Se borra el valor predeterminado.
   Expresión de ruta de acceso del cuerpo	Escriba la expresión del cuerpo del mensaje para identificar una parte específica de un mensaje entrante utilizada para crear la parte del contenido del mensaje de BizTalk. Esta expresión del recorrido del cuerpo se evalúa contra el elemento secundario inmediato del elemento Cuerpo SOAP de un mensaje entrante. Si esta expresión de ruta de acceso del cuerpo devuelve más de un nodo, solo se elige el primer nodo para la parte del cuerpo del mensaje de BizTalk. Esta propiedad es necesaria si se selecciona la opción Ruta: contenido ubicado por la ruta del cuerpo. Tipo: String Longitud mínima: 0 Longitud máxima: 32767 El valor predeterminado es una cadena vacía.
   Codificación de nodos	Especifique el tipo de codificación que usa el adaptador de recepción WCF-BasicHttp para decodificar el nodo identificado por la expresión de ruta de acceso en el cuadro de texto Expresión de ruta de acceso del cuerpo. Esta propiedad es necesaria si se selecciona la opción Ruta-- contenido ubicado por la ruta del cuerpo. Entre los valores válidos se incluyen los siguientes: - Base64: codificación base64. - Hexadecimal: codificación hexadecimal. - Cadena: codificación de cadenas de texto - UTF-8 - XML: Los adaptadores de 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 del mensaje de respuesta de BizTalk	Utilice la parte del cuerpo del mensaje de BizTalk para crear el contenido del elemento Cuerpo SOAP de un mensaje de respuesta saliente. Esta propiedad es válida solo para 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 es válida solo para ubicaciones de recepción de solicitud-respuesta. Se borra el valor predeterminado.
   XML	Escriba la plantilla con formato XML para el contenido del elemento Cuerpo de 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 es válida solo para ubicaciones de recepción de solicitud-respuesta. Tipo: 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 el mensaje de solicitud en caso de error	Especifique si se debe suspender el mensaje de solicitud que produce un error en el procesamiento de entrada debido a un error de canalización de recepción o a un error de enrutamiento. Se borra el valor predeterminado.
   Incluir detalles de excepción en errores	Especifique si se devuelven errores SOAP para facilitar la depuración en caso de fallo. Se borra el valor predeterminado.

Creación del puerto de envío

1. En la consola de administración de BizTalk, cree un 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 deWCF-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 .

   Usa esto	Para
   Dirección (URI)	Obligatorio. Especifique el URI completo para 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 del punto de conexión	Opcional. Especifique la identidad del servicio que espera este puerto de envío. Esta configuración habilita este puerto de envío para autenticar el servicio. En el proceso de enlace entre el cliente y el servicio, la infraestructura de Windows Communication Foundation (WCF) garantizará que la identidad del servicio esperado coincida con los valores de este elemento. Los valores que se pueden especificar para la propiedad Identity difieren según la configuración de seguridad. Se borra el valor predeterminado.
   Acción	Especifique el campo 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.Action 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 la propiedad de contexto BTS.Operation. Por ejemplo, si esta propiedad se establece en el siguiente formato XML y la propiedad BTS.Operation se establece en Op1, el adaptador de envío WCF utiliza 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 la orquestación establecen dinámicamente la propiedad BTS.Operation por el nombre de la operación del puerto. Si los mensajes salientes se enrutan con enrutamiento basado en contenido, puede establecer la propiedad BTS.Operation en los componentes de la canalización. Longitud mínima: 0 Longitud máxima: 32767 El valor predeterminado es una cadena vacía.

4. En WCF-BasicHttp Propiedades de transporte, en la pestaña Vinculación, configure las propiedades de timeout y codificación:

   Usa esto	Para
   Tiempo de espera al abrir (hh:mmss)	Especifique un valor de intervalo de tiempo que indique 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 para el envío (hh:mmss)	Especifique un valor de intervalo de tiempo que indique 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 solicitud-respuesta, este valor especifica un intervalo de tiempo para que se complete toda la interacción, incluso si el servicio devuelve un mensaje grande. Valor predeterminado: 00:01:00 Valor máximo: 23:59:59
   Tiempo de espera de cierre (hh:mmss)	Especifique un valor de intervalo de tiempo que indique 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)	Especifique el tamaño máximo, en bytes, para un mensaje, incluidos los encabezados, que se puede recibir a través del cable. El tamaño de los mensajes está limitado por la cantidad de memoria asignada para 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	Especifique el codificador usado para codificar el mensaje SOAP. Entre los valores válidos se incluyen los siguientes: - Texto: use un codificador de mensajes de texto. - Mtom: Utilice un codificador del mecanismo de transmisión de mensajes 1.0 (MTOM). Valor predeterminado: Texto
   Codificación de texto	Especifique la codificación del conjunto de caracteres que se usará para emitir mensajes en el enlace cuando la propiedad de codificación de mensajes esté establecida en Texto. Entre los valores válidos se 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 deWCF-BasicHttp , en la pestaña Seguridad , defina las funcionalidades de seguridad del puerto de envío de WCF-BasicHttp:

   Usa esto	Para
   Modo de seguridad	Especifique el tipo de seguridad que se usa. Entre los valores válidos se 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 se protegen mediante HTTPS. La cadena de certificados de autoridad de certificación para el certificado X.509 del servicio debe instalarse en el almacén de certificados de Autoridades de Certificación Raíz de Confianza de este equipo para que el servicio pueda autenticar 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 requiere el transporte HTTP. - TransportWithMessageCredential: el transporte HTTPS proporciona integridad, confidencialidad y autenticación del servicio. La cadena de certificados de la Autoridad de Certificación para el certificado X.509 del servicio debe instalarse en el almacén de certificados de Autoridades de Certificación Raíz de Confianza de este equipo para que el servicio pueda autenticarse en el puerto de envío usando el certificado del servicio. La seguridad del mensaje SOAP proporciona la autenticación del puerto de envío. - TransportCredentialOnly: este modo no proporciona integridad y confidencialidad de los mensajes. Proporciona autenticación de cliente basada en HTTP. Este modo debe usarse con precaución. Debe usarse en entornos en los que la infraestructura de WCF proporciona la seguridad de transporte por otros medios (como IPSec) y solo la infraestructura de WCF proporciona la autenticación de cliente. El valor predeterminado es Ninguno.
   Tipo de credencial de cliente de transporte	Especifique el tipo de credencial que se va a usar al realizar la autenticación del puerto de envío. Entre los valores válidos se incluyen los siguientes: - Ninguno: no se produce ninguna autenticación en el nivel de transporte. - Básico: autenticación básica. En Autenticación básica, los nombres de usuario y las contraseñas se envían en texto sin formato a través de la red. Esta opción requiere configurar la propiedad Credenciales de cliente . - Digest: autenticación digestiva. Este método de autenticación funciona de forma muy similar a la autenticación básica, salvo que las contraseñas se envían a través de la red como un valor hash para mayor seguridad. La autenticación digest solo está disponible en dominios con controladores de dominio que ejecutan sistemas operativos Windows Server. Esta opción requiere configurar la propiedad Credenciales de cliente . - Ntlm: autenticación NTLM. La cuenta de usuario con 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 con 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 Ninguno.
   Tipo de credencial de cliente de mensaje	Especifique el tipo de credencial que se va a usar al realizar la autenticación de cliente mediante la seguridad basada en mensajes. Entre los valores válidos se incluyen los siguientes: - UserName: este puerto de envío se autentica en el servicio con una credencial UserName . Para el adaptador de envío de WCF-BasicHttp, no está soportado. - Certificado: Este puerto de envío se autentica a los servicios mediante el certificado de cliente especificado a través de la propiedad Client certificate - Huella digital del cliente. 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	Especifique el cifrado de mensajes y los algoritmos de encapsulado de claves. Estos algoritmos se asignan a los especificados en la especificación del Lenguaje de Política de Seguridad (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 ajuste 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 ajuste 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 ajuste 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 ajuste 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 ajuste 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 ajuste 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.
   Certificado de cliente: huella digital	Especifique la huella digital del certificado X.509 para autenticar este puerto de envío en los 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.
   Certificado de servicio: huella digital	Especifique la huella digital del certificado X.509 para autenticar el servicio al que este puerto de envío envía mensajes. Puede seleccionar la huella digital navegando al almacén Otras personas en la ubicación de Equipo local usando 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	Especifique las credenciales para enviar mensajes. Puede especificar la propiedad haciendo clic en el botón Editar . Esta opción solo es válida para la configuración de seguridad listada en la sección siguiente: "Compatibilidad de empresa única para Sign-On del adaptador de envío de WCF-BasicHttp". El valor predeterminado es No usar inicio de sesión único.
   Información de conexión de Service Bus	Nuevo a partir de BizTalk Server 2016. Elija usar la firma de acceso compartido (SAS) o el servicio de control de acceso (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 muestran en Azure Portal. - Access Control Service : 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 adaptador.

   Compatibilidad de Sign-On única de empresa 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 credencial de cliente de transporte	Tipo de credencial de cliente de mensaje
   Transporte	Básico	No disponible
   Transporte	Resumen	No disponible
   TransportCredentialOnly	Básico	No disponible
   TransportCredentialOnly	Resumen	No disponible
   Mensaje	No disponible	Nombre de usuario
   TransportWithMessageCredential	No disponible	Nombre de usuario

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

   Usa esto	Para
   Utilizar la configuración predeterminada del proxy del controlador	Especifique si este puerto de envío usa la configuración del proxy en el controlador de envío que hospeda este puerto de envío. Esta es la configuración predeterminada.
   No utilizar proxy	Indica si este puerto de envío usa un servidor proxy. Se borra el valor predeterminado.
   Utilizar proxy	Indica si este puerto de envío usa el servidor proxy especificado en la propiedad Address . Se borra el valor predeterminado.
   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 requiere un valor solo si se selecciona Usar proxy . Tipo: String Longitud máxima: 256 El valor predeterminado es una cadena vacía.
   Nombre de usuario	Especifique el nombre de usuario que se va a usar para la autenticación. Si se usa la autenticación integrada, el nombre de usuario incluye el dominio, es decir, domain\username. Si se usa la autenticación básica o Digest, el nombre de usuario no incluye dominio\. Esta propiedad requiere un valor solo si se selecciona Usar proxy . Nota: El adaptador de envío de WCF-BasicHttp utiliza la autenticación básica para el proxy. Tipo: String Longitud mínima: 0 Longitud máxima: 256 El valor predeterminado es una cadena vacía.
   Contraseña	Especifique la contraseña que se va a usar para la autenticación. Esta propiedad requiere un valor solo si se selecciona Usar proxy . Tipo: String Longitud mínima: 0 Longitud máxima: 256 El valor predeterminado es una cadena vacía.

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

   Usa esto	Para
   Cuerpo: cuerpo del mensaje de solicitud de BizTalk	Usa la parte del cuerpo del mensaje de BizTalk para crear el contenido del elemento Cuerpo SOAP para un mensaje que se va a enviar. 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. Se borra el valor predeterminado.
   XML	Escriba la plantilla con formato XML para el contenido del elemento Cuerpo de SOAP de un mensaje saliente. Esta propiedad es necesaria si se selecciona la opción Plantilla- Cuerpo del mensaje de respuesta de BizTalk . Tipo: 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- todo <soap:Envelope>	Cree la parte del cuerpo de BizTalk a partir del Envelope SOAP completo de un mensaje entrante. Esta propiedad solo es válida para puertos de solicitud-respuesta. Se borra el valor predeterminado.
   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 solo es válida para puertos de solicitud-respuesta. Esta es la configuración predeterminada.
   Ruta de acceso: contenido ubicado por 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 hijo inmediato dentro del elemento Body del mensaje SOAP entrante. Esta propiedad solo es válida para puertos de solicitud-respuesta. Se borra el valor predeterminado.
   Expresión de ruta de acceso del cuerpo	Escriba la expresión del cuerpo del mensaje para identificar una parte específica de un mensaje entrante utilizada para crear la parte del contenido del mensaje de BizTalk. Esta expresión de trayectoria del cuerpo se evalúa contra el elemento hijo inmediato del nodo Cuerpo SOAP de un mensaje entrante. Si esta expresión de ruta de acceso del cuerpo devuelve más de un nodo, solo se elige el primer nodo para la parte del cuerpo del mensaje de BizTalk. Esta propiedad es necesaria si se selecciona la opción Ruta-- contenido ubicado por la ruta del cuerpo. Esta propiedad solo es válida para puertos de solicitud-respuesta. Tipo: String Longitud mínima: 0 Longitud máxima: 32767 El valor predeterminado es una cadena vacía.
   Codificación de nodos	Especifique el tipo de codificación que usa el adaptador de envío 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-- contenido ubicado por la ruta del cuerpo. Esta propiedad solo es válida para puertos de solicitud-respuesta. Entre los valores válidos se incluyen los siguientes: - Base64: codificación base64. - Hexadecimal: codificación hexadecimal. - Cadena: codificación de cadenas de texto - UTF-8 - XML: Los adaptadores de 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.
   Propagación del mensaje de error	Active esta casilla para enrutar el mensaje que produce un error en el procesamiento saliente 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 errores y generar una confirmación negativa (NACK). Esta propiedad solo es válida para puertos de solicitud-respuesta. El valor predeterminado está seleccionado.

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 de 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 adaptador, en la pestaña General , seleccione Propiedades.

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

   Usa esto	Para
   Utilizar proxy	Indica si este controlador de envío usa un servidor proxy. Se borra el valor predeterminado.
   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 requiere un valor solo si se selecciona Usar proxy . Tipo: String Longitud máxima: 256 El valor predeterminado es una cadena vacía.
   Nombre de usuario	Especifique el nombre de usuario que se va a usar para la autenticación. Si se usa la autenticación integrada o básica, el nombre de usuario incluye el dominio, es decir, domain\username. Si se usa la autenticación Digest, el nombre de usuario no incluye el dominio. Esta propiedad requiere un valor solo si se selecciona Usar proxy . Tipo: String Longitud mínima: 0 Longitud máxima: 256 El valor predeterminado es una cadena vacía.
   Contraseña	Especifique la contraseña que se va a usar para la autenticación. Esta propiedad requiere un valor solo si se selecciona Usar proxy . Tipo: 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.

   Consulte también

¿Qué son los adaptadores de WCF?

adaptador deSB-Messaging

Uso de adaptadores