Certificate Authorities
Your Microsoft and EJBCA certificate authorities (CAs) are defined in the Management Portal to support synchronization to the Keyfactor Command database and support . Microsoft CAs in the local in which Keyfactor Command is installed or in a forest in a two-way trust with this forest may be imported from Active Directory or manually configured. Other Microsoft CAs and EJBCA CAs need to be manually configured. During initial provisioning, any domain-joined Microsoft CAs in the primary Active Directory forest will be imported automatically by the Keyfactor Command configuration wizard.
Note: All CAs need to be added manually if you’re using Keyfactor Command on a non-domain-joined server.
Certificate Authorities that need to be added manually include:
- An EJBCA CA
- A domain-joined enterprise or standalone Microsoft CA in a forest with a one-way trust (either direction) with the forest in which Keyfactor Command is installed.
- A domain-joined enterprise or standalone Microsoft CA in a forest that has no trust with the forest in which Keyfactor Command is installed.
- A non-domain-joined standalone Microsoft CA.
-
A Keyfactor CA gateway in the forest in which Keyfactor Command is installed that has not been registered in Active Directory.
The CA gateways are used to access cloud certificate providers (e.g. Entrust) using DCOM. DCOM gateways are available to support Microsoft or EJBCA CAs in remote or cloud environments (e.g. the Cross-Forest Gateway).
Note: Keyfactor CA gateways are not supported in any configuration other than in the same forest in which Keyfactor Command is installed.
-
A Keyfactor AnyCAGateway REST in the forest in which Keyfactor Command is installed that has not been registered in Active Directory.
The AnyCAGateway REST is used to access cloud certificate providers (e.g. Entrust) using HTTPS.
- A Microsoft CA accessed via the Client. This is often used with a managed instance of Keyfactor Command.
- A EJBCA CA accessed via the CA Connector Client. This is often used with a managed instance of Keyfactor Command.
-
A Microsoft CA accessed via the .
Note: You must install and configure the Keyfactor Universal on a machine in the same forest where the Microsoft CA resides and configure it with CA Support and approve the orchestrator in the Management Portal before creating the CA record.
The majority of CA-related functions within Keyfactor Command are supported by both EJBCA and Microsoft CAs. Table 19: CA Function Matrix includes a list of CA-related functions and the support provided by EJBCA and Microsoft CAs.
Important: EJBCA integration with Keyfactor Command requires EJBCA version 7.8.1 or higher.
Table 19: CA Function Matrix
Tips on how to configure various types of CAs:
EJBCA CA
- Select CA Communication Protocol—HTTPS
-
Logical Name—The of the EJBCA CA. For example: CorpCA1
Note: EJBCA CA logical names are case sensitive (e.g. CorpCA1 is not the same as CORPCA1).
-
Host URL—The URL pointing to the EJBCA CA. For example: https://ejbca01.keyother3.com. If the URL provided does not have a virtual directory (/ejbca or otherwise) the /ejbca will be provided, otherwise it will use what is supplied in the URL.
-
Configuration Tenant—A reference ID for the EJBCA CA server. For EJBCA CAs, this does not need to be the domain name. The short of the EJBCA CA server makes a good reference ID.
Important: EJBCA and Microsoft CAs cannot be configured with the same Configuration Tenant, so do not set this to the DNS domain name if you will also be configuring Microsoft CAs in the same DNS domain.
Domain-Joined Enterprise or Standalone Microsoft CA in the Forest in which Keyfactor Command is Installed or in a Two-Way Trust with this Forest
- Select CA Communication Protocol—DCOM
- Logical Name—The logical name of the CA in the local forest. For example: CorpIssuingCA1
- Host Name—The fully qualified domain name of the server on which the CA in the local forest is installed. For example: corpca01.keyexample.com
- Configuration Tenant—The DNS domain name for the Active Directory forest in which the CA resides. For example: keyexample.com
Note: CAs of this type can generally be imported automatically using the Import option—or are imported automatically on install—unless they have not been added to Active Directory.
Non-Domain-Joined Standalone Microsoft CA
- Select CA Communication Protocol—DCOM
- Logical Name—The logical name of the standalone CA. For example: CorpSARootCA1
- Host Name—The fully qualified domain name of the server on which the standalone CA is installed. For example: saroot01.keyexample.com
- Configuration Tenant—The DNS domain name for the standalone CA. For example: keyexample.com
Remote EJBCA CA Accessed via a CA Connector Client
- Select CA Communication Protocol—HTTPS
- Logical Name—The logical name of the CA in the remote forest to which the CA Connector Client will be connecting for synchronization. For example: CorpIssuingCA2
- Host URL—The URL pointing to the CA in the remote forest to which the CA Connector Client will be connecting for synchronization. For example: https://ejbca01.keyother3.com. If the URL provided does not have a virtual directory (/ejbca or otherwise) the /ejbca will be provided, otherwise it will use what is supplied in the URL.
- Configuration Tenant—A reference ID for the EJBCA CA server. For EJBCA CAs, this does not need to be the DNS domain name. The short hostname of the EJBCA CA server makes a good reference ID.
Important: EJBCA and Microsoft CAs cannot be configured with the same Configuration Tenant, so do not set this to the DNS domain name if you will also be configuring Microsoft CAs in the same DNS domain.
Note: You must install and configure the CA Connector Client on a machine in the same environment where the CA resides and configure a CA Connector for it in the Management Portal before creating the CA record.
Remote Microsoft CA Accessed via a CA Connector Client
- Select CA Communication Protocol—DCOM
- Logical Name—The logical name of the CA in the remote forest to which the CA Connector Client will be connecting for synchronization. For example: CorpIssuingCA3
- Host Name—The fully qualified domain name of the CA in the remote forest to which the CA Connector Client will be connecting for synchronization. For example: corpca03.keyother4.com
- Configuration Tenant—The DNS domain name for the Active Directory forest in which the CA Connector Client is operating and in which the CA resides. Or for non-domain-joined standalone CAs, the DNS domain name. For example: keyother4.com
Note: You must install and configure the CA Connector Client on a machine in the same environment where the CA resides and configure a CA Connector for it in the Management Portal before creating the CA record.
Remote Microsoft CA Accessed via a Keyfactor Universal Orchestrator
- Select CA Communication Protocol—DCOM
- Logical Name—The logical name of the CA in the remote forest to which the orchestrator will be connecting for synchronization. For example: Corp4IssuingCA1
- Host Name—The fully qualified domain name of the CA in the remote forest to which the orchestrator will be connecting for synchronization. For example: corp4ca01.keyother4.com
- Configuration Tenant—The DNS domain name for the Active Directory forest in which the orchestrator is operating and in which the CA resides. For example: keyother4.com
Note: You must install and configure the Keyfactor Universal Orchestrator on a machine in the same forest where the CA resides, configure it with CA Support and approve the orchestrator in the Management Portal before creating the CA record.
Keyfactor CA Gateway
- Select CA Communication Protocol—DCOM
- Logical Name—The logical name of the CA gateway in the local forest. For example: EntrustGateway
- Host Name—The fully qualified domain name of the server on which the CA gateway in the local forest is installed. For example: entgtw1.keyexample.com
- Configuration Tenant—The DNS domain name for the Active Directory forest in which the CA resides. For example: keyexample.com
AnyCAGateway REST
- Select CA Communication Protocol—HTTPS
-
Logical Name—The logical name, exactly as entered in AnyCA Gateway portal. The logical name is unique for each CA.
Note: Logical names are case sensitive (e.g. CorpCA1 is not the same as CORPCA1).
- Host URL—The fully qualified domain name of the server on which the gateway is installed and the port number defined in -ServerPort. For example: https://CAGateway24.keyexample.com:8443. The Host URL is unique for each CA.
- Configuration Tenant—A reference ID for the gateway CA. This can be any name you choose, but it should not conflict with other non-related CAs.
Important: HTTPS and DCOM CAs cannot be configured with the same Configuration Tenant, so do not set this to the DNS domain name if you will also be configuring DCOM CAs in the same DNS domain.
Certificate Authority Operations
During installation of Keyfactor Command, CA records are created for any Microsoft CAs found in the local forest in which Keyfactor Command is installed. If you have Microsoft CAs in separate forests in a two-way trust with the forest in which Keyfactor Command is installed, you will need to use the import option to import CA records from those forests. If you have Microsoft CAs in any other configuration or EJBCA CAs, you will need to manually configure CA records for them.
Figure 242: Certificate Authorities Grid
Tip: Click the help icon (
) next to the
Certificate Authorities page title to open the
Keyfactor Software & Documentation Portal to this section. You will receive a prompt indicating:
You are being redirected to an external website. Would you like to proceed?
You can also find the help icon () at the top of the page next to the Log Out button. From here you can choose to open either the Keyfactor Software & Documentation Portal at the home page or the Keyfactor API Endpoint Utility.
Keyfactor provides two sets of documentation: the On-Premises Documentation Suite and the Managed Services Documentation Suite. Which documentation set is accessed is determined by the Application Settings: On-Prem Documentation setting (see Application Settings: Console Tab).