Chapter 4. Managing externally signed certificates for IdM users, hosts, and services
Administrators use the Identity Management (IdM) command-line interface (CLI) and IdM Web UI to associate externally signed certificates with internal accounts. This integration allows users, hosts, and services to authenticate using credentials issued by third-party or corporate Certificate Authorities.
4.1. Adding a certificate issued by an external CA to an IdM user, host, or service by using the IdM CLI Copy linkLink copied to clipboard!
The ipa command-line tools enable administrators to attach specific external certificates to IdM entities. Commands such as ipa user-add-cert accept Base64-encoded strings, linking the external credential directly to the specified user, host, or service account.
Prerequisites
- You have obtained the ticket-granting ticket of an administrative user.
Procedure
To add a certificate to an IdM user, enter:
ipa user-add-cert user --certificate=MIQTPrajQAwg...
$ ipa user-add-cert user --certificate=MIQTPrajQAwg...Copy to Clipboard Copied! Toggle word wrap Toggle overflow Specify the following information:
- The name of the user
The Base64-encoded DER certificate
NoteInstead of copying and pasting the certificate contents into the command line, you can convert the certificate to the DER format and then re-encode it to Base64. For example, to add the
user_cert.pemcertificate touser, enter:ipa user-add-cert user --certificate="$(openssl x509 -outform der -in user_cert.pem | base64 -w 0)"
$ ipa user-add-cert user --certificate="$(openssl x509 -outform der -in user_cert.pem | base64 -w 0)"Copy to Clipboard Copied! Toggle word wrap Toggle overflow
You can run the
ipa user-add-certcommand interactively by executing it without adding any options.-
To add a certificate to an IdM host, enter:
ipa host-add-cert -
To add a certificate to an IdM service, enter:
ipa service-add-cert
4.2. Adding a certificate issued by an external CA to an IdM user, host, or service by using the IdM Web UI Copy linkLink copied to clipboard!
The IdM Web UI offers a graphical interface for uploading external certificates. Administrators navigate to the target entity’s profile page and paste the PEM or Base64-encoded certificate data directly into the configuration field to associate it.
Prerequisites
- You are logged in to the Identity Management (IdM) Web UI as an administrative user.
Procedure
-
Open the
Identitytab, and select theUsers,Hosts, orServicessubtab. - Click the name of the user, host, or service to open its configuration page.
Click next to the
Certificatesentry.Adding a certificate to a user account
- Paste the certificate in Base64 or PEM encoded format into the text field, and click .
- Click to store the changes.
4.3. Removing a certificate issued by an external CA from an IdM user, host, or service account by using the IdM CLI Copy linkLink copied to clipboard!
As an Identity Management (IdM) administrator, you can remove an externally signed certificate from the account of an IdM user, host, or service by using the Identity Management (IdM) CLI .
Prerequisites
- You have obtained the ticket-granting ticket of an administrative user.
Procedure
To remove a certificate from an IdM user, enter:
ipa user-remove-cert user --certificate=MIQTPrajQAwg...
$ ipa user-remove-cert user --certificate=MIQTPrajQAwg...Copy to Clipboard Copied! Toggle word wrap Toggle overflow Alternatively, you can run the
ipa user-remove-certcommand interactively by executing it without adding any options.Specify the following information:
- The name of the user
- The Base64-encoded DER certificate
NoteInstead of copying and pasting the certificate contents into the command line, you can convert the certificate to the DER format and then re-encode it to Base64. For example, to remove the
user_cert.pemcertificate fromuser, enter:ipa user-remove-cert user --certificate="$(openssl x509 -outform der -in user_cert.pem | base64 -w 0)"
$ ipa user-remove-cert user --certificate="$(openssl x509 -outform der -in user_cert.pem | base64 -w 0)"Copy to Clipboard Copied! Toggle word wrap Toggle overflow To remove a certificate from an IdM host, enter:
-
ipa host-remove-cert
-
To remove a certificate from an IdM service, enter:
-
ipa service-remove-cert
-
4.4. Removing a certificate issued by an external CA from an IdM user, host, or service account by using the IdM Web UI Copy linkLink copied to clipboard!
As an Identity Management (IdM) administrator, you can remove an externally signed certificate from the account of an IdM user, host, or service by using the Identity Management (IdM) Web UI.
Prerequisites
- You are logged in to the Identity Management (IdM) Web UI as an administrative user.
Procedure
-
Open the
Identitytab, and select theUsers,Hosts, orServicessubtab. - Click the name of the user, host, or service to open its configuration page.
- Click the next to the certificate to delete, and select .
- Click to store the changes.