É 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:
- BasicHttpBinding
- WsHttpBinding
- NetMsMqBinding apenas para chamadas de uma via
- WSFederationHttpBinding
- WS2007FederationHttpBinding
- NetTcpBinding
- Ligações customizadas que não integram as extensões customizadas no canal, serialização da mensagem, transporte e segurança
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
- Crie um arquivo soaclient.exe.config modificado concluindo as etapas a seguir:
- 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.
- 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"/>
- 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"
- 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.
- Clique no botão da barra de ferramentas Cliente de Serviço Genérico () para abrir o cliente de serviço genérico e clique na guia Transporte.
- Na página Configurações de Transporte, clique em Criar uma Configuração do Microsoft .NET.
- 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.
- 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.