Skip to main content
Version: 4.42

Set up SoapUI for Redtrust SOAP APIs

This guide explains how to configure SoapUI to make requests to any Redtrust SOAP API that uses the /basic endpoint.

Before you begin​

  • SoapUI installed.
  • The WSDL URL of the service you want to connect to.
  • Credentials of a Redtrust admin user.

Step 1: Create the SOAP project​

  1. Open SoapUI and click SOAP.

  2. In New SOAP Project, add the WSDL URL as the Initial WSDL:

    • Administration API: https://YOUR_REDTRUST_IP:8888/RTAdminService.svc?wsdl
    • DSS API: https://YOUR_REDTRUST_IP:8080/RTDSSService.svc
    note

    The ports shown are the default values and can be changed from the admin console (System > Unit > Network). The default protocol is HTTPS and the service certificate is generated automatically during installation, though you can also configure it from the console. When implementing a client that accesses the service, you will need the public part of the service certificate so that the client trusts the server, unless the client accepts any certificate.

Step 2: Configure WS-Security​

  1. Click the project name. In the configuration window, click WS-Security Configurations (third tab).
  2. Click the green + icon and add the username (for example, admin).
  3. Click the second green + icon and select Username.
  4. Add YOUR_USERNAME@YOUR_DOMAIN (for example, admin@local.users). Close the window to save your changes.

Step 3: Add the endpoint URL​

  1. Click the + icon next to any method and double-click Request 1.

  2. Add the /basic endpoint URL:

    • Administration API: https://YOUR_REDTRUST_IP:8888/RTAdminService.svc/basic
    • DSS API: https://YOUR_REDTRUST_IP:8080/RTDSSService.svc/basic
    note

    The endpoint URL depends on the authentication method and deployment configuration.

Step 4: Configure authentication on each request​

Repeat these steps for each request you make:

  1. Select the Auth (Basic) tab at the bottom.
  2. In the Authorization menu, select Add New Authorization > Basic and enter the admin user credentials.
  3. Back in the request window, go to Outgoing WSS and select the user you configured in step 2.
  4. Select the WS-A tab at the bottom and check Add default wsa:Action and Add default wsa:To.
important

SoapUI automatically generates empty elements inside arrays, for example <arr:int></arr:int>. This is not valid and causes a 500 error. To send an empty array, use a self-closing tag on the parent element:

<!-- Correct -->
<urn:certificateIds/>

<!-- Incorrect -->
<urn:certificateIds>
    <arr:int></arr:int>
</urn:certificateIds>

Was this page helpful?