Technical Documents

How to Install Certificates on FreeIPA

Fedora

The dogtag packages are now available in Fedora. The required packages should be pulled in as dependencies when ipa-server is installed.

This just makes the binaries available for the IPA installer script. The installer creates and configures the necessary dogtag components to stand up a CA.

Installing

A dogtag CA is installed by default by IPA. To install using a self-signed CA instead of dogtag pass in the --selfsignargument to ipa-server-install.

The CA uses a separate instance of DS that is used only for the CA. This instance is named PKI-IPA.

It will install a CA instance into /var/lib/pki-ca.

A copy of the root CA certificate and private key will be put into /root/cacert.p12.

A copy of the CA agent certificate will be put into /root/ca-agent.p12. This agent certificate can be imported into a browser and used to administer CS using the web interface (not recommended).

Use a Different CA (COMODO) to sign the IPA CA certificate

If you have an existing CA you can use it make the IPA CA a subordinate.

This is a three-step process:

  • Have ipa-server-install generate a Certificate Signing Request (CSR)
  • Take the CSR to your CA and have it signed
  • Provide the resulting certificate to ipa-server-install to complete the installation

Detailed instructions

Run ipa-server-install with whatever arguments are appropriate for your environment and include the --external_caflag:

# ipa-server-install --external-ca
 

This will generate a CSR in /root/ipa.csr. This is the file you need to provide to your CA for signing. You will also need to obtain a PEM copy of your CA trust chain.

Once you have both of these you can continue the installer:

# ipa-server-install --external_cert_file=/root/ipa.crt --external_ca_file=/root/existing_ca.crt
 

The server caches the answers the first time you run the installer so you don't need to answer the questions again the second time. This cache is removed when the installer is run again.

The paths to the certificate and CA must be absolute paths. The dogtag silent installer will fail if they are not.

Once the installation is complete you will have the same files as a standalone IPA CA: /root/cacert.p12 and /root/ca-agent.p12.

The only difference is that the CA certificate is signed by your external CA in this mode and self-signed in the default mode.

Using Certificates From a Different CA (COMODO)

If don't you want to use the new IPA CA features at all that is ok but you'll need to take a few extra steps.

There are two ways to achieve this:

  • Install IPA using the selfsign CA and replace the server certs post-installation
  • Provide PKCS#12 files to the installer (and still use the selfsign CA, it just won't generate any certs)

The step setting enable_ra to False disables the cert plugin in the XML-RPC interface. Your IPA server will be unable to issue certificates.

Install and Replace

To use the Install and Replace method do the following:

  • Install IPA server with the --selfsign option
  • Once IPA is up and working run ipa-server-certinstall once for the DS and once for Apache to replace the server certificates
  • If you want the Firefox autoconfiguration to work use an object signing certificate to sign the jar file in /usr/share/ipa/html/configure.jar
  • Replace the CA certificate in /etc/ipa/ca.crt and /usr/share/ipa/html/ca.crt
  • Edit /etc/ipa/default.conf and set enable_ra to False
  • Restart Apache

Install with your own certificates

To use the Install your own method do the following:

  • Install IPA server with the --http_pkcs12 and --dirsrv_pkcs12 and their respective pin arguments. Your PKCS#12 files should contain the server cert, key and the CA cert chain.
  • If you want the Firefox autoconfiguration to work use an object signing certificate to sign the jar file in /usr/share/ipa/html/configure.jar
  • Verify that the CA certificate in /etc/ipa/ca.crt and /usr/share/ipa/html/ca.crt are correct
  • Edit /etc/ipa/default.conf and set enable_ra to False
  • Restart Apache