Criando Configurações de Transporte do Microsoft .NET

É possível criar manualmente uma configuração de transporte do Microsoft .NET para descrever as configurações de transporte para solicitações de serviço que usam o protocolo Windows Communication Foundation (WCF).

Antes de Iniciar

Se você estiver usando a segurança SOAP, assegure-se de que o ambiente esteja configurado com as bibliotecas e arquivos de configuração corretos.

Os certificados e bibliotecas necessários para o proxy de cliente da Microsoft devem ser instalados no computador, incluindo as bibliotecas do Microsoft .NET.

Você deve vincular uma versão modificada do arquivo de configuração de proxy de cliente da Microsoft do serviço WCF (por padrão client.exe.config) à configuração de transporte do Microsoft .NET. Você deve renomear o arquivo para soaclient.exe.config e editá-lo, conforme descrito no procedimento a seguir.

Dica: É possível criar uma configuração de transporte do Microsoft .NET automaticamente importando o arquivo WSDL do Microsoft .NET. Neste caso, você ainda deve editar manualmente a configuração de transporte do Microsoft .NET para apontar para o arquivo soaclient.exe.config modificado, conforme descrito no procedimento a seguir. Para obter informações adicionais, consulte Enviando Solicitações de Serviço com Arquivos WSDL

Sobre Esta Tarefa

O produto suporta os serviços WCF de teste que usam as ligações a seguir:
Nota: Os serviços WCF a seguir não são suportados:
  • Transação e escopos
  • Solicitações no modo duplex, como retornos de chamada ou serviços de 2 vias com base no transporte do Microsoft Message Queuing (MS-MQ)
Para usar o Cliente de serviço genérico com o IBM Appscan para testar um aplicativo WCF, inclua o código a seguir no arquivo de configuração do 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>
O IBM Appscan espera apenas solicitações de HTTP no WCF. As ligações HTTP a seguir são suportadas:
  • BasicHttpBinding
  • Custombinding above standard httpTransport
  • WsHttpBinding
  • WsFederationHttpBinding
  • WS2007FederationHttpBinding
Além disso, os padrões a seguir são suportados:
  • Valor de ação (obrigatório)
  • Valor de ação de resposta (obrigatório)
  • Nível de Proteção

Procedimento

  1. Crie um arquivo soaclient.exe.config modificado concluindo as etapas a seguir:
    1. Crie uma cópia do arquivo client.exe.config (ou proxy_client_name.config) a partir do projeto do Microsoft .NET e renomeie a cópia para soaclient.exe.config.
    2. Edite o arquivo soaclient.exe.config para usar a versão do Microsoft .NET que o produto suporta, conforme especificado na linha a seguir:
      <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0"/>
    3. Edite o arquivo soaclient.exe.config, para que os terminais no arquivo de configuração apontem para o contrato de cliente do produto, conforme especificado na linha a seguir:
      contract="IBM.ServiceModel.Soa.Extension.Stub.IStubTest"
    4. Importe o arquivo soaclient.exe.config modificado na área de trabalho.
    Após criar o arquivo soaclient.exe.config, é possível ignorar as etapas a seguir e importar o arquivo WSDL para criar automaticamente uma configuração de transporte do Microsoft .NET com base nas informações fornecidas pelo WSDL. Para obter informações adicionais, consulte Enviando Solicitações de Serviço com Arquivos WSDL.
  2. Clique no botão da barra de ferramentas Cliente de Serviço Genérico (Abrir o cliente de serviço genérico) para abrir o cliente de serviço genérico e clique na guia Transporte.
  3. Na página Configurações de Transporte, clique em Criar uma Configuração do Microsoft .NET.
  4. Digite um nome para uma nova configuração de transporte e especifique as opções a seguir:
    Local de soaclient.exe.config
    Especifique o local do arquivo soaclient.exe.config. Você deve criar esse arquivo manualmente copiando e editando o arquivo client.exe.config a partir do serviço do Microsoft .NET.
    Autenticação do usuário
    Se o serviço exigir autenticação, selecione Autenticação do Usuário e digite o nome de usuário e senha para acessar o serviço.
    Proteção do terminal
    Por padrão, a configuração de transporte usa o nível de proteção de terminal descrito no arquivo soaclient.exe.config. Use esta configuração para especificar um Nível de Proteção diferente:
    • Assinatura: selecione essa opção para assinar solicitações digitalmente.
    • Criptografia e Assinatura: selecione essa opção para assinar e criptografar solicitações digitalmente.
    Propriedades avançadas
    Use esta tabela para listar as ações de solicitação e resposta pela ordem dos métodos no arquivo WSDL. Clique em Incluir para especificar o nome e o valor de ações de solicitação e resposta que são necessárias para o serviço. Esta tabela será gerada automaticamente ao importar um arquivo WSDL do Microsoft .NET.
  5. Clique em OK para criar a configuração de transporte.

O que Fazer Depois

Após criar a configuração, é possível usá-la com qualquer chamada de serviço que usa o protocolo de transporte do Microsoft .NET. Você pode utilizar a lista Configurações no cliente de serviço genérico para editar as configurações existentes ou criar configurações duplicadas.

Feedback