Detalles de llamada XML

Los elementos de llamadas XML contienen el contenido de la llamada y la información de transporte para dicha llamada. El contenido consta de XML sin formato que se transmite por medio de un transporte HTTP o JMS. La información de transporte hace referencia a la información que se necesita para enviar y recibir, así como para responder, en función del protocolo seleccionado.

Actualizar nombre de nodo automáticamente: Cuando se habilita, esta opción actualiza el nombre del elemento de llamada XML en el contenido de la prueba.
Un método: Esta opción especifica que no se espera ninguna respuesta del servidor después de la llamada. Inhabilita el botón Actualizar retorno.
Tiempo de espera excedido (ms): Valor de tiempo de espera excedido en milisegundos. Si no se recibe ninguna respuesta una vez transcurrido el tiempo especificado, se produce un error.
Tiempo de reflexión (ms): Especifica el retardo de tiempo calculado de forma programática que se observa para cada usuario cuando esta prueba se ejecuta con varios usuarios virtuales. El tiempo de reflexión es una emulación estadística de la cantidad de tiempo que los usuarios reales pasan leyendo o pensando antes de realizar una acción.
Actualizar retorno: Abre la ventana Vista previa de retorno. En esta ventana puede invocar la llamada desde el entorno de trabajo para crear o actualizar el retorno de mensaje que se ha asociado a la llamada.

Mensaje

En estas páginas se presenta el contenido XML de la llamada y se proporciona acceso a la correlación de datos de tres formas diferentes.

Formulario

Esta vista proporciona una vista simplificada del mensaje centrada en editar los valores del contenido XML. Utilice el menú Esquema para habilitar la ayuda para editar contenido XML para que el XML sea válido y cumpla con la especificación XSD.

En la vista Formulario, añada las cabeceras XML necesarias para las llamadas de servicio estándar. En la barra Cabecera, pulse Añadir ( botón Añadir ) para crear la estructura de la cabecera XML predeterminada para solicitudes WS-Addressing, WS-ReliableMessaging o WS-Coordination, o pulse Más para otros estándares. Puede habilitar o inhabilitar los elementos de la cabecera XML y especificar los valores correctos para cada elemento XML. Se realizan comprobaciones para garantizar que el contenido XML es válido.

Nota: Para añadir cabeceras XML a llamadas en IBM® Security AppScan, añada un algoritmo de Cabecera XML estática en el separador Pila de solicitud de la solicitud.

Árbol

Esta vista proporciona una vista jerárquica de la estructura XML del mensaje, incluidos los elementos, los espacios de nombres y los valores asociados. Puede utilizar Añadir, Insertar, Eliminar, Arriba y Abajo para editar los elementos y espacios de nombres XML en el árbol.

Utilice Saltar si está vacío para seleccionar los elementos XML vacíos que desea saltarse. Esta columna sólo es visible si ha seleccionado el recuadro de selección Visualizar la columna 'Saltar si está vacío' en el visualizador de árbol XML en Ventana > Preferencias > Prueba > Editor de pruebas > Prueba de servicio.

Pulse Filtro para ocultar o mostrar espacios de nombres, atributos o nodos de texto, en función de sus requisitos.

Pulse Permitir sólo modificaciones válidas para habilitar la edición inteligente, basada en un XSD (documento de esquema XML) especificado. Para especificar un conjunto de documentos XSD para el entorno de trabajo, en el Navegador de pruebas, pulse con el botón derecho del ratón sobre el proyecto y seleccione Propiedades y Catálogo de esquemas. Inhabilite Permitir sólo modificaciones válidas si no tiene ningún XSD o si desea omitir el esquema.

Puede pulsar con el botón derecho del ratón sobre un elemento XML para convertirlo en un fragmento XML. Esto le permite realizar una correlación de datos (utilizar agrupaciones de datos y crear referencias) en todo el fragmento de XML en lugar de sólo en el valor.

Origen

En esta vista se muestra el contenido XML de origen del mensaje o el texto sin formato. Para formatear contenidos XML, pulse Formatear texto XML. Para recalcular contenido XML en una sola línea, pulse Empaquetar texto XML para una sola línea. Controles similares están disponibles para contenidos JSON.

Importante: En la vista Origen, no edite los códigos que empiecen por SoaTag. Si suprime o cambia estos códigos, cualquier referencia y sustitución de la prueba se cancelará. No puede volver a crear estos códigos una vez que los haya suprimido.

Accesorios

En esta página se listan los accesorios MIME que se han adjuntado a la llamada. El contenido de esta vista corresponde a la especificación de MIME (Multipurpose Internet Mail Extensions). Puede utilizar esta página para añadir recursos de entorno de trabajo como accesorios MIME y cambiar propiedades.

El ID de contenido es el identificador que utiliza la llamada para hacer referencia a los accesorios. El método para el uso de este identificador varía en función de los requisitos del servidor.

Protocolo

En esta página se trata el protocolo que se utiliza para enviar la llamada. El protocolo puede ser HTTP o JMS (Java™ Message Service) en base mensaje por mensaje.

HTTP

Esta página le permite alterar temporalmente los valores HTTP que se han adjuntado a la llamada para una configuración HTTP local.

Método

Esta opción le permite especificar el método HTTP de la llamada XML, entre la lista de métodos siguientes:

POST
GET
PUT
DELETE

Versión

Esta opción le permite especificar entre HTTP 1.0 o HTTP 1.1.

URL

Este campo le permite especificar el URL de la llamada XML.

Cabeceras

Esta sección le permite añadir cabeceras a la llamada. Las cabeceras deben ser compatibles con el método HTTP especificado.

La aplicación gestiona las cabeceras siguientes, y no se pueden añadir:

Agente de usuario
Conexión de host
Control de memoria caché
Pragma
Tipo de contenido
Longitud del contenido

Cookies

Esta sección le permite gestionar cookies. Puede añadir, editar y eliminar cookies, y crear referencias.

JMS

Esta página le permite añadir propiedades de serie que se han adjuntado a la llamada para una configuración JMS local, que se envían como propiedades de mensaje a través de JMS.

MQ

Esta página le permite alterar los valores que se han adjuntado a la llamada para una configuración MQ de WebSphere.

Nombre

Es el nombre que se muestra en la llamada de mensaje como un enlace a esta configuración de protocolo.

Nombre del gestor de colas

Especifica el nombre del gestor de colas al que se desea enviar la llamada.

Nombre de cola

Especifica el nombre de la cola que gestiona el gestor de colas.

Utilizar gestor de colas local

Especifica si el servidor WebSphere MQ se ejecuta en el sistema local. Si el servidor se encuentra en un sistema remoto, quite la marca de selección de esta opción para especificar los detalles del servidor MQ remoto.

Dirección del gestor de colas

Especifica la dirección IP o el nombre de host del servidor remoto.

Puerto del gestor de colas

Especifica el puerto de escucha del servidor MQ remoto.

Canal de cliente

Especifica el canal de modalidad de conexión de servidor del gestor de colas remoto.

Utilizar cola temporal

Especifica si el servidor MQ crea una cola temporal. Si se selecciona, la cola temporal se crea con el único propósito de recibir mensajes específicos y, a continuación, se suprime.

Nombre de cola

Si se quita la marca de selección de Utilizar cola temporal, esta opción especifica el nombre de la cola en la que se reciben los retornos de mensajes del servidor MQ. El gestor de colas que se especifica en Nombre del gestor de colas debe gestionar esta cola.

Las llamadas y los retornos de mensajes se asocian al ID de correlación en el mensaje MQ, lo que significa que el valor de informe del mensaje se establece en MQC.MQRO_COPY_MSG_ID_TO_CORREL_ID. El servidor debe satisfacer esta restricción. De este modo, se da soporte al transporte para la característica SOAP que proporciona WebSphere MQ.

Servicio de destino

Esta opción sirve para utilizar Microsoft .NET con el transporte IBM WebSphere MQ para la característica SOAP. De este modo, se especifica el nombre del archivo ASPX del directorio del escucha .NET.

Utilizar cabecera RFH2

Especifica si los mensajes SOAP utilizan una cabecera RFH2, que utiliza un formato de mensaje MQ predeterminado. Cuando se selecciona, se inhabilitan otras opciones del Descriptor de mensaje. Utilice esta opción para el transporte WebSphere MQ para la característica SOAP. Si utiliza el enlace WID (WebSphere Integration Developer) MQ, el enlace comprende los mensajes con o sin la cabecera RFH2.

Descriptor de mensaje

Esta sección le permite configurar los campos de la llamada de mensaje. Puede sustituir un subconjunto de un descriptor de mensaje MQ con un formato personalizado para utilizarlo con otros tipos de servidor, específicamente, al utilizar una llamada de mensaje XML. Para obtener detalles sobre los descriptores de mensajes, consulte la documentación de WebSphere MQ.

Utilizar cola temporal

Esta sección le permite especificar una contraseña y nombre de usuario para la autenticación básica en el servidor de aplicaciones.

Conexión SSL

Seleccione esta opción para utilizar una configuración SSL si un valor Canal de cliente hace referencia a un canal seguro. Pulse Abrir Editor SSL para crear una nueva configuración SSL, o bien, pulse Cambiar para cambiar la configuración SSL que está asociada a la prueba actual.

Si el WSDL (Web Services Description Language) que utiliza para crear la llamada de mensaje utiliza un URI de JMS al que se da soporte para apuntar al servidor WebSphere MQ, la configuración SSL se crea de modo automático. Si el generador de pruebas no puede crear la configuración SSL, debe crear una nueva manualmente.

Si el WSDL se genera con el servicio WebSphere MQ (amqwdeployWMService), edite el WSDL para cambiar el enlace de transporte de HTTP a JMS con el objeto de evitar que el generador de pruebas cree una configuración HTTP.

Suite de cifrado

Especifique la suite de cifrado que se utiliza en la configuración de canal.

Seguridad XML local

Esta página le permite añadir un algoritmo de seguridad personalizada que se implemente en una clase Java. Los algoritmos personalizados se pueden aplicar al contenido XML que se envía y recibe del servidor.

Añadir, Insertar, Eliminar, Arriba y Abajo

Estos botones le permite crear una pila de algoritmos de seguridad. Cada algoritmo se aplica a la pila de modo secuencial. Pulse Añadir para añadir un algoritmo de seguridad personalizada.

Herramientas

Este botón le permite cambiar el modo en que se visualiza la pila de algoritmos.

Algoritmo de seguridad personalizada

Después de añadir un algoritmo de seguridad personalizada a la pila. Con esta ventana, puede especificar la clase Java que implementa el algoritmo. La clase Java utiliza la interfaz siguiente:

/**
* ***************************************************************
* IBM Confidential
* 
* (c) Copyright IBM Corporation. 2008. Reservados todos los derechos.
* 
* The source code for this program is not published or otherwise
* divested of its trade secrets, irrespective of what has been
* deposited with the U.S. Copyright Office.
* *************************************************************** 
* 
*/

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

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


public interface ICustomSecurityAlgorithm {
	
	/**
	 	 * The following methods can be used in both case:
	 	 * Execution in the workbench and execution of the test.
	 */
	
	
	/**
	 	 * Called to process de Document that is sent over a transport.
	 	 * @param subject
	 */
		void process(Document subject);
	/**
	 	 * Called to un process a document that is received from a server.
	 	 * @param subject
	 */
		void unProcess(Document subject);
	
	/**
	 	 * Properties defined in the UI of the CustomSecurityAlgorithm.
	 	 * @param map
	 */
		void setProperties(Properties map);
	
	/**
	 	 * The following methods can only be used in terms of cast to test service interface,
	 	 * or in terms of access to the previous XML  information, when the jar containing
	 	 * the custom security algorithm is deployed in the performance test project. In
	 	 * this case you cannot use the algorimth directly from the workbench.
	 */
	
	/**
	 	 * This object corresponds to the ITestExecutionService object.
	 	 * This applies only to an algorithm that must link to the execution of the test.
	 	 * If you plan to use this object you will need to deploy the jar containing the
	 	 * implementation into your performance test project and not directly into the JRE.
	 * 
	 	 * In case of a need of the previous xml document received from the execution you can 
	 	 * obtain the value using:
	 	 * IDataArea area = ((ITestExecutionService)executionObject).findDataArea(IDataArea.VIRTUALUSER);
	 	 *String previousXML = (String) area.get("PREVIOUS_XML"); //$NON-NLS-1$
	 * 
	 */
		void setExecutionContext(Object executionObject);

El método process modifica el XML antes de enviarlo al servidor.
El método unprocess modifica el XML después de recibirlo de servidor.
El método setProperties recupera todas las propiedades que se han definido en el editor de seguridad para esta interfaz de seguridad personalizada.
Durante la prueba se llama el método setExecutionContext con el objeto ITestExecutionServices que corresponde al mensaje por medio de esta interfaz de seguridad personalizada.

Nombre de clase de algoritmo de seguridad personalizada: Especifica la clase que implementa el algoritmo de seguridad. Pulse Examinar clase para seleccionar una clase del espacio de trabajo.
Nombre de algoritmo: Especifica un nombre para el algoritmo actual.
Propiedades: Esta lista especifica propiedades que el método setProperties utiliza en el algoritmo. UtiliceAñadir, Eliminar o Editar para crear la lista de propiedades.

Comentarios