1. Proxies and Flow

proxy

Clients can send HTTP requests to a proxy that forward the request to a Web server. It acts on behalf of the client.

Can be used in:

httpClientConfig, router and bean

Syntax

<proxy name="string"
  port="integer"
  blockRequest="[true,false]"
  blockResponse="[true,false]">
  [interceptors]*
</proxy>

Sample

<proxy name="HTTP Proxy" port="3128" >
  <transform xslt="strip.xslt"/>
  <switch>
    <case xPath="//convert" url="http://www.thomas-bayer.com/axis2/" />
  </switch>
</proxy>

Attributes

NameRequiredDefaultDescriptionExample
blockRequest false false
legacy attribute for usage by Membrane Monitor
-
port false 80
The port Membrane listens on for incoming connections.
8080
ip false not set
If present, binds the port only on the specified IP. Useful for hosts with multiple IP addresses.
127.0.0.1
name false By default, a name will be automatically generated from the target host, port, etc.
The name as shown in the Admin Console.
-
blockResponse false false
legacy attribute for usage by Membrane Monitor
-

Child Elements

ElementsDescriptionCardinality
ssl Configures the usage of inbound SSL (HTTPS). 0..1
response 0..*
echo 0..*
request 0..*
abort 0..*

Other optional Child Elements

login, webSocket, oauth2authserver, accountRegistration, ntlm, requireAuth, jwtSign, json2Xml, xmlProtection, apiKey, oauth2PermissionChecker, tcp, clusterNotification, for, rewriter, destination, wadlRewriter, if, oauth2Resource2, balancer, statisticsJDBC, prometheus, APIsJSON, logContext, rateLimiter, http2xml, log, replace, transform, global, authHead2Body, dispatching, stompClient, cors, xml2Json, setProperty, openTelemetry, jsonProtection, flowInitiator, headerFilter, acmeHttpChallenge, accessControl, clamav, urlNormalizer, call, cache, xmlContentFilter, counter, groovyTemplate, wsdlRewriter, index, template, openapiValidator, reverseProxying, methodOverride, wsdlPublisher, setHeader, userFeature, adminConsole, statisticsCSV, return, soapBody, greaser, soapOperationExtractor, adminApi, shutdown, xenAuthentication, ruleMatching, static, limit, internalRouting, accessLog, kubernetesValidation, apiDocs, paddingHeader, validator, throttle, webServer, rest2Soap, regExReplacer, webServiceExplorer, interceptor, graphQLProtection, analyser, jwtAuth, openapiPublisher, httpClient, soapStackTraceFilter, groovy, tokenValidator, sampleSoapService, formValidation, beautifier, statisticsProvider, testService, shadowing, chain, choose, basicAuthentication, soap2Rest, javascript, exchangeStore