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

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

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

Disabling the Default Trust Behavior of the IBM Lotus Domino 7.0 Agent on AIX 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 web agent does not perform certificate checking. On AIX 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.

To Disable the Default Trust Behavior of the IBM Lotus Domino 7.0 Agent on AIX 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/domino/cert

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 IBM Lotus Domino 7.0 Instance on AIX 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 AIX Systems

The following steps outline a method for installing Access Manager Root CA Certificate on the IBM Lotus Domino 7.0 server. However, see the documentation for the IBM Lotus Domino 7.0 server for more information about installing certificates.

1. (Conditional) If the certificate database has not yet been created, create it at a unique location using a command such as the following:

   # PolicyAgent-base/agents/bin/certutil -N -d .

2. Install the root CA certificate.

   Remember that the root CA certificate that you install on the IBM Lotus Domino 7.0 server must be the same certificate that is installed on the Access Manager host.

   The following example demonstrates a command you can issue that uses the certutil utility to install the certificate:

   # PolicyAgent-base/agents/bin/certutil -A -n cert-name -t "C,C,C" -d cert-dir -i cert-file

   cert-name

   The name for this root CA certificate.

   cert-dir

   The directory where the certificate and key stores are located.

   cert-file

   The base-64 encoded root CA certificate file.

   For more information on the cetrutil utility enter cetrutil -H for Help.

3. To verify that the certificate is properly installed, in the command line, issue the following command:

   PolicyAgent-base/agents/bin/certutil -L -d cert-dir

   The root CA certificate is then listed in the output of the certutil -L command as illustrated in the following code example:

   Certificate Name Trust Attrubutes cert-name C,C,C p Valid peer P Trusted peer (implies c) c Valid CA T Trusted CA to issue client certs (implies c) C Trusted CA to certs(only server certs for ssl) (implies c) u User cert w Send warning

4. Restart the IBM Lotus Domino 7.0 server.