2.3. Configuration Preparation

2.3. Configuration Preparation

2.3.1. Required Information

When the Certificate System subsystems are configured, some outside information must be available. This includes the following:

  • Login PIN.

    There is a randomly-generated PIN in the preop.pin parameter in the CS.cfg file in the instance conf/ directory. This is used to log into the configuration wizard.

  • Security domain information.

    CAs can create a new security domain, which requires a unique name and a username and password for the CA agent who administers the domain.

    All other subsystems must join an existing security name. Have the username and password of the CA agent who administers the domain.

  • CA information.

    If the subsystem is not a CA, then it is necessary to select a CA from a drop-down menu or add an external CA. If a Certificate System CA is selected, then supply the CA agent username and password.

  • Subsystem information.

    When installing a TPS, the CA and TKS subsystems must be installed and configured before installing the TPS; a DRM subsystem must also be installed and configured if server-side key generation is selected. When configuring the TPS, the TKS and DRM to connect with the TPS are selected from a drop-down list of all subsystems within the security domain. The bind information for the selected subsystems must be available.

  • Directory Server hostname and port number.

    The Certificate System uses the user database of the Directory Server to store its information, and the hostname and port number of the LDAP directory is required for the Certificate System to access the database.

  • Directory Manager DN and password.

    The Certificate System must be able to bind to the user database, so a user ID and password must be supplied to bind to the Directory Server. This user is normally the Directory Manager. The default Directory Manager DN is cn=Directory Manager.

  • Certificate and key recovery files.

    If the subsystem being configured is a clone of another subsystem, then the backup files for the master subsystem must be locally accessible.

2.3.2. Default Settings

The ports and file directories in Table 2.16, “Default Subsystem Instance Ports and File Locations” show the default installation and configuration information.

Susbsystem SSL Port Non-SSL Port Instance Directory
CA 9443 9080 /var/lib/rhpki-ca
DRM 10443 10080 /var/lib/rhpki-kra
OCSP 11443 11080 /var/lib/rhpki-ocsp
TKS 13443 13080 /var/lib/rhpki-tks
TPS 7889 7888 /var/lib/rhpki-tps

Table 2.16. Default Subsystem Instance Ports and File Locations

The following certificates are created by default when any of the following subsystem instances are installed:

  • Certificate Manager

    • CA signing certificate

    • OCSP signing certificate (for the CA's internal OCSP service)

    • SSL server certificate

    • Subsystem certificate

      The subsystem certificate is always issued by the security domain so that domain-level operations that require client authentication are based on this subsystem certificate.

  • DRM

    • Transport certificate

    • Storage certificate

    • SSL server certificate

    • Subsystem certificate

  • OCSP

    • OCSP signing certificate

    • SSL server certificate

    • Subsystem certificate

  • TKS

    • SSL server certificate

    • Subsystem certificate

  • TPS

    • SSL server certificate

    • Subsystem certificate