Chapter 69. Verifying your IdM and AD trust configuration using IdM Healthcheck

This section helps you understand and use the Healthcheck tool in Identity management (IdM) to identify issues with IdM and an Active Directory trust.

For details, see Section 67.1, “Healthcheck in IdM”.


  • The Healthcheck tool is only available on RHEL 8.1 or newer

69.1. IdM and AD trust Healthcheck tests

The Healthcheck tool includes several tests for testing the status of your Identity Management (IdM) and Active Directory (AD) trust.

To see all trust tests, run ipa-healthcheck with the --list-sources option:

# ipa-healthcheck --list-sources

You can find all tests under the source:

This test checks the SSSD configuration when the machine is configured as a trust agent. For each domain in /etc/sssd/sssd.conf where id_provider=ipa ensure that ipa_server_mode is True.
This test checks if the trust domains match SSSD domains by comparing the list of domains in sssctl domain-list with the list of domains from ipa trust-find excluding the IPA domain.

This test resolves resolves an AD user, Administrator@REALM. This populates the AD Global catalog and AD Domain Controller values in sssctl domain-status output.

For each trust domain look up the user with the id of the SID + 500 (the administrator) and then check the output of sssctl domain-status <domain> --active-server to ensure that the domain is active.

This test verifies that the sidgen plugin is enabled in the IPA 389-ds instance. The test also verifies that the IPA SIDGEN and ipa-sidgen-task plugins in cn=plugins,cn=config include the nsslapd-pluginEnabled option.
This test verifies that the current host is a member of cn=adtrust agents,cn=sysaccounts,cn=etc,SUFFIX.
This test verifies that the current host is a member of cn=adtrust agents,cn=sysaccounts,cn=etc,SUFFIX.
This test verifies that the current host starts the ADTRUST service in ipactl.
This test verifies that ldapi is enabled for the passdb backend in the output of net conf list.
This test verifies that the admins group’s SID ends with 512 (Domain Admins RID).
This test verifies that the trust-ad package is installed if the trust controller and AD trust are not enabled.

Run these tests on all IdM master servers when trying to find an issue.

69.2. Screening the trust with the Healthcheck tool

This section describes a standalone manual test of an Identity Management (IdM) and Active Directory (AD) trust health check using the Healthcheck tool.

The Healthcheck tool includes many tests, therefore, you can shorten the results by:

  • excluding all successful test: --failures-only
  • including only trust tests:


  • To run Healthcheck with warnings, errors and critical issues in the trust, enter:

    # ipa-healthcheck --failures-only

Successful test displays empty brackets:

# ipa-healthcheck --failures-only

Additional resources

  • For reviewing detailed reference, enter man ipa-healthcheck in the command line.