Detalhes da Chamada XML

Os elementos da chamada XML contêm o conteúdo da chamada e as informações de transporte desta chamada. O conteúdo consiste em XML simples transmitido em um transporte HTTP ou JMS. As informações de transporte referem-se às informações necessárias para enviar, receber e responder, dependendo do protocolo selecionado.

Atualizar nome do nó automaticamente: Quando ativada, essa opção atualiza o nome do elemento de chamada XML no conteúdo do teste.
Uma direção: Essa opção especifica que o servidor não espera nenhuma resposta após a chamada. Isso desativa o botão Atualizar Retorno.
Tempo Limite (ms): Esse é o valor de tempo limite em milissegundos. Se nenhuma resposta for recebida depois do tempo especificado, será produzido um erro.
Tempo de Espera (ms): Especifica o tempo de atraso calculado programaticamente que é observado em cada usuário quando esse teste é executado com vários usuários virtuais. O tempo de espera é uma emulação estatística do tempo que os usuários reais gastam lendo ou pensando antes de executar uma ação.
Atualizar Retorno: Abre a janela Visualizar Retorno. Nessa janela, a chamada pode ser feita a partir do ambiente de trabalho para criar ou atualizar o retorno de mensagem que está associado à chamada.

Mensagem

Essas páginas apresentam o conteúdo XML da chamada e fornecem acesso para correlação de dados em três formas diferentes.

Formulário

Esta visualização fornece uma visualização simplificada da mensagem que se focaliza na edição dos valores do conteúdo XML. Use o menu Esquema para ativar a assistência com o conteúdo XML de edição, para que o XML seja válido e cumpra com a especificação XSD.

Na visualização Formulário, inclua os cabeçalhos XML necessários para chamadas de serviço da web padrão. Na barra Cabeçalho, clique em Incluir ( Botão Incluir ) para criar a estrutura do cabeçalho XML padrão para as solicitações WS-Addressing, WS-ReliableMessaging ou WS-Coordination ou clique em Mais para outras normas. É possível ativar ou desativar elementos de cabeçalho XML e especificar os valores corretos de cada elemento XML. As verificações são executadas para garantir que o conteúdo XML seja válido.

Nota: Para incluir cabeçalhos XML nas chamadas em IBM® Security AppScan, inclua um algoritmo Cabeçalhos XML Estáticos na guia Pilha de Solicitações da solicitação.

Árvore

Essa visualização fornece uma visualização hierárquica da estrutura XML da mensagem, incluindo elementos, espaços de nomes e valores associados. Você pode utilizar Incluir, Inserir, Remover, Para Cima e Para Baixo para editar os elementos XML e espaços de nomes na árvore.

Use a coluna Ignorar se vazio para selecionar os elementos XML vazios que você deseja ignorar. Essa coluna é visível somente se você selecionou a caixa de seleção Exibir a coluna 'Ignorar se vazio' no visualizador de árvore XML em Janela > Preferências > Teste > Editor de teste > Teste de serviço.

Clique em Filtrar para ocultar ou mostrar o espaço de nomes, o atributo ou os nós de texto, dependendo de seus requisitos.

Clique em Permitir apenas modificações válidas para possibilitar a edição inteligente com base em um XSD (XML Schema Document) especificado. Para especificar um conjunto de documentos XSD para o ambiente de trabalho, no navegador de teste, clique com o botão direito do mouse no projeto e selecione Propriedades e Catálogo de Esquemas. Desative Permitir apenas modificações válidas se não tiver um XSD ou se quiser ignorar o esquema.

Você pode clicar com o botão direito do mouse em um elemento XML para convertê-lo em um fragmento XML. Isso permite executar a correlação de dados (usar datapools e criar referências) no fragmento XML inteiro em vez de apenas no valor.

Origem

Essa visualização exibe o conteúdo XML de origem da mensagem ou o conteúdo de texto simples. Para formatar conteúdo XML, clique em Formatar texto XML. Para agrupar conteúdo XML em uma única linha, clique em Compactar texto XML em uma única linha. Controles semelhantes estão disponíveis para conteúdo JSON.

Importante: Na visualização Origem, não edite as tags que começam com SoaTag. Se você excluir ou alterar essas tags, qualquer referência e substituição no teste será quebrada. Não é possível recriar essas tags depois de serem excluídas.

Anexos

Essa página lista os anexos MIME anexados à chamada. O conteúdo dessa visualização corresponde à especificação Multipurpose Internet Mail Extension (MIME). Essa página pode ser utilizada para incluir recursos do ambiente de trabalho como anexos MIME e propriedades de alteração.

O ID de Conteúdo é o identificador utilizado pela chamada para referir-se aos anexos. O método de uso desse identificador depende dos requisitos do servidor.

Protocolo

Essa página descreve o protocolo utilizado para enviar a chamada. O protocolo pode ser HTTP ou JMS (Java™ Message Service), a cada mensagem.

HTTP

Essa página possibilita a substituição de configurações HTTP anexadas à chamada em uma configuração HTTP local.

Método

Essa opção possibilita a especificação do método HTTP da chamada XML, entre a seguinte lista de métodos:

POST
GET
PUT
DELETE

Versão

Essa opção possibilita a especificação de HTTP 1.0 ou de HTTP 1.1.

URL

Esse campo possibilita a especificação da URL da chamada XML.

Cabeçalhos

Essa seção possibilita a inclusão de cabeçalhos na chamada. Os cabeçalhos devem ser compatíveis com o método HTTP especificado.

O aplicativo gerencia os seguintes cabeçalhos, os quais não podem ser incluídos:

Agente Usuário
Conexão do Host
Controle de Cache
Pragma
Tipo de Conteúdo
Comprimento do Conteúdo

Cookies

Essa seção possibilita o gerenciamento de cookies. Você pode incluir, editar e remover cookies, além de criar referências.

JMS

Essa página possibilita a inclusão de propriedades de cadeia que estão anexadas à chamada em uma configuração JMS local. Elas serão enviadas como propriedades de mensagem por meio do JMS.

MQ

Essa página possibilita a substituição de configurações anexadas à chamada em uma configuração WebSphere MQ local.

Nome

É o nome que será exibido na chamada de mensagem como um link para essa configuração de protocolo.

Nome do gerenciador de filas

Especifica o nome do gerenciador de filas para o qual você deseja enviar a chamada.

Nome da fila

Especifica o nome da fila gerenciada pelo gerenciador de filas.

Usar gerenciador de filas locais

Especifica se o servidor WebSphere MQ está sendo executado no computador local. Se o servidor estiver localizado em um computador remoto, desmarque essa opção para especificar os detalhes do servidor MQ remoto.

Endereço do gerenciador de filas

Especifica o endereço IP ou o nome do host do servidor MQ remoto.

Porta do gerenciador de filas

Especifica a porta listener do servidor MQ remoto.

Canal do cliente

Especifica o canal de modo de conexão do servidor do gerenciador de filas remotas.

Utilizar fila temporária

Especifica se o servidor MQ criará uma fila temporária. Se selecionada, a fila temporária será criada com o propósito exclusivo de receber mensagens específicas e, em seguida, será excluída.

Nome da fila

Se Utilizar fila temporária estiver desmarcada, essa opção especificará o nome da fila em que os retornos de mensagens do servidor MQ serão recebidos. O gerenciador de filas especificado em Nome do gerenciador de filas deve gerenciar essa fila.

Os retornos de chamadas e de mensagens são associados pelo ID de correlação na mensagem MQ, o que significa que a configuração do relatório da mensagem é configurado como MQC.MQRO_COPY_MSG_ID_TO_CORREL_ID. O servidor deve seguir essa restrição. Isso fornece suporte ao transporte de recursos SOAP fornecidos pelo WebSphere MQ.

Serviço de destino

Esta opção é para utilizar o Microsoft .NET com o transporte IBM WebSphere MQ para o recurso SOAP. Ela especifica o nome do arquivo ASPX no diretório listener .NET.

Utilizar o Cabeçalho RFH2

Especifica se as mensagens SOAP utilizam um cabeçalho RFH2, que utiliza um formato de mensagem MQ predeterminado. Quando selecionado, outras opções do Descritor de Mensagens ficam desativadas. Utilize essa opção para o transporte do WebSphere MQ para recursos SOAP. Se você estiver utilizando a ligação WID (WebSphere Integration Developer) MQ, ela reconhecerá mensagens com ou sem o cabeçalho RFH2.

Descritor de Mensagens

Essa seção possibilita a configuração de campos da chamada de mensagem. É possível substituir um subconjunto do descritor de mensagens do MQ por um formato customizado para ser utilizado com outros tipos de servidores, especificamente ao utilizar uma chamada de mensagem XML. Consulte a documentação do WebSphere MQ para obter detalhes sobre os descritores de mensagens.

Utilizar fila temporária

Essa seção possibilita a especificação de um nome de usuário e de uma senha para autenticação básica no servidor de aplicativos.

Conexão SSL

Selecione essa opção para utilizar uma configuração de SSL se uma configuração Canal do Cliente referir-se a um canal seguro. Clique em Abrir Editor de SSL para criar uma nova configuração de SSL ou em Alterar para alterar a configuração de SSL associada ao teste atual.

Se o WSDL (Web Services Description Language) utilizado para criar a chamada de mensagem utilizar um JMS URI suportado para apontar para o servidor WebSphere MQ, a configuração de SSL será criada automaticamente. Se o gerador de teste não puder criar a configuração de SSL, uma nova deverá ser criada manualmente.

Se o WSDL tiver sido gerado com o serviço WebSphere MQ (amqwdeployWMService), edite o WSDL para alterar a ligação de transporte de HTTP para JMS para evitar que o gerador de teste produza uma configuração HTTP.

Conjunto de criptografia

Especifique o conjunto de criptografia que será utilizado na configuração do canal.

Segurança XML Local

Essa página permite a inclusão de um algoritmo de segurança customizado implementado em uma classe Java. Algoritmos customizados podem ser aplicados para o conteúdo XML enviado para e recebido do servidor.

Incluir, Inserir, Remover, Para Cima e Para Baixo

Esses botões permitem a criação de uma pilha de algoritmos de segurança. Cada algoritmo é aplicado à pilha sequencialmente. Clique em Incluir para incluir um algoritmo de segurança customizado.

Ferramentas

Esse botão permite a alteração do modo de exibição da pilha de algoritmos.

Algoritmo de Segurança Customizado

Após a inclusão de um algoritmo de segurança customizado na pilha. Essa janela possibilita a especificação da classe Java que implementa o algoritmo. A classe Java utiliza a seguinte interface:

/**
* ***************************************************************
* Confidencial IBM
* 
* (c) Copyright IBM Corporation. 2008. Todos os Direitos Reservados.
* 
* O código fonte deste programa não é publicado ou, por outro lado,
* privado de seus segredos comerciais, independentemente do que tenha sido
* consolidado no Copyright Office dos Estados Unidos.
* *************************************************************** 
* 
*/

package com.ibm.rational.test.lt.models.wscore.datamodel.security.xmlsec;

import java.util.Properties;
import org.w3c.dom.Document;


public interface ICustomSecurityAlgorithm {
	
	/**
	 * Os seguintes métodos podem ser utilizados nos dois casos:
	 * Execução no ambiente de trabalho e execução do teste.
	 */
	
	
	/**
	 * Chamado para processar o Documento enviado por meio de transporte.
	 * @param subject
	 */
	void process(Document subject);
	/**
	 * Chamado para cancelar o processo de um documento recebido de um servidor.
	 * @param subject
	 */
	void unProcess(Document subject);
	
	/**
	 * Propriedades definidas na UI do CustomSecurityAlgorithm.
	 * @param map
	 */
	void setProperties(Properties map);
	
	/**
	 * Os métodos a seguir podem ser utilizados apenas com relação a difusão para testar a interface de serviço,
	 * ou com relação a acesso das informações XML anteriores, quando o jar que contém
	 * o algoritmo de segurança customizado é implementado no projeto de teste de desempenho. Nesse
	 * caso, não é possível utilizar o algoritmo diretamente do ambiente de trabalho.
	 */
	
	/**
	 * Esse objeto corresponde ao objeto ITestExecutionService.
	 * Isso aplica-se apenas a um algoritmo que deva ser vinculado à execução do teste.
	 * Se você planeja utilizar esse objeto, precisará implementar o jar que contém a
	 * implementação em seu projeto de teste de desempenho e não diretamente no JRE.
	 * 
	 * No caso de precisar do documento XML anterior recebido da execução, você poderá 
	 * obter o valor utilizando:
	 * IDataArea area = ((ITestExecutionService)executionObject).findDataArea(IDataArea.VIRTUALUSER);
	 *String previousXML = (String) area.get("PREVIOUS_XML"); //$NON-NLS-1$
	 * 
	 */
	void setExecutionContext(Object executionObject);

O método process modifica o XML antes de ele ser enviado ao servidor.
O método unprocess modifica o XML depois de ele ser recebido do servidor.
O método setProperties recupera as propriedades definidas no editor de segurança dessa interface de segurança customizada.
O método setExecutionContext é chamado durante o teste com o objeto ITestExecutionServices correspondente à mensagem, utilizando essa interface de segurança customizada.

Nome da Classe de Algoritmo de Segurança Customizado: Especifica a classe que implementa o algoritmo de segurança. Clique em Procurar Classe para selecionar uma classe no espaço de trabalho.
Nome do Algoritmo: Especifica um nome para o algoritmo atual.
Propriedades: Essa lista especifica as propriedades utilizadas pelo método setProperties no algoritmo. Utilize Incluir, Remover ou Editar para criar a lista de propriedades.

Feedback