Linux Systems: Using SSL With the IBM Lotus Domino 7.0 Agent

During installation, if you chose the HTTPS protocol, the IBM Lotus Domino 7.0 agent is automatically configured and ready to communicate over SSL. Before proceeding with the following tasks in this section, ensure that IBM Lotus Domino 7.0 is configured for SSL.

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 the IBM Lotus Domino 7.0 server.

To Configure Notifications for the IBM Lotus Domino 7.0 Agent for SSL on Linux Systems

If IBM Lotus Domino 7.0 is running in SSL mode and is receiving notifications, first perform the following broadly defined steps:

1. Add the IBM Lotus Domino 7.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 the IBM Lotus Domino 7.0 agent.

Default Trust Behavior of the IBM Lotus Domino 7.0 Agent on Linux Systems

This section only applies when Access Manager itself is running SSL. By default, the agent installed on a remote IBM Lotus Domino 7.0 instance will trust 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 the IBM Lotus Domino 7.0 Agent on Linux Systems

• Installing the Access Manager Root CA Certificate for a Remote IBM Lotus Domino 7.0 Instance on Linux Systems

Disabling the Default Trust Behavior of the IBM Lotus Domino 7.0 Agent on Linux Systems

The following property in the web agent AMAgent.properties configuration file controls the agent’s trust behavior, which 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 Linux 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.

To Disable the Default Trust Behavior of the IBM Lotus Domino 7.0 Agent on Linux 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 for a Remote IBM Lotus Domino 7.0 Instance on Linux Systems

The root CA certificate that you install on the remote instance of IBM Lotus Domino 7.0 must be the same certificate that is installed on the Access Manager host.

To Install the Access Manager Root CA Certificate on IBM Lotus Domino 7.0 on Linux Systems

1. For instructions on installing a root CA certificate on Linux systems, see the documentation for the IBM Lotus Domino 7.0 server.