Query Parameter List for Policy Evaluation

Retain Query Parameters

A list of query parameters to be retained for policy evaluation and caching purposes. 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 retain all unnamed parameters. For example, myapp.example.com/customers|,lang matches both lang and any unnamed parameters.

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

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

Examples:

org.forgerock.agents.wanted.http.url.param.list[0]=myapp.example.com/news|area

org.forgerock.agents.wanted.http.url.param.list[1]=example.com/news|area,country,location,

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?=bristol&lang=en_GB, where both lang and the unnamed parameter are retained and sorted alphabetically.

Property name

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

Property aliases

org.forgerock.openam.agents.config.conditional.wanted.http.url.params (since 5.6)

org.forgerock.agents.wanted.http.url.param.list (since 5.6)

Type

List

Bootstrap property

No

Required property

No

Restart required

No

Local configuration file

AgentConfig.properties

AM console tab

Miscellaneous