Skip to main content

Developing with XCC

XCC Reverse Proxy Support

Note

This feature took effect in MarkLogic Server 11.1.0.

XCC supports connecting to MarkLogic Server through a reverse proxy using path-based routing.

Note

Digest and certificate authentication are not currently supported when running behind a reverse proxy or a load balancer configured with path-based routing. Configure the MarkLogic app servers to use either basic auth over HTTPS or one of the other supported authentication mechanisms.

For path-based routing, when constructing ContentSource objects, you must pass these parameters:

  • basePath: URL that maps to a port on the destination MarkLogic application server.

    Note

    When basePath is specified, xcc.httpcompliant is automatically set to true, and you must configure your reverse proxy to use session affinity.

  • host: URL of the reverse proxy.

  • port: URL of port that the reverse proxy listens to.

For more details, see the ContentSourceFactory methods.