+

Search Tips   |   Advanced Search


SIP - Configure a test to use the TLS transport

With the TLS transport, you can send encrypted messages to the server. When the TLS transport is used, the server provides a trusted certificate, which is verified against the certification authority. The client then uses the public key of the server to encrypt the message before sending it.

Tests using the TLS transport can be run only from a schedule that is deployed on a location.

In a TLS configuration, the server must be registered against a certificate authority to obtain a signed server certificate.

The client and the server both have their own keystore. Each keystore must contain a public key and a private key. In addition, the server must have a truststore, which specifies the trusted clients. You can configure only one keystore and one truststore for each agent location.

The default listening port number for the TLS transport is 5556. You can change the listening port in the SIP Test Playback preferences.

To configure a test to use the TLS transport:

  1. On the computer running Rational Performance Tester, copy the following files to a folder, for example C:\rpt_tls\:

    • The keystore file

    • The truststore file

    • A properties file (for example: tlsoptions.properties), containing the filenames and passwords for the keystore and truststore files, as in the following example: 

      keyFileName=key.jks
keyFilePass=password
trustFileName=key.jks
trustFilePass=password

  2. Open a schedule containing a user group with at least one SIP test.

  3. Select the user group, and on the Schedule Element Details pane, click the Locations tab.

  4. Select Run this group on the following locations, and click Add to create a location.

  5. In the Add Location window, specify the details of the computer that will run the selected user group:

    1. In Host name, type the name of the computer that will run the user group.

      For example, type localhost for a local computer.

    2. In Deployment directory, type the path where the schedule will be deployed.

      For example, type C:\tmp.

    3. Click Finish, and save the schedule.

    A new location is available in the test navigator.

  6. In the test navigator, open the location that you just created, and click the General Properties tab.

  7. On the General Properties page, click Add to create a property for the selected location.

  8. In the New Property window, create a property entry:

    1. In Property Name, type RPT_VMARGS.

    2. In Operator, select =.

    3. In Property Value, type -DTLSPropertiesFile=<properties file location>.

      For example, type: -DTLSPropertiesFile=c:\rpt_tls\tlsoptions.properties.

    To set multiple RPT_VMARGS values for a location, type them in the same property entry and separate them with a space. Do not use multiple property entries to set multiple RPT_VMARGS values for a location.

  9. In the test editor, to enable a send request element to use the TLS transport, specify one of the following combinations:

    • Scheme: SIPS, Transport: none

    • Scheme: SIPS, Transport: tls

    • Scheme: SIPS, Transport: tcp

    • Scheme: SIP, Transport: tls


What to do next

To run a test configured to use the TLS transport, add the test to a schedule, and run the schedule.


Related

  • SIP test editor overview
  • Add SIP contexts
  • About SIP headers
  • Add sequence patterns to SIP tests


    Related tasks

  • Configure background registration
  • Create a SIP counterpart test
  • Run tests on computers with multiple network addresses
  • Configure different ports for a SIP location
  • Verify expected behavior