Configurar SoapUI para las API SOAP de Redtrust

Esta guía explica cómo configurar SoapUI para realizar solicitudes a cualquiera de las API SOAP de Redtrust que usan el endpoint /basic.

Antes de empezar

• SoapUI instalado.
• La URL del WSDL del servicio al que quieres conectarte.
• Credenciales de un usuario administrador de Redtrust.

Paso 1: Crea el proyecto SOAP

1. Abre SoapUI y haz clic en SOAP.

2. En New SOAP Project, añade la URL del WSDL como Initial WSDL:

   • API de administración: https://TU_IP_REDTRUST:8888/RTAdminService.svc?wsdl
   • API DSS: https://TU_IP_REDTRUST:8080/RTDSSService.svc
   nota

   Los puertos indicados son los valores por defecto y puedes cambiarlos desde la consola de administración (Sistema > Unidad > Red). El protocolo por defecto es HTTPS y el certificado del servicio se genera automáticamente durante la instalación, aunque también puedes configurarlo desde la consola. Al implementar un cliente que acceda al servicio, necesitarás la parte pública del certificado del servicio para que el cliente confíe en el servidor, salvo que el cliente acepte cualquier certificado.

Paso 2: Configura WS-Security

1. Haz clic en el nombre del proyecto. En la ventana de configuración, haz clic en WS-Security Configurations (tercera pestaña).
2. Haz clic en el icono verde + y añade el nombre del usuario (por ejemplo, admin).
3. Haz clic en el segundo icono verde + y selecciona Username.
4. Añade TU_USUARIO@TU_DOMINIO (por ejemplo, admin@local.users) y su contraseña. Cierra la ventana para guardar los cambios.

Paso 3: Añade la URL del endpoint

1. Haz clic en el icono + junto a cualquier método y haz doble clic en Request 1.

2. Añade la URL del endpoint /basic:

   • API de administración: https://TU_IP_REDTRUST:8888/RTAdminService.svc/basic
   • API DSS: https://TU_IP_REDTRUST:8080/RTDSSService.svc/basic
   nota

   La URL del endpoint depende del método de autenticación y de la configuración del despliegue.

Paso 4: Configura la autenticación en cada solicitud

Repite estos pasos en cada solicitud que realices:

1. Selecciona la pestaña Auth (Basic) en la parte inferior.
2. En el menú Authorization, selecciona Add New Authorization > Basic e introduce las credenciales del usuario administrador.
3. De vuelta en la ventana de la petición, ve a Outgoing WSS y selecciona el usuario configurado en el paso 2.
4. Selecciona la pestaña WS-A en la parte inferior y marca Add default wsa:Action y Add default wsa:To.

important

SoapUI genera automáticamente elementos vacíos dentro de los arrays, por ejemplo <arr:int></arr:int>. Esto no es válido y provoca un error 500. Para enviar un array vacío, usa una etiqueta de cierre automático en el elemento padre:

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

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