The user directories health check ensures that a connection between Confluence and supported user directories can be established in a healthy manner. Only enabled user directories are tested by this health check.

Currently, the health check supports two types of user directories:

• LDAP

• Crowd

Understanding the results

In the following tables, learn how to interpret the results of the health check for LDAP and Crowd.

LDAP

Indicator	Result	Interpretation
Pass	No supported user directories were found.	Currently, there are no enabled or configured LDAP user directories.
Pass	The provided LDAP credentials are valid.	The connection between Confluence and a user directory can be established and authentication has been successful.
Warning	The connection to the LDAP server can't be established.	The connection between Confluence and an LDAP user directory can’t be established.
Error	The provided credentials were rejected by the LDAP server <user_directory_name>. Checks if the user and password provided by the user directory configuration to access the LDAP server are valid.	The connection between Confluence and an LDAP user directory can be established but the authentication process has failed.

Crowd

Indicator	Result	Interpretation
Pass	No supported user directories were found.	Currently, there are no enabled or configured Crowd user directories.
Pass	The provided Crowd credentials are valid.	The connection between Confluence and a user directory can be established and authentication has been successful.
Warning	The connection to the Crowd server can't be established.	The connection between Confluence and a Crowd user directory can’t be established.
Error	The credentials provided were rejected by the Crowd server. Checks if the user and password provided by the user directory configuration to access the Crowd server are valid.	The connection between Confluence and a Crowd user directory can be established but the authentication process has failed.

What happens when I ignore the warning?

If a connection to a user directory can’t be established or the authentication process is failing, users won’t be able to access the authentication service. Depending on the authentication directory order and the availability of other directories, users might encounter issues while trying to log in to the application or won’t be able to refresh their authentication token, thus losing the ability to interact with the application.

Troubleshooting

Authentication failure

Go to your user directory configuration and confirm that the provided user and password are valid.

Connectivity failure

Check the connection and healthiness of the machine that the user directory is running on. To review common LDAP user directory issues, reference Common user management errors.