How to set up Atlassian-User-LDAP-Integration for new installations

If you have a brand new Confluence installation and:

• you are not upgrading from an older version and
• do not have any users set up beyond the admin account created during the setup wizard

This document will run you through how you can plug Confluence up with the new Atlassian-User-LDAP-Integration.

Download sample atlassianUserContext.xml

Download hibernate_ldap_cache_atlassianUserContext.xml and rename to atlassianUserContext.xml and copy it to your confluence/WEB-INF/classes directory.

Set up the Administrator Account

Now that you have plugged Confluence into LDAP, you need to set up an admin account (Confluence cannot access the original admin account you created, because you have switched over to using LDAP as your main user repository).

1. Either create a new LDAP user account called 'admin' or elect your own LDAP user account to be the administrator account.
2. Now create two LDAP groups: confluence-administrators and confluence-users.
3. Grant the admin account membership to these groups.

You should now be able to log into Confluence with this account and have full administrative rights.

To enable a user in your LDAP system to access Confluence, you need to do one of the following:

• grant the LDAP user account membership to confluence-users inside LDAP or
• log in as admin, goto Administration > Global Permissions and grant an LDAP group the Confluence 'USE' permission. This will effectively give all LDAP user accounts in that group access to Confluence.