Leer en inglés

Compartir a través de


Adaptador WCF-WebHttp

Microsoft BizTalk Server usa el adaptador WCF-WebHttp para enviar mensajes a los servicios RESTful. El adaptador de envío WCF-WebHttp envía mensajes HTTP a un servicio desde un mensaje de BizTalk. La ubicación de recepción recibe los mensajes de un servicio de RESTful. Para la solicitud GET y DELETE, el adaptador no usa ninguna carga. Para las solicitudes POST y PUT, el adaptador usa la parte del cuerpo del mensaje de BizTalk para el contenido/carga de HTTP.

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.

Creación de una 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.

  1. 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.

  2. 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.

  3. 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.

  4. En el cuadro de diálogo Propiedades de la ubicación de recepción , en la sección Transporte , seleccione WCF-WebHttp en la lista desplegable Tipo y, a continuación, haga clic en Configurar para configurar las propiedades de transporte de la ubicación de recepción.

  5. En la pestaña General , configure la dirección del punto de conexión para la interfaz REST desde donde se recibe el mensaje.

    Use Para hacer esto
    Dirección (URI) Necesario. Especifique el URI en el que BizTalk Server puede recibir mensajes RESTful basados en HTTP.
    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.
    Asignación de URL y método HTTP La asignación de operación BTS permite a los usuarios asignar solicitudes HTTP entrantes a operaciones BTS en el contexto del mensaje, en función del método HTTP entrante y la subdirección URL. El método HTTP entrante y la subruta de acceso a la dirección URL se comparan con un conjunto de métodos HTTP y la plantilla de URI. Si se encuentra alguna coincidencia, el adaptador promueve la propiedad BTS.Operation al contexto del mensaje de BizTalk con el valor especificado en el mensaje.

    Es posible especificar el método HTTP para la asignación de URL con un formato único o un formato de múltiples asignaciones. El formato de asignaciones múltiples tiene el aspecto siguiente:

    <BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/12345</BtsHttpUrlMapping>

    En el fragmento anterior, observe que el identificador de cliente se proporciona como un valor constante, que es 12345. Sin embargo, podrían existir situaciones en las que el identificador de cliente, o cualquier otra variable de consulta, debe determinarse en el tiempo de ejecución. Para permitir este tipo de situaciones, deberá proporcionar el componente variable de la dirección URL entre llaves { }. Por ejemplo, en el fragmento anterior, si especifica el identificador de cliente como una variable, tendría el aspecto siguiente:

    <BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/{ID}</BtsHttpUrlMapping>

    En dicho caso, también deberá especificar de dónde debe obtenerse el valor de la variable ID en el tiempo de ejecución. Para ello, se usa Asignaciones de variables.

    Nota
    Dentro del campo URL, los caracteres XML especiales deben ser "escape". Esto garantiza que el puerto procesa y conserva los caracteres XML especiales. Por ejemplo, el & carácter especial debe ser de escape como &amp;.

    De:
    Url=”/Customer?{ID}& group=Location”
    A:
    Url=”/Customer?{ID}&amp;group=Location”
    Asignaciones de variables Si especificó variables para la asignación de direcciones URL del método HTTP, deberá especificar los elementos a los que se asignan las variables en el tiempo de ejecución. Haga clic en el botón Editar para iniciar el cuadro de diálogo Asignaciones de variables . En la columna Variable , el cuadro de diálogo indica las variables definidas para Método HTTP y asignación de direcciones URL. En el campo Nombre de propiedad , deberá especificar el nombre de la propiedad que proporciona el valor que debe asociarse a la variable. Debe haber definido o promocionado esta propiedad como parte de la solución. También debe proporcionar el espacio de nombres de la propiedad en el campo Espacio de nombre de propiedad .
  6. 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-WebHttp usa la clase WebHttpBinding en el modo de transferencia con búfer para comunicarse con un extremo. Para el modo de transferencia almacenado en búfer, la propiedad WebHttpBinding.MaxBufferSize siempre es igual al valor de esta propiedad.

    Valor predeterminado: 65536

    Valor máximo: 2147483647
    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 la pestaña Seguridad , defina las funcionalidades de seguridad de la ubicación de recepción del WCF-WebHttp.

    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).

    - 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 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.

    NotaLa propiedad Tipo de credencial de 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 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 Windows.
    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.
  8. En la pestaña Comportamiento , especifique diferentes comportamientos en el nivel de servicio y en el nivel de punto de conexión. Estos comportamientos se basan en las clases de .NET Framework.

    Use Para hacer esto
    ServiceBehavior Amplíe la funcionalidad del servicio WCF en el nivel de servicio. Puede agregar extensiones que realicen diferentes acciones, como definir la configuración de seguridad, habilitar la depuración, implementar la limitación y usar otras clases de .NET.

    Seleccione ServiceBehavior y Agregar extensión. En la lista se muestran las clases de .NET que se pueden usar.
    EndpointBehavior Amplíe la funcionalidad de cómo se reciben las solicitudes en el nivel de punto de conexión. Puede agregar extensiones que realicen diferentes acciones, como recibir solicitudes HTTP de un cliente de AJAX ASP.NET basado en explorador, especificar un intervalo de tiempo en las transacciones, elegir recibir mensajes de forma sincrónica o asincrónica y usar otras clases de .NET.

    Seleccione EndpointBehavior y Agregar extensión. En la lista se muestran las clases de .NET que se pueden usar.

    Esto es similar a la configuración de comportamiento de una ubicación de recepción de WCF-Custom. Consulte el cuadro de diálogo Propiedades de transporte personalizado de WCF, la pestaña Recibir, Comportamiento en la guía de la interfaz de usuario y en la referencia del espacio de nombres de la API de desarrolladores.

  9. En la pestaña Mensajes , especifique la selección de datos para el elemento Cuerpo soap.

    Use Para hacer esto
    Encabezados HTTP salientes Especifica los encabezados HTTP con los que se marcará el mensaje de respuesta, si corresponde.
    Deshabilitar ubicación en caso de error Especificar si se va a deshabilitar la ubicación de recepción cuyo procesamiento de entrada no se puede realizar correctamente debido a un error de canalización de recepción o de enrutamiento.

    El valor predeterminado es desactivada.
    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.
  10. Haga clic en OK.

  11. 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

  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. Consulte How to Create a Send Port (Cómo crear un puerto de envío). Configure todas las opciones de puerto de envío y especifique WCF-WebHttp 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 .

  3. En la pestaña General , configure la dirección del punto de conexión para la interfaz REST donde se envía el mensaje.

    Use Para hacer esto
    Dirección (URI) Necesario. Especifique la URI de la interfaz REST donde se envía el mensaje.
    Identidad de extremo Opcional. Especifique la identidad del extremo. Esta configuración permite al extremo autenticar el puerto de envío. 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.
    Asignación de URL y método HTTP La asignación de operación BTS permite a los usuarios asignar solicitudes HTTP entrantes a operaciones BTS en el contexto del mensaje, en función del método HTTP entrante y la subdirección URL. El método HTTP entrante y la subruta de acceso a la dirección URL se comparan con un conjunto de métodos HTTP y la plantilla de URI. Si se encuentra alguna coincidencia, el adaptador promueve la propiedad BTS.Operation al contexto del mensaje de BizTalk con el valor especificado en el mensaje.

    Es posible especificar el método HTTP para la asignación de URL con un formato único o un formato de múltiples asignaciones. El formato de asignaciones múltiples tiene el aspecto siguiente:

    BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/12345" /> </BtsHttpUrlMapping>

    En el fragmento anterior, observe que el identificador de cliente se proporciona como un valor constante, que es 12345. Sin embargo, podrían existir situaciones en las que el identificador de cliente, o cualquier otra variable de consulta, debe determinarse en el tiempo de ejecución. Para permitir este tipo de situaciones, deberá proporcionar el componente variable de la dirección URL entre llaves { }. Por ejemplo, en el fragmento anterior, si especifica el identificador de cliente como una variable, tendría el aspecto siguiente:

    <BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/{ID}" /> </BtsHttpUrlMapping>

    En dicho caso, también deberá especificar de dónde debe obtenerse el valor de la variable ID en el tiempo de ejecución. Para ello, se usa Asignaciones de variables.

    Nota
    Dentro del campo URL, los caracteres XML especiales deben ser "escape". Esto garantiza que el puerto procese y conserve los caracteres XML especiales. Por ejemplo, el & carácter especial debe ser de escape como &amp;.

    De:
    Url=”/Customer?{ID}& group=Location”
    A:
    Url=”/Customer?{ID}&amp;group=Location”
    Asignaciones de variables Si especificó variables para la asignación de direcciones URL del método HTTP, deberá especificar los elementos a los que se asignan las variables en el tiempo de ejecución. Haga clic en el botón Editar para iniciar el cuadro de diálogo Asignaciones de variables . En la columna Variable , el cuadro de diálogo indica las variables definidas para Método HTTP y asignación de direcciones URL. En el campo Nombre de propiedad , deberá especificar el nombre de la propiedad que proporciona el valor que debe asociarse a la variable. Debe haber definido o promocionado esta propiedad como parte de la solución. También debe proporcionar el espacio de nombres de la propiedad en el campo Espacio de nombre de propiedad .
  4. 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-WebHttp usa la clase WebHttpBinding en el modo de transferencia con búfer para comunicarse con un extremo. Para el modo de transferencia almacenado en búfer, la propiedad WebHttpBinding.MaxBufferSize siempre es igual al valor de esta propiedad.

    Valor predeterminado: 65536

    Valor máximo: 2147483647
  5. En la pestaña Seguridad , defina las funcionalidades de seguridad del puerto de envío de WCF-WebHttp.

    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.
    - 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 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 Windows.
    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 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 . 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 el 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 siguientes valores para autenticarse con Service Bus. Esto solo es necesario al invocar una interfaz REST para las entidades relacionadas con Service Bus.

    - 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 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.
  6. En la pestaña Comportamiento , configure el comportamiento del punto de conexión para este puerto de envío.

    Use Para hacer esto
    EndpointBehavior Amplíe la funcionalidad de cómo se envían las solicitudes en el nivel de punto de conexión. Puede agregar extensiones que realicen diferentes acciones, como definir el comportamiento de procesamiento soap, especificar un intervalo de tiempo en las transacciones, controlar la funcionalidad de detección y usar otras clases de .NET.

    Seleccione EndpointBehavior y Agregar extensión. En la lista se muestran las clases de .NET que se pueden usar.

    La configuración es similar a la del comportamiento del extremo para un puerto de envío WCF-Custom. Consulte la pestaña Propiedades de transporte personalizadas de WCF, Enviar, Comportamiento en la guía de la interfaz de usuario y en la referencia del espacio de nombres de la API de desarrolladores.

  7. En la pestaña Proxy , configure el valor de proxy para el puerto de envío de WCF-WebHttp.

    Use Para hacer esto
    Usar la configuración de proxy del 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 WCF-WebHttp 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.
  8. En la pestaña Mensajes , especifique cómo se envía el mensaje a la interfaz REST.

    Use Para hacer esto
    Encabezados HTTP salientes Especifica los encabezados HTTP con los que se marcará el mensaje de respuesta, si corresponde.
    Suprimir el cuerpo para verbos Según el verbo que use para invocar un extremo REST, es posible que necesite o no necesite una carga de mensaje. Por ejemplo, es posible que no necesite una carga de mensaje mientras usa los verbos GET o DELETE. Sin embargo, para activar una llamada al extremo REST mediante el puerto de envío, puede usar un mensaje ficticio que incluya una carga de mensaje. Antes de que el mensaje se envíe al extremo REST, se deberá quitar la carga de mensaje del mensaje ficticio. Puede especificar los verbos para los que se debe quitar la carga del mensaje mediante la propiedad Suprimir cuerpo para verbos .

    Por ejemplo, si desea quitar la carga del mensaje mientras usa un verbo GET, especifique el valor de esta propiedad como GET.
  9. Haga clic en Aceptar y en Aceptar de nuevo para guardar la configuración.

Importación de extensiones de WCF

Importe las extensiones de WCF en el controlador de recepción o en el controlador de envío:

  1. En la administración de BizTalk Server, expanda administración BizTalk Server, expanda Grupo de BizTalk, configuración de la plataforma y, a continuación, adaptadores.

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

  3. En la pestaña General, seleccione Propiedades.

  4. En Extensiones de WCF, seleccione Importar y vaya al archivo de configuración de la extensión WCF.

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 BizTalk Server Administración, expanda Grupo de BizTalk, configuración de plataforma y, a continuación, expanda Adaptadores.

  2. Seleccione WCF-WebHttp y, a continuación, seleccione 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 requiere un valor solo 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.

Consulte también

Adaptador de SB-Messaging

Uso de adaptadores

¿Qué son los adaptadores de WCF?