Sun Java System Access Manager Policy Agent 2.2 Guide for Sun Java System Web Proxy Server 4.0

Default Trust Behavior of Agent for Sun Java System Web Proxy Server 4.0 on Solaris Systems

This section only applies when Access Manager itself is running SSL. By default, the agent installed on a remote Sun Java System Web Proxy Server 4.0 instance trusts any server certificate presented over SSL by the Access Manager host. The agent does not check the root Certificate Authority (CA) certificate. If the Access Manager host is SSL-enabled and you want the agent to perform certificate checking, adhere to the guidelines as described in the following subsections:

Disabling the Default Trust Behavior of Agent for Sun Java System Web Proxy Server 4.0 on Solaris Systems

The following property in the web agent AMAgent.properties configuration file controls the agent’s trust behavior, and by default it is set to true:

com.sun.am.trust_server_certs

With this property set to true, the agent does not perform certificate checking. On Solaris systems, setting this property to false is one of the steps involved in enabling the web agent to perform certificate checking as illustrated in the following task.

ProcedureTo Disable the Default Trust Behavior of Agent for Sun Java System Web Proxy Server 4.0 on Solaris Systems

  1. Set the following property in the web agent AMAgent.properties configuration file to false as follows:

    com.sun.am.trust_server_certs = false
  2. Set the directory Cert DB in the web agent AMAgent.properties configuration file as shown in the following example:

    com.sun.am.sslcert.dir = /opt/SUNWam/servers/alias

  3. Set the Cert DB Prefix, if required.

    In cases where the specified Cert DB directory has multiple certificate databases, the following property must be set to the prefix of the certificate database to be used:

    com.sun.am.certdb.prefix

    Set the property as follows:


    com.sun.am.certdb.prefix = https-host.domain.com.host-

Installing the Access Manager Root CA Certificate for a Remote Sun Java System Web Proxy Server 4.0 Instance on Solaris Systems

The root CA certificate that you install on the remote instance of Sun Java System Web Proxy Server 4.0 must be the same one that is installed on the Access Manager host.

ProcedureTo Install the Access Manager Root CA Certificate on Sun Java System Web Proxy Server 4.0 on Solaris Systems

  1. For instructions on installing a root CA certificate, see the documentation for Sun Java System Web Proxy Server 4.0. For example, see Sun Java System Web Proxy Server 4.0.2 2005Q4 Administration Guide.