Creación de configuraciones de transporte de Microsoft .NET

Puede crear manualmente una configuración de transporte de Microsoft . NET para describir los valores de transporte para las solicitudes de servicio que utilizan el protocolo de Windows Communication Foundation (WCF).

Antes de empezar

Si utiliza seguridad de SOAP, asegúrese de que ha configurado el entorno con las bibliotecas y los archivos de configuración correctos.

Los certificados y bibliotecas necesarios para el proxy de cliente de Microsoft deben estar instalados en el sistema, incluidas las bibliotecas de Microsoft. NET.

Debe enlazar una versión modificada del archivo de configuración del cliente de proxy de Microsoft del servicio WCF (de forma predeterminada client.exe.config) para la configuración de transporte de Microsoft .NET. Debe cambiar el nombre del archivo a soaclient.exe.config y editarlo tal como se describe en el siguiente procedimiento.

Consejo: Puede crear una configuración de transporte de Microsoft .NET de forma automática importando el archivo WSDL de Microsoft .NET. En este caso, deberá editar manualmente la configuración de transporte de Microsoft .NET para que apunte al archivo soaclient.exe.config modificado tal como se describe en el procedimiento siguiente. Para obtener más información, consulte Envío de solicitudes de servicio con archivos WSDL

Acerca de esta tarea

El producto da soporte a las pruebas de servicios WCF que utilizan los siguientes enlaces:

BasicHttpBinding
WsHttpBinding
NetMsMqBinding solo para llamadas unidireccionales
WSFederationHttpBinding
WS2007FederationHttpBinding
NetTcpBinding
Enlaces personalizados que no integran extensiones personalizadas en el canal, la serialización del mensaje, el transporte y la seguridad

Nota: No se admiten los siguientes servicios WCF:

Transacción y ámbitos
Solicitudes de modalidad dúplex como, por ejemplo, devoluciones de llamada o servicios bidireccionales basados en el transporte de Microsoft Message Queuing (MS-MQ)

Únicamente para usuarios de IBM AppScan

Para utilizar el cliente de servicio genérico con IBM Appscan para probar una aplicación WCF, añada el siguiente código al archivo de configuración WCF:

<system.diagnostics>    <trace autoflush="true" />   
      <sources>      <source name="System.Net"
      maxdatasize="1048576"><listeners><add
    name="System.Net"/></listeners></source>      <source
      name="System.Net.Cache"><listeners><add
      name="System.Net"/></listeners></source>      <source
      name="System.Net.Http"><listeners><add name="System.Net
      "/></listeners></source>      <source
      name="System.Net.Sockets"><listeners><add
      name="System.Net"/></listeners></source>      <source
      name="System.Net.WebSockets"><listeners><add
      name="System.Net"/></listeners></source>    </sources>   
      <sharedListeners>      <add
    name="System.Net"          
      type="IBM.ServiceModel.Soa.Extension.tools.TrafficTraceListener,
      Soa-Behavior-Library"          
    initializeData=""       />   
    </sharedListeners>    <switches>      <add name="System.Net"
      value="All"/>      <add name="System.Net.Cache"
    value="All"/>      <add name="System.Net.Http"
    value="All"/>      <add name="System.Net.Sockets"
    value="All"/>      <add name="System.Net.WebSockets"
    value="All"/>    </switches></system.diagnostics>

IBM Appscan espera únicamente solicitudes HTTP en WCF. Se da soporte a los siguientes enlaces HTTP:

BasicHttpBinding
Custombinding por encima de httpTransport estándar
WsHttpBinding
WsFederationHttpBinding
WS2007FederationHttpBinding

Además, también se da soporte a los siguientes patrones:

Valor de acción (obligatorio)
Valor de acción de respuesta (obligatorio )
Nivel de protección

Procedimiento

Cree un archivo soaclient.exe.config modificado siguiendo estos pasos:
1. Crear una copia del archivo client.exe.config (o proxy_client_name.config) del proyecto de Microsoft .NET y cambie el nombre de la copia a soaclient.exe.config.
2. Edite el archivo soaclient.exe.config para que utilice la versión de Microsoft. NET que admite el producto, tal como se especifica en la línea siguiente:
```
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0"/>
```
3. Edite el archivo soaclient.exe.config para que los puntos finales del archivo de configuración apunten al contrato de cliente del producto, tal como se especifica en la línea siguiente:
```
contract="IBM.ServiceModel.Soa.Extension.Stub.IStubTest"
```
4. Importe el archivo soaclient.exe.config modificado al espacio de trabajo.
Después de crear el archivo soaclient.exe.config, puede saltarse los pasos siguientes e importar el archivo WSDL para crear automáticamente una configuración de transporte de Microsoft .NET en función de la información proporcionada por el WSDL. Para obtener más información, consulte el apartado Envío de solicitudes de servicio con archivos WSDL.
Pulse en el botón de la barra de herramientas Cliente de servicio genérico () para abrir el cliente de servicio genérico y pulse en el separador Transporte.
En la página Configuraciones de transporte, pulse Crear una configuración de Microsoft .NET.
Escriba un nombre para la nueva configuración de transporte y especifique las opciones siguientes:
Ubicación de soaclient.exe.config

Especifique la ubicación del archivo soaclient.exe.config. Debe crear este archivo de forma manual, copiando y editando el archivo client.exe.config del servicio de Microsoft .NET.

Autenticación de usuarios

Si el servicio requiere autenticación, seleccione Autenticación de usuario y escriba el nombre de usuario y la contraseña para acceder al servicio.

Protección de punto final
De forma predeterminada, la configuración de transporte utiliza el nivel de protección de punto final que se describe en el archivo soaclient.exe.config. Utilice este valor para especificar otro nivel de protección:
- Firma: seleccione esta opción para firmar digitalmente solicitudes.
- Cifrado y firma: seleccione esta opción para firmar digitalmente y cifrar solicitudes.
Propiedades avanzadas

Utilice esta tabla para obtener una lista de acciones de solicitud y respuesta por orden de métodos en el archivo WSDL. Pulse Añadir para especificar el nombre y el valor de las acciones de solicitud y respuesta solicitadas por el servicio. Esta tabla se genera automáticamente cuando se importa un archivo WSDL de Microsoft .NET.
Pulse Aceptar para crear la nueva configuración de transporte.

Qué hacer a continuación

Después de crear la configuración, puede utilizarla con cualquier llamada de servicio que utilice el protocolo de transporte de Microsoft .NET. Puede utilizar la lista de Configuraciones en el cliente de servicio genérico para editar las configuraciones existentes o para crear nuevas configuraciones duplicadas.

Comentarios