Mastering LDAPS Configuration for Atlassian Tools on Linux


I have recently established a new Domain Controller (DC) and am attempting to configure my Crowd server to interface with it via LDAPS for user synchronization. The previous DC was successfully integrated using LDAPS on port 636, but I am encountering difficulties with the new DC; all functions are operational except for the ability for users to reset their passwords over LDAP on port 389. Currently, this is the sole method that permits user logins to Atlassian applications. Despite extensive troubleshooting, I have been unable to establish a connection using LDAPS on port 636 with the new DC. Following the recommended procedures in Atlassian’s knowledge base, I have imported the new certificate and updated the keystore. The Atlassian tools are hosted on a Linux system, while the DC runs on Windows Server 2022. I would greatly appreciate any guidance on resolving this issue. Additionally, I have provided the error message received during the Crowd to DC connection test using LDAPS on port 636 in the comments below. Thank you in advance for your assistance.


Integrating a new Domain Controller (DC) with Atlassian’s Crowd for user synchronization via LDAPS can be a complex task. This article aims to provide expert guidance on resolving common issues encountered during this process, particularly when all functions are operational except for the ability for users to reset their passwords over LDAP on port 389.

Understanding the Issue

The challenge arises when transitioning from an old DC, where LDAPS on port 636 was functional, to a new DC where difficulties prevent the establishment of a secure connection. This issue is critical as it hinders user logins to Atlassian applications, which rely on password resets over LDAP.

Recommended Solutions


Certificate Trust

: Ensure that the new DC’s certificate is not only imported into the keystore but also trusted by the Linux server hosting the Atlassian tools. This may involve updating the CA certificates on the Linux system.


Firewall and Network Configuration

: Verify that no firewall is blocking port 636 between the Crowd server and the new DC. Additionally, check for any network devices that may be interrupting the LDAPS traffic.


DC Configuration

: Review the configuration settings on Windows Server 2022 to confirm that it is set up to accept LDAPS connections. This includes checking the service bindings and the SSL certificate assignments.


Crowd Configuration

: Double-check the Crowd server’s configuration files to ensure that the correct port, credentials, and connection parameters are being used for the new DC.


Logging and Diagnostics

: Increase the logging level on the Crowd server to capture more detailed information about the connection attempts. This can provide insights into the failure points.


Error Message Analysis

: The error message provided during the connection test can offer valuable clues. Common issues might include expired certificates, incorrect DNS settings, or misconfigured service principals.


Resolving LDAPS connection issues with a new DC involves a systematic approach to troubleshooting. By carefully examining each component of the integration, from certificates to network settings, one can identify and rectify the problem. It is also advisable to consult Atlassian’s support forums and knowledge base for specific guidance related to your environment.


: The error message mentioned in the comments is crucial for a more targeted resolution. It is recommended to share such error messages with support professionals or on technical forums for community-driven troubleshooting.

Leave a Reply

Your email address will not be published. Required fields are marked *

Privacy Terms Contacts About Us