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

Windows Systems: Configuring Agent for Sun Java System Web Proxy Server 4.0

This section provides a task description for the configuration of SSL with Agent for Sun Java System Web Proxy Server 4.0. Perform this task if it applies to your site's deployment.

Windows Systems: Using SSL With Agent for Sun Java System Web Proxy Server 4.0

During installation, if you choose the HTTPS protocol, Agent for Sun Java System Web Proxy Server 4.0 is automatically configured and ready to communicate over SSL. Before proceeding with the tasks in this section, ensure that the Sun Java System Web Proxy Server 4.0 instance is configured for SSL.


Caution – Caution –

You should have a solid understanding of SSL concepts and the security certificates required to enable communication over the HTTPS protocol. See the documentation for Sun Java System Web Proxy Server 4.0.


ProcedureTo Configure Notification on Agent for Sun Java System Web Proxy Server 4.0 for SSL on Windows Systems

If Sun Java System Web Proxy Server 4.0 is running in SSL mode and is receiving notifications, first perform the following broadly defined steps:

  1. Add the Sun Java System Web Proxy Server 4.0 certificate’s root CA certificate to the Access Manager’s certificate database.

  2. Mark the CA root certificate as trusted to enable Access Manager to successfully send notifications to Agent for Sun Java System Web Proxy Server 4.0.

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

This section only applies when Access Manager itself is running SSL. By default, Agent for Sun Java System Web Proxy Server 4.0 trusts any server certificate presented over SSL by the Access Manager host. The web 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 Windows Systems

The following property exists in the web agent AMAgent.properties configuration file, and by default it is set to true:

com.sun.am.trust_server_certs

With this property set to true, the web agent does not perform certificate checking. On Windows systems, enabling the web agent to perform certificate checking is a one-step process that only involves setting this property to false as illustrated in the following task.

ProcedureTo Disable the Default Trust Behavior of Agent for Sun Java System Web Proxy Server 4.0 on Windows 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

Installing the Access Manager Root CA Certificate on Sun Java System Web Proxy Server 4.0 on Windows Systems

The root CA certificate that you install on the Sun Java System Web Proxy Server 4.0 instance that the agent protects 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 Windows 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.