LocationHeaderFilter

For a response that generates a redirect to the proxied application, this filter rewrites the Location header on the response to redirect the user to PingGateway.

Usage

{
    "name": string,
    "type": "LocationHeaderFilter",
    "config": {
        "baseURI": runtime expression<url>
    }
}

An alternative value for type is RedirectFilter.

Properties

"baseURI": runtime expression<url>,optional: The base URI of the PingGateway instance. This is used to rewrite the Location header on the response.

The result of the expression must be a string that represents a valid URI, but isn’t a real java.net.URI object. For example, it would be incorrect to use ${request.uri}, which isn’t a String but a MutableUri.

Default: Redirect to the original URI specified in the request.

Learn more in Expressions.

Example

In the following example, PingGateway listens on https://ig.example.com:8443 and the application it protects listens on https://app.example.com:8444. The filter rewrites redirects that would normally take the user to locations under https://app.example.com:8444 to go instead to locations under https://ig.example.com:8443.

{
     "name": "LocationRewriter",
     "type": "LocationHeaderFilter",
     "config": {
         "baseURI": "https://ig.example.com:8443"
      }
}

More information

org.forgerock.openig.filter.LocationHeaderFilter