Pular para o conteúdo principal
Version: 4.42

Configurar o SoapUI para as API SOAP do Redtrust

Este guia explica como configurar o SoapUI para realizar requisições a qualquer API SOAP do Redtrust que usa o endpoint /basic.

Antes de começar​

  • SoapUI instalado.
  • A URL do WSDL do serviço ao qual você quer se conectar.
  • Credenciais de um usuário administrador do Redtrust.

Etapa 1: Crie o projeto SOAP​

  1. Abra o SoapUI e clique em SOAP.

  2. Em New SOAP Project, adicione a URL do WSDL como Initial WSDL:

    • API de administração: https://SEU_IP_REDTRUST:8888/RTAdminService.svc?wsdl
    • API DSS: https://SEU_IP_REDTRUST:8080/RTDSSService.svc
    nota

    As portas indicadas são os valores padrão e podem ser alteradas no console de administração (Sistema > Unidade > Rede). O protocolo padrão é HTTPS e o certificado do serviço é gerado automaticamente durante a instalação, embora também possa ser configurado no console. Ao implementar um cliente que acesse o serviço, você precisará da parte pública do certificado do serviço para que o cliente confie no servidor, salvo se o cliente aceitar qualquer certificado.

Etapa 2: Configure o WS-Security​

  1. Clique no nome do projeto. Na janela de configuração, clique em WS-Security Configurations (terceira aba).
  2. Clique no ícone verde + e adicione o nome do usuário (por exemplo, admin).
  3. Clique no segundo ícone verde + e selecione Username.
  4. Adicione SEU_USUÁRIO@SEU_DOMÍNIO (por exemplo, admin@local.users). Feche a janela para salvar as alterações.

Etapa 3: Adicione a URL do endpoint​

  1. Clique no ícone + ao lado de qualquer método e dê duplo clique em Request 1.

  2. Adicione a URL do endpoint /basic:

    • API de administração: https://SEU_IP_REDTRUST:8888/RTAdminService.svc/basic
    • API DSS: https://SEU_IP_REDTRUST:8080/RTDSSService.svc/basic
    nota

    A URL do endpoint depende do método de autenticação e da configuração do ambiente.

Etapa 4: Configure a autenticação em cada requisição​

Repita estas etapas em cada requisição que você realizar:

  1. Selecione a aba Auth (Basic) na parte inferior.
  2. No menu Authorization, selecione Add New Authorization > Basic e insira as credenciais do usuário administrador.
  3. De volta na janela da requisição, vá em Outgoing WSS e selecione o usuário configurado na etapa 2.
  4. Selecione a aba WS-A na parte inferior e marque Add default wsa:Action e Add default wsa:To.
important

O SoapUI gera automaticamente elementos vazios dentro de arrays, por exemplo <arr:int></arr:int>. Isso não é válido e causa um erro 500. Para enviar um array vazio, use uma tag de fechamento automático no elemento pai:

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

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

Esta página foi útil?