Jama Connect User Guide

Troubleshoot LDAP errors

When configuring LDAP these errors might occur:

Exception

Reason

"Unable to communicate with LDAP server; nested exception is javax.naming.CommunicationException: localhost:389 [Root exception is java.net.ConnectException: Connection refused: connect]"

Can't connect to the server. Check the URL and make sure port 389 is open.

"Operation failed; nested exception is javax.naming.AuthenticationException: [LDAP: error code 49 - Invalid Credentials]"

Either the BindDn or password is not correct.

"Can't find user"

This indicates the Base Dn, Bind Dn, and Bind Password can be connected to accurately (a good connection to LDAP). Either the Login Name Attribute was not filled in correctly or the Sample User does not exist in the Base Dn indicated.

"Can't authenticate user''

The sample user password is incorrect however this indicates a successful connection to LDAP and that the sample user was found in the Base Dn.

"Operation failed; nested exception is javax.naming.PartialResultException: Unprocessed Continuation Reference(s); remaining name ''

The cause is usually the base URL is not complete (too broad).

"Operation failed; nested exception is javax.naming.ServiceUnavailableException: adunit:636; socket closed. Port 636 is for SSL."

Either SSL is not supported by Spring LDAP or Certificate is not correct. Try using ldaps protocol, for example : ldaps://myserver.example.com:636.

Be sure you have entered the correct information for the type of LDAP you are configuring:

  • Active Directory

    URL: 'ldap://localhost:389'

    Base Dn: 'ou=Users,dc=jamasoftware,dc=com'

    Bind Dn: 'cn=Admin,ou=Admin Users,dc=jamasoftware,dc=com'

    Bind Password: 'password'

    Login Name Attribute: 'sAmAccountName'

    Email Attribute: 'email'

    User Name Attribute: 'displayName'

    Sample User: 'admin'

    Sample User Password: 'password'

  • LDAP

    URL: 'ldap://localhost:389'

    Base Dn: 'ou=Users,dc=jamasoftware,dc=com'

    Bind Dn: 'cn=Admin,ou=Admin Users,dc=jamasoftware,dc=com'

    Bind Password: 'password'

    Login Name Attribute: 'uid'

    Email Attribute: 'mail'

    User Name Attribute: 'cn'

    Sample User: 'admin'

    Sample User Password: 'password'

Important

If you are using SSL then it will be necessary to use the ldaps protocol. Example: ldaps://myserver.example.com:636

The Base Dn and Bind Dn values do not accept a domain only value. At least one additional level is required such as the 'ou=Users' seen in the example above.

Take note of the "Can't find/authenticate user" errors. These often indicate a successful connection but that the Sample User/Password are incorrect. 

Important

The Sample User and Password fields are deleted every time the configuration window is closed.