Nel client del servizio generico, le chiamate del servizio contengono il contenuto e le informazioni di trasporto
per la chiamata. Il contenuto consiste nell'envelope SOAP. Le informazioni di trasporto fanno riferimento alle informazioni che sono richieste per inviare e ricevere e rispondere in base al protocollo selezionato.
Messaggio
Questa pagina riporta il contenuto XML della richiesta e fornisce l'accesso alla correlazione dati. Lo stesso contenuto viene presentato in tre diverse forme.
- Modulo
- Questa vista fornisce una vista semplificata del messaggio concentrato sulla modifica dei valori del contenuto
XML.
- Struttura ad albero
Questa vista fornisce una visualizzazione gerarchica della struttura XML del messaggio, inclusi gli elementi,
gli spazi dei nomi e i valori associati. Per modificare gli elementi XML e gli spazi dei nomi nella struttura ad albero, è possibile utilizzare Aggiungi, Inserisci, Rimuovi, Su e Giù.
Fare clic su Filtra per nascondere o mostrare lo spazio dei nomi, attributi o nodi di testo, in base ai requisiti.
Per abilitare la modifica smart, fare clic su Consenti solo modifiche valide, in base a XSD (XML Schema Document) specificato. Per specificare un gruppo di documenti XSD per il workbench, nel Navigator di test, fare clic con il pulsante destro del mouse sul progetto e selezionare Proprietà e Catalogo schema. Se non si dispone di un documento XSD o se si desidera ignorare lo schema, disabilitare Consenti solo modifiche valide.
È possibile fare clic con il pulsante destro del mouse su un elemento XML per convertirlo in un frammento XML. Ciò consente di
eseguire la correlazione dei dati (utilizzare i pool di dati e creare i riferimenti) sull'intero frammento XML invece che solo sul valore.
- Origine
- Questa vista visualizza l'XML di origine del messaggio o il contenuto del testo semplice.
Importante: nella vista Origine, non modificare le tag che iniziano con SoaTag. Se si eliminano o si modificano queste tag, i riferimenti e le sostituzioni nel test saranno interrotti. Non è possibile ricreare tali tag una volta eliminate.
Allegati
In questa pagina vengono elencati gli allegati MIME associati alla richiesta. Il contenuto di questa vista corrisponde alla specifica di MIME (Multipurpose Internet Mail Extensions). Questa pagina consente di aggiungere le risorse del
workbench come allegati MIME e di modificare le proprietà.
ID contenuto è l'identificativo utilizzato dalla richiesta per fare riferimento agli allegati. Il metodo per utilizzare questo identificativo dipende dai requisiti del server.
- Utilizza meccanismo di trasmissione MTOM
- Per impostazione predefinita, la richiesta utilizza messaggi SOAP con allegati (SwA) per gestire gli allegati. Selezionare questa opzione per gestire gli allegati con il metodo MTOM (Message Transmission Optimization Mechanism) di SOAP.
Trasporto
Questa pagina descrive le impostazioni di trasporto utilizzate per inviare la richiesta. Le impostazioni del protocollo di trasporto si applicano ad una configurazione
di trasporto che può essere HTTP, JMS (Java Message Service), o WebSphere MQ. È possibile creare molte configurazioni per ogni protocollo, in modo che sia possibile passare facilmente da un protocollo o variante di protocollo all'altro.
- HTTP
- Selezionare HTTP per utilizzare il trasporto HTTP per la richiesta.
A livello di richiesta, è possibile aggiornare un'azione URL o SOAP e il riferimento alla configurazione globale di un test.
- Configurazione protocollo
- Fare clic su Modifica per specificare una configurazione di trasporto predefinita
o per creare una nuova configurazione. Le configurazioni trasporto HTTP contengono le impostazioni
proxy e di autenticazione che possono essere riutilizzate.
- Metodo e Versione
- Specificare il metodo HTTP e la versione da utilizzare per richiamare la richiesta del servizio.
- URL
- Specificare l'endpoint dell'URL della richiesta di servizio.
- Intestazioni
- Specificare i nomi ed i valori di tutte le intestazioni HTTP personalizzate che sono
richieste dal servizio. Fare clic su Aggiungi, Modifica o Elimina per
modificare l'elenco intestazioni.
- Cookie
- Specificare i nomi ed i valori di tutti i cookie richiesti
dal servizio. Fare clic su Aggiungi, Modifica o Elimina per modificare
l'elenco di cookie.
- JMS
Selezionare JMS per utilizzare il trasporto JMS (Java Messaging Service) per la richiesta. Questa pagina consente di aggiungere le proprietà di stringa associate alla richiesta per una configurazione JMS. Saranno inviate come proprietà di messaggio mediante JMS.
- Configurazione protocollo
- Fare clic su Modifica per specificare una configurazione di trasporto predefinita
o per creare una nuova configurazione. Le configurazioni del trasporto JMS contengono
endpoint generici, punti di ricezione e impostazioni dell'adattatore che possono essere riutilizzate.
- Proprietà
- Specificare i nomi e i valori delle proprietà delle stringhe che sono richieste dalla richiesta per la configurazione di trasporto JMS corrente. Questi sono inviati come proprietà del messaggio tramite JMS. Fare clic su Aggiungi, Modifica o Elimina per
modificare l'elenco delle proprietà.
- WebSphere MQ
- Selezionare MQ per utilizzare IBM® WebSphere MQ per la richiesta.
Tale pagina consente di specificare l'azione SOAP e sovrascrivere le impostazioni per la configurazione
WebSphere MQ selezionata al livello del test.
- Configurazione protocollo
- Fare clic su Modifica per specificare una configurazione di trasporto predefinita
o per creare una nuova configurazione. Le configurazioni di trasporto MQ contengono una coda generica, un'intestazione e le impostazioni
SSL che possono essere riutilizzate.
- Azione SOAP
- Specifica l'azione SOAP da utilizzare per richiamare la richiesta MQ.
- Sovrascrivere i valori configurazione protocollo MQ
- Selezionare questa opzione per configurare i campi del messaggio MQ.
È possibile sostituire un gruppo secondario di un descrittore messaggi MQ con un formato personalizzato da utilizzare con gli altri tipi di server, in modo particolare quando si utilizza una richiesta messaggio XML.
Consultare la documentazione WebSphere MQ
per le informazioni dettagliate sui descrittori di messaggi. Queste impostazioni sostituiscono il descrittore del messaggio e le impostazioni dell'intestazione
della configurazione del protocollo MQ.
- Utilizza intestazione personalizzata
- Selezionare questa opzione per specificare le intestazioni personalizzate per il trasporto per il
SOAP sulla funzione MQ fornita da WebSphere MQ.
Questa funzione utilizza un formato prestabilito di messaggio MQ (RFH2), quindi, quando è selezionata, le altre opzioni Descrittore messaggi sono disabilitate.
Sicurezza per la richiesta
Utilizzare questa pagina per modificare gli stack degli
algoritmi di sicurezza che il protocollo di sicurezza applica alle richieste di servizio prima dell'invio. Gli stack di sicurezza sono una serie
di algoritmi che vengono eseguiti in un ordine definito.
- Sostituisci impostazioni editor di sicurezza WSDL
- Per impostazione predefinita, si modifica lo stack di algoritmi di sicurezza allegato ad un file WSDL specifico nell'editor di sicurezza WSDL. Selezionare questa opzione per specificare un diverso stack di algoritmi di sicurezza soltanto per la richiesta di servizio corrente.
- Dettagli dell'algoritmo di sicurezza
- Fare clic su Aggiungi, Inserisci o Rimuovi per aggiungere o rimuovere
gli algoritmi di sicurezza nello stack. Fare clic su Su e Giù per
modificare l'ordine di un algoritmo selezionato nello stack di sicurezza. Il seguente
algoritmo di sicurezza può essere aggiunto allo stack sicurezza:
- Data/ora
- La data/ora dell'algoritmo di sicurezza aggiunge le informazioni sulla data/ora al documento XML nella risposta. Per i dettagli sugli algoritmi di sicurezza, fare riferimento alla specifica di sicurezza del servizio Web.
- Nome actor / ruolo
- Specificare il nome dell'actor, laddove richiesto.
- Da comprendere
- Specificare se l'algoritmo di sicurezza deve essere compreso.
- Data/ora
- Specificare il ritardo prima di aggiungere la data/ora.
- Token del nome utente
- L'algoritmo della sicurezza del token del nome utente aggiunge un token del nome utente al documento
XML nella risposta. Per i dettagli sugli algoritmi di sicurezza, fare riferimento alla specifica di sicurezza del servizio Web.
- Nome actor / ruolo
- Specificare il nome dell'actor, laddove richiesto.
- Da comprendere
- Specificare se l'algoritmo di sicurezza deve essere compreso.
- Nome
- Specificare il nome dell'utente.
- Password
- Immettere la password dell'utente.
- Tipo di password
- Specificare il tipo di password per l'algoritmo di sicurezza.
- Crittografia XML
- L'algoritmo di sicurezza della crittografia XML specifica come il documento XML viene crittografato. Per i dettagli sugli algoritmi di sicurezza, fare riferimento alla specifica di sicurezza del servizio Web.
- Nome actor / ruolo
- Specificare il nome dell'actor, laddove richiesto.
- Da comprendere
- Specificare se l'algoritmo di sicurezza deve essere compreso.
- Tipo identificativo
- Selezionare il tipo di identificativo chiave da utilizzare per la crittografia:
- ISSUER_SERIAL
- BST_DIRECT_REFERENCE
- X509_KEY_IDENTIFIER
- SKI_KEY_IDENTIFIER
- EMBEDDED_KEYNAME
- THUMBPRINT_IDENTIFIER
- Selezione della parte XPath dell'utente
- Consente di specificare una query XPath che descrive le parti del documento XML che possono essere oggetto dell'algoritmo. Per impostazione predefinita, il corpo è l'oggetto.
- Chiave
- Selezionare la chiave utilizzata per la crittografia. I dettagli di ciascuna chiave variano.
- Chiave x509: specifica il nome e la password della chiave x509 e l'archivio chiavi in cui si trova.
- Chiave semplice: specifica il nome e il valore in byte della chiave in esadecimale.
- Chiave del token del nome utente: specifica un nome utente e la password per il token.
- Chiave crittografata: Questa opzione specifica una chiave crittografata definita in precedenza nello stack di sicurezza. Fare clic su Inserisci
un nuova chiave crittografata per creare un nuovo blocco di definizione di chiave crittografata.
- Algoritmo di codifica chiave
- Specificare l'algoritmo standard per codificare la chiave di trasporto.
- Firma XML
- L'algoritmo di sicurezza della firma XML specifica come il documento XML
viene firmato. Per i dettagli sugli algoritmi di sicurezza, fare riferimento alla specifica di sicurezza del servizio Web.
- Nome actor / ruolo
- Specificare il nome dell'actor, laddove richiesto.
- Da comprendere
- Specificare se l'algoritmo di sicurezza deve essere compreso.
- Tipo identificativo
- Selezionare il tipo di identificativo chiave da utilizzare per la crittografia:
- ISSUER_SERIAL
- BST_DIRECT_REFERENCE
- X509_KEY_IDENTIFIER
- SKI_KEY_IDENTIFIER
- EMBEDDED_KEYNAME
- KEY_VALUE
- USER_NAME_TOKEN
- CUSTOM_SYMM_SIGNATURE
- Selezione della parte XPath dell'utente
- Specificare una query XPart che descrive le parti del documento XML che possono essere oggetto dell'algoritmo. Per impostazione predefinita, il corpo è l'oggetto.
- Chiave
- Selezionare la chiave utilizzata per la crittografia. I dettagli di ciascuna chiave variano.
- Chiave x509: specifica il nome e la password della chiave x509 e l'archivio chiavi in cui si trova.
- Chiave semplice: specifica il nome e il valore in byte della chiave in esadecimale.
- Chiave del token del nome utente: specifica un nome utente e la password per il token.
- Chiave crittografata: Questa opzione specifica una chiave crittografata definita in precedenza nello stack di sicurezza. Fare clic su Inserisci
un nuova chiave crittografata per creare un nuovo blocco di definizione di chiave crittografata.
- Nome algoritmo di firma
- Specificare l'algoritmo da utilizzare per la firma.
- Canonicalization
- Specificare l'algoritmo da utilizzare per la canonicalization.
- Chiave crittografata
- Questo blocco definisce la chiave da utilizzare in una firma XML
o blocco di crittografia XML. Il blocco chiave crittografata deve essere trovarsi prima di un blocco che utilizza la chiave crittografata.
- Nome actor / ruolo
- Specificare il nome dell'actor, laddove richiesto.
- Da comprendere
- Specificare se l'algoritmo di sicurezza deve essere compreso.
- Nome chiave
- Specificare il nome della chiave crittografata.
- Tipo identificativo
- Selezionare il tipo di identificativo chiave da utilizzare per la crittografia:
- ISSUER_SERIAL
- BST_DIRECT_REFERENCE
- X509_KEY_IDENTIFIER
- EMBEDDED_KEYNAME
- THUMBPRINT_IDENTIFIER
- SKI_KEY_IDENTIFIER
- Dimensioni chiave
- Specificare le dimensioni della chiave in bit.
- Nome dell'algoritmo di codifica chiave
- Specificare l'algoritmo da utilizzare per la codifica della chiave.
- Keystore
- Selezionare un keystore oppure fare clic su Modifica sicurezza per definire un nuovo keystore o per gestire i keystore esistenti.
- Nome
- Selezionare una chiave contenuta nel keystore specificato.
- Password
- Immettere la password per il nome chiave selezionato.
- Algoritmo di sicurezza personalizzato
- Se si è implementata una classe Java come algoritmo di sicurezza personalizzato,
utilizzare questo elemento stack per applicare l'algoritmo personalizzato al servizio.
- Nome
- Specificare il nome dell'algoritmo di sicurezza personalizzato.
- Classe di implementazione
- Specificare il nome della classe che implementa l'algoritmo di sicurezza personalizzato. Fare clic su Sfoglia per selezionare una classe Java dallo spazio di lavoro.
- Proprietà
- Utilizzare questa tabella per inviare proprietà specifiche e valori associati all'algoritmo di sicurezza personalizzato.
- Algoritmo WS-Addressing
- Aggiungere questo stack, se il servizio utilizza lo standard WS-Addressing 2004/08 o WS-Addressing 1.0 Core.
- Spazio nomi
- Specificare lo spazio dei nomi per WS-Addressing 2004/08 o WS-Addressing 1.0 Core.
- Azione se la richiesta utilizza WS-Addressing
- Selezionare l'azione da eseguire, se WS-Addressing è già nella richiesta.
- Sostituisci indirizzo anonimo in Reply-to con:
- Selezionare questa opzione per generare l'indirizzo specificato nell'intestazione Reply-to, invece che un indirizzo anonimo.
- Rimuovi WS-Addressing dalla risposta
- Selezionare questa opzione per eseguire lo stripping delle intestazioni WS-Addressing dalla risposta.
Sicurezza per la risposta
Utilizzare questa pagina per modificare gli stack degli
algoritmi di sicurezza che il protocollo di sicurezza applica alle richieste di servizio dopo la ricezione. Gli stack di sicurezza sono una serie
di algoritmi che vengono eseguiti in un ordine definito.
- Sostituisci editor di sicurezza WSDL
- Per impostazione predefinita, si modifica lo stack di algoritmi di sicurezza allegato ad un file WSDL specifico nell'editor di sicurezza WSDL. Selezionare questa opzione per specificare un diverso stack di algoritmo di sicurezza soltanto per la risposta corrente.
- Dettagli dell'algoritmo di sicurezza
- Fare clic su Aggiungi, Inserisci o Rimuovi per aggiungere o rimuovere
gli algoritmi di sicurezza nello stack. Fare clic su Su e Giù per
modificare l'ordine di un algoritmo selezionato nello stack di sicurezza. Il seguente
algoritmo di sicurezza può essere aggiunto allo stack sicurezza:
- Crittografia XML
- L'algoritmo di sicurezza della crittografia XML specifica come il documento XML viene crittografato. Per i dettagli sugli algoritmi di sicurezza, fare riferimento alla specifica di sicurezza del servizio Web.
- Nome actor / ruolo
- Specificare il nome dell'actor, laddove richiesto.
- Da comprendere
- Specificare se l'algoritmo di sicurezza deve essere compreso.
- Tipo identificativo
- Selezionare il tipo di identificativo chiave da utilizzare per la crittografia:
- ISSUER_SERIAL
- BST_DIRECT_REFERENCE
- X509_KEY_IDENTIFIER
- SKI_KEY_IDENTIFIER
- EMBEDDED_KEYNAME
- THUMBPRINT_IDENTIFIER
- Selezione della parte XPath dell'utente
- Consente di specificare una query XPath che descrive le parti del documento XML che possono essere oggetto dell'algoritmo. Per impostazione predefinita, il corpo è l'oggetto.
- Chiave
- Selezionare la chiave utilizzata per la crittografia. I dettagli di ciascuna chiave variano.
- Chiave x509: specifica il nome e la password della chiave x509 e l'archivio chiavi in cui si trova.
- Chiave semplice: specifica il nome e il valore in byte della chiave in esadecimale.
- Chiave del token del nome utente: specifica un nome utente e la password per il token.
- Chiave crittografata: Questa opzione specifica una chiave crittografata definita in precedenza nello stack di sicurezza. Fare clic su Inserisci
un nuova chiave crittografata per creare un nuovo blocco di definizione di chiave crittografata.
- Algoritmo di codifica chiave
- Specificare l'algoritmo standard per codificare la chiave di trasporto.
- Chiave crittografata
- Questo blocco definisce la chiave da utilizzare in una firma XML
o blocco di crittografia XML. Il blocco chiave crittografata deve essere trovarsi prima di un blocco che utilizza la chiave crittografata.
- Nome actor / ruolo
- Specificare il nome dell'actor, laddove richiesto.
- Da comprendere
- Specificare se l'algoritmo di sicurezza deve essere compreso.
- Nome chiave
- Specificare il nome della chiave crittografata.
- Tipo identificativo
- Selezionare il tipo di identificativo chiave da utilizzare per la crittografia:
- ISSUER_SERIAL
- BST_DIRECT_REFERENCE
- X509_KEY_IDENTIFIER
- EMBEDDED_KEYNAME
- THUMBPRINT_IDENTIFIER
- SKI_KEY_IDENTIFIER
- Dimensioni chiave
- Specificare le dimensioni della chiave in bit.
- Nome dell'algoritmo di codifica chiave
- Specificare l'algoritmo da utilizzare per la codifica della chiave.
- Keystore
- Selezionare un keystore oppure fare clic su Modifica sicurezza per definire un nuovo keystore o per gestire i keystore esistenti.
- Nome
- Selezionare una chiave contenuta nel keystore specificato.
- Password
- Immettere la password per il nome chiave selezionato.
- Algoritmo di sicurezza personalizzato
- Se si è implementata una classe Java come algoritmo di sicurezza personalizzato,
utilizzare questo elemento stack per applicare l'algoritmo personalizzato al servizio.
- Nome
- Specificare il nome dell'algoritmo di sicurezza personalizzato.
- Classe di implementazione
- Specificare il nome della classe che implementa l'algoritmo di sicurezza personalizzato. Fare clic su Sfoglia per selezionare una classe Java dallo spazio di lavoro.
- Proprietà
- Utilizzare questa tabella per inviare proprietà specifiche e valori associati all'algoritmo di sicurezza personalizzato.