Soap service client [editor]

Introduction

The Soap Service Client 1.1 and Soap Service Client 1.2 example projects contain methods for all the new features of the AQ_SoapServiceClient.

Out of the box, the new SoapServiceClient comes with:

•  Document attachments
•  Timeout exceptions
•  Dynamic URLs
•  Soap faults
•  Standard spring security

Configuration

To be able to run these projects the following configurations has to be made:

1. The path for the file system connection and the path for the keystore has to be set in the application.properties file

2. The path for the logging file of the soap-service has to be set in the soap-service’s application.properties file;

3. To start the soap-service use soap-service/soap-service.bat  - not sure if only these settings are needed

Document attachment

This functionality can be used in two ways:

1. On the “Send file” tab, a request can be made with an uploaded plain text file and in the Response widget, the content of the file is displayed.

          o   Note: Multiple text files can be sent at once.

2. On the “Retrieve file” tab, a request can be made with a given string and a plain text file is returned in the Response widget, containing the entered string. This file can be downloaded or deleted.

Timeout handling

To simulate the timeout handling of the AQ_SoapServiceClient, you need the following info/settings:

• For Soap 1.1: set the “connection.GetPerson11.soap.timeout” property from application.properties to 2000 milliseconds
• For Soap 1.2: “connection.GetPerson12.soap.timeout” property from the application.properties to 2000 milliseconds

The web server is configured to wait 10 seconds until it sends the response, so any timeout value under 10 seconds it’s ok.

On the “Timeouts” tab click the Send button. The timeout exception is displayed in the Response widget.

If the timeout property is set to a value of 10 seconds or bigger the following names can be entered in the Name field in order to get valid responses: “Rick”, “Mihai” or “Alexandra”. For any other name entered a Soap fault code and a Soap fault message will be displayed in the Response widget.

Dynamic URLs

In the “Dynamic urls” tab is a drop-down field in the Request widget from where a tenant can be selected (A or B). Depending on which tenant is selected, a different response is received in the Response widget.

Soap fault handling

On the “Soap faults” tab, the user is asked to enter person details which consist of name, age and gender. The validation is made on the value introduced in the “Age” field. A value under 26 will not meet the criteria and a Soap fault code and Soap fault message will be returned in the Response widget. A value equal with 26 or above, will be accepted.

Security

In the “Security” tab, in the Request widget is a drop-down from where the following authentication options can be selected:

1.     Basic Authentication

When Basic Authentication option is selected and the Send button is clicked, the following URL will be returned in the Response widget: http://localhost:8080/soap11/basicAuthentication for Soap Service Client 1.1 project or http://localhost:8080/soap12/basicAuthentication for Soap Service Client 1.2 project.

2.     Username Token and Plain Password

When Username Token + Plain Password option is selected and the Send button is clicked, the following URL will be returned in the Response widget: http://localhost:8080/soap11/userNameToken for Soap Service Client 1.1 project or http://localhost:8080/soap12/userNameToken for Soap Service Client 1.2 project.

3.     Username Token and Password Digest

When Username Token + Password Digest option is selected and the Send button is clicked, the following URL will be returned in the Response widget: http://localhost:8080/soap11/userNameToken for Soap Service Client 1.1 project or http://localhost:8080/soap12/userNameToken for Soap Service Client 1.2 project.

4.     X.509 Profile and Signing

When X.509 Profile + Signing option is selected and the Send button is clicked, the following URL will be returned in the Response widget: http://localhost:8080/soap11/signature for Soap Service Client 1.1 project or http://localhost:8080/soap12/signature for Soap Service Client 1.2 project.

5.     X.509 Profile and Timestamp

When X.509 Profile + Timestamp option is selected and the Send button is clicked, the following URL will be returned in the Response widget: http://localhost:8080/soap11/timestamp for Soap Service Client 1.1 project or http://localhost:8080/soap12/timestamp for Soap Service Client 1.2 project.

6.     X.509 Profile and Encryption

When X.509 Profile + Encryption option is selected and the Send button is clicked, the following URL will be returned in the Response widget: http://localhost:8080/soap11/encryption for Soap Service Client 1.1 project or http://localhost:8080/soap12/encryption for Soap Service Client 1.2 project.

7.     X.509 Profile, Signing, Timestamp and Encryption

When X.509 Profile + Signing + Timestamp + Encryption option is selected and the Send button is clicked, the following URL will be returned in the Response widget: http://localhost:8080/soap11/x509 for Soap Service Client 1.1 project or http://localhost:8080/soap12/x509 for Soap Service Client 1.2 project.