To configure SOAtestSOAtest configure SOAtest and VirtualizeVirtualize to Virtualize to work withWeb services deployed using HTTPS (HTTP via the SSL), you need to identify and register the certificate being used for the HTTPS connection from the server:
Close SOAtestVirtualizeSOAtest Close SOAtest and/or Virtualize if it is currently open.
- Identify the location of the server certificate used for the HTTPS connection.
- Ensure that this certificate’s COMMON NAME parameter contains both the server’s machine name and the subdomain (for example,
machine.company.com
). Copy the certificate to the following location:
<soatest_install_dir>/plugins/com.parasoft.ptest.libs.web_<soatest_version_number>/root/lib
<virtualize_install_dir>/plugins/com.parasoft.ptest.libs.web_<virtualize_version_number>/root/lib
Virtualize:
<virtualize_install_dir>/plugins/com.parasoft.ptest.libs.web_<virtualize_version_number>/root/lib
SOAtest:
<soatest_install_dir>/plugins/com.parasoft.ptest.libs.web_<soatest_version_number>/root/lib
.
This directory should contain acacerts
file in which the trusted certificates are stored.Execute a command of the following format:
keytool -import -alias <certificate_alias> -file <certificate_file> -keystore cacerts
For example, if your certificate file is namedtest.cert
, you would execute the following command from the<INSTALL>/plugins/com.parasoft.ptest.libs.web_<VERSION>/root/lib
directory:
keytool -import -alias serverTrustCert -file test.cert -keystore cacerts
This will import the certificate into the cacerts file with the alias "serverTrustCert
".Info icon false title keytool path must be set Before executing
keytool
commands, you must first set your path to include Java'skeytool
executable. You can use the version of the Java binaries that ship withSOAtest. Virtualize.SOAtest withSOAtest and Virtualize.To add the included Java binaries to your path, open a command line prompt and enter the following before referencing the keytool:PATH =%PATH%; <INSTALL>\plugins\com.parasoft.ptest.jdk.eclipse.core.web.<OS>.<ARCH>_<VERSION>\jdk\bin
- When prompted to enter a keystore password, enter
changeit
. - When asked whether you want to trust this certificate, enter
yes
. You will then see a message indicating that the certificate has been added to the keystore. - (Optional) Verify that the certificate has been added to the keystore by entering the following command, then checking the file that opens:
keytool -list -keystore cacerts
Launch SOAtestVirtualizeSOAtest Launch SOAtest or Virtualize and try to access the service again.
...
- Choose Parasoft> Preferences to open the Preferences dialog.
- Select Parasoft> Security from thace left pane of the Preferences dialog, then select the Trust all certificates option in the right pane.
- Click OK or Apply to apply this change.
SOAtestVirtualizeSOAtestSOAtest/Virtualize will then try to access any WSDL you specify, regardless of any problems with the certificate. However,SOAtestVirtualizeSOAtestSOAtest/Virtualize will still try use the certificate while trying to send SOAP messages because it is required to do so.
...
Debugging SSL Issues
SOAtest runsVirtualize runsSOAtest and Virtualize run on a standard JVM. To show the SSL/TLS handshake details and help identify causes of SSL connection problems, enable JVM network and SSL debugging:
- Open a command line console and navigate to the SOAtest installation directory.
- Start the executable with the arguments:
-J-Dssl.debug=true -J-Djavax.net.debug=all -consolelog
SOAtestVirtualizeSOAtestSOAtest/Virtualize will start normally, but whenever SSL connections are made, debugging output will be printed on the console. If you wish to save the trace output to a file (for example, output.txt
), you may append the following to the end of the command :
...