Previously, if a load balancer or proxy was configured in front of the Microsoft IIS 6.0 agent and a user attempted to access a protected resource from a machine whose IP was in the not-enforced client IP list, the user would be redirected to the Access Manager or OpenSSO server, since the agent used the IP of the proxy instead of the client machine.
The Policy Agent Update 2.2-04 release includes the following new properties in AMAgent.properties that you can set if a load balancer is deployed in front of the IIS 6.0 agent and you want the agent to evaluate the request against the not-enforced client IP list:
com.sun.agents.load_balancer.enable enables (true) or disables (false) the option to evaluate the request against the not-enforced client IP list, if a load balancer is deployed in front of the IIS 6.0 agent. The default is false. The following two properties are not used unless this property has a value of true.
com.sun.am.policy.agents.config.client.ip.header is the name of the HTTP header that contains client IP, which depends on the type of load balancer you are using. If not used, leave this property blank.
com.sun.am.policy.agents.config.client.hostname.header is the name of the HTTP header that contains the hostname of the client. If not used, leave this property blank.
After you set these properties, restart the IIS 6.0 instance.
Note. These new properties apply only to the IIS 6.0 agent. CR 6894700 fixes the 32-bit IIS 6.0 agent, and CR 6864977 fixes the 64-bit IIS 6.0 agent and OWA.
For web agents that support POST data preservation and are deployed behind a load balancer, the Policy Agent 2.2-04 update release includes the new com.sun.am.policy.agents.config.postdata.preserve.lbcookie property in AMAgent.properties to ensure that the POST data are preserved when using the load balancer.
To use this feature, set the following properties in the AMAgent.properties file:
com.sun.am.policy.agents.config.postdata.preserve.enable = true com.sun.am.policy.agents.config.postdata.preserve.lbcookie = palbcookie=01
After you set these properties, restart the web agent container.
Note. The new com.sun.am.policy.agents.config.postdata.preserve.lbcookie property applies only to the IIS 6.0, Web Server 6.1, and Web Server 7.0 agents, which are the only agents that support POST data preservation.
The version 2.2–04 Apache HTTP Server 2.0.x and Apache HTTP Server 2.2.x agents can use the new com.sun.am.policy.agents.config.encode_cookie_special_chars.enable property in AMAgent.properties to enable encoding for special characters in cookies. The default value for this property is false.
To enable the encoding, set the property to true and restart the Apache HTTP Server web container.
The Policy Agent 2.2-04 update release now has two properties related to the path info, allowing you to decouple the possibility to ignore the path info for the policy evaluation from the possibility to ignore the path info when evaluating the URL against the not-enforced list. These properties are:
The com.sun.am.policy.agents.config.ignore_path_info property existed in the previous releases. In the Policy Agent 2.2-04 update release, this property indicates only whether the path information and query should be stripped from the request URL before the URL is evaluated by Access Manager. The default value is false.
The new com.sun.am.policy.agents.config.ignore_path_info_for_not_enforced_list property indicates whether the path information and query should be stripped from the request URL before being compared with the URLs of the not-enforced list when those URLs contain a wild-card (*) character. For security reasons, the default value is true.
On Solaris and Linux systems, web agents in the Policy Agent 2.2-04 update release now include the following Sun NSS and NSPR libraries:
These libraries are already included on other operating systems.