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 bothlang
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 |
|
Property aliases |
|
Type |
List |
Bootstrap property |
No |
Required property |
No |
Restart required |
No |
Local configuration file |
|
AM console tab |
Miscellaneous |