6. Web Services with SOAP and WSDL

wsdlRewriter

Version

Rewrites SOAP endpoint addresses and XML Schema locations (XSD import and include) in WSDL and XSD documents returned by the backend, so they point at the gateway instead of the backend's own address. By default the gateway's protocol, host, and port from the incoming request are used; set the attributes below to force a specific address. Typically used inside a soapProxy, where the service path is taken from the proxy. See the tutorial tutorials/soap/30-WSDL-Rewriter.yaml.

Example Configuration

api:
port: 2000
flow:
- wsdlRewriter:
protocol: https
host: api.example.com
port: 443
target:
url: https://legacy.example.com/ArticleService?wsdl
api:
   port: 2000
   flow:
     - wsdlRewriter:
         protocol: https
         host: api.example.com
         port: 443
   target:
     url: https://legacy.example.com/ArticleService?wsdl

Syntax

wsdlRewriter:
host: <string>
path: <string>
port: <number>
protocol: <string>
wsdlRewriter:
  host: <string>
  path: <string>
  port: <number>
  protocol: <string>

Attributes

NameRequiredDefaultDescriptionExamples
hostfalseDon't change the endpoint's host.The host the endpoint should be changed to.localhost
pathfalsesoapProxy/path/uriService location path written into the rewritten endpoint addresses. Inside a soapProxy it defaults to the proxy's path./shop/ArticleService
portfalseDon't change the endpoint's port.The port the endpoint should be changed to.4000
protocolfalseDon't change the endpoint's protocol.The protocol the endpoint should be changed to.http

Can be used in