Java Agents 2023.11.1

Remove Query Parameters List for Policy Evaluation

A list of query parameters to be removed from the incoming URL for policy evaluation and caching.

The property has the following format, with no spaces between values:

[Domain[/path]]|parameter[,parameter…​]

Consider the following constraints when constructing the list of parameters:

  • Add a comma (,) character at the beginning or the end of the list to remove all unnamed parameters. The following example would match both lang and any unnamed parameters: myapp.example.com/customers|,lang

  • Add the asterisk (*) character to the list to remove all parameters, including unnamed ones.

  • The remaining parameters (those that do not match the list of parameters) are sorted alphabetically.

Examples:

org.forgerock.agents.unwanted.http.url.param.list[0]=myapp.example.com/customers|location,lang

org.forgerock.agents.unwanted.http.url.param.list[1]=example.com/customers|*

The following incoming URL request matches a rule such as myapp.example.com/customers|,lang:

http://myapp.example.com/customers?country=uk&=bristol&lang=en_GB&area=1343456

It is cached by the agent as http://myapp.example.com/customers?area=1343456&country=uk, where both lang and the unnamed parameter are removed and the rest of the parameters are sorted alphabetically.

Property name

org.forgerock.agents.unwanted.http.url.param.list

Aliases

org.forgerock.agents.unwanted.http.url.param.list
  Introduced in Java Agent 5.6

org.forgerock.openam.agents.config.conditional.unwanted.http.url.params
  Introduced in Java Agent 5.6
  Recognized from AM 7

Function

Query parameter

Type

List

Bootstrap property

No

Required property

No

Restart required

No

Local configuration file

AgentConfig.properties

AM console

Tab: Miscellaneous (from AM 7)

Title: Remove Query Parameters List for Policy Evaluation

Legacy title: Remove Query Parameters