# OpenAM Administration Guide
6.6. Configuring J2EE Policy Agents

Sidebar | Prev | Up | Next

### 6.6.5. Configuring J2EE Policy Agent Miscellaneous Properties

This section covers miscellaneous web agent properties. After creating the agent profile, you access these properties in the OpenAM console under Access Control > `Realm Name` > Agents > J2EE > `Agent Name` > Miscellaneous.

Locale properties

Locale Language

  The default language for the agent.

  Property: `com.sun.identity.agents.config.locale.language`

  Hot swap: no

Locale Country

  The default country for the agent.

  Property: `com.sun.identity.agents.config.locale.country`

  Hot swap: no

Port Check Processing properties

Port Check Enable

  When enabled, activate port checking, correcting requests on the wrong port.

  Property: `com.sun.identity.agents.config.port.check.enable`

Port Check File

  Specifies the name of the file containing the content to handle requests on the wrong port when port checking is enabled.

  Property: `com.sun.identity.agents.config.port.check.file`

Port Check Setting

  Specifies which ports correspond to which protocols. The agent uses the map when handling requests with invalid port numbers during port checking.

  Property: `com.sun.identity.agents.config.port.check.setting`

Bypass Principal List properties

Bypass Principal List

  Specifies a list of principals the agent bypasses for authentication and search purposes, such as `guest` or `testuser`.

  Property: `com.sun.identity.agents.config.bypass.principal`

Agent Password Encryptor properties

Encryption Provider

  Specifies the agent's encryption provider class.

  Default: `com.iplanet.services.util.JCEEncryption`

  Property: `com.iplanet.security.encryptor`

  Hot swap: no

Ignore Path Info properties

Ignore Path Info in Request URL

  When enabled, strip path info from the request URL while doing the Not Enforced List check, and URL policy evaluation. This is designed to prevent a user from accessing a URI by appending the matching pattern in the policy or not enforced list.

  For example, if the not enforced list includes `/*.gif`, then stripping path info from the request URL prevents access to `http://host/index.html` by using `http://host/index.html?hack.gif`.

  Property: `com.sun.identity.agents.config.ignore.path.info`

Deprecated Client Browser User Agent Properties

Goto Parameter Name

  Property used only when CDSSO is enabled. Only change the default value, `goto` when the login URL has a landing page specified such as, `com.sun.identity.agents.config.cdsso.cdcservlet.url = http://openam.example.com:8080/openam/cdcservlet?goto= http://www.example.com/landing.jsp`. The agent uses this parameter to append the original request URL to this cdcserlet URL. The landing page consumes this parameter to redirect to the original URL.

  As an example, if you set this value to `goto2`, then the complete URL sent for authentication is `http://openam.example.com:8080/openam/cdcservlet?goto= http://www.example.com/landing.jsp?goto2=http://www.example.com/original.jsp`.

  Property: `com.sun.identity.agents.config.redirect.param`

Legacy User Agent Support Enable

  When enabled, provide support for legacy browsers.

  Property: `com.sun.identity.agents.config.legacy.support.enable`

Legacy User Agent List

  List of header values that identify legacy browsers. Entries can use the wildcard character, `*`.

  Property: `com.sun.identity.agents.config.legacy.user.agent`

Legacy User Agent Redirect URI

  Specifies a URI the agent uses to redirect legacy user agent requests.

  Property: `com.sun.identity.agents.config.legacy.redirect.uri`