Configuring ApacheDS

You must configure ApacheDS before it can be used with the HotDocs Hub.

In this Topic ShowHide

Default Connection

The follow steps describe configuring a default connection between ApacheDS and HotDocs. Please refer to the ApacheDS documentation if you need to create a custom connection.

To configure ApacheDS for use with HotDocs Hub

1. Initial Connection Setup

1. Run Apache Directory Studio.
2. Click Workbench.
3. Right-click in the Connections pane in the bottom left of the window.
4. Select Import > Import Connections from the drop-down menu.
5. Click Browse.
6. Navigate to the LdapFiles folder supplied with your HotDocs Hub installation package.
7. Select the LdapConnection.lbc file.
8. Click Open.
9. Click Finish.
10. Expand the DIT node in the LDAP Browser pane.
11. Select the Root DSE node.
12. Select File > Open File.
13. Navigate to the LdapFiles folder supplied with your HotDocs Hub installation package.
14. Select the LdapInitialSetup.ldif file.
15. Click Open.
16. Click Execute LDIF to execute the selected .ldif file.
17. Select the ldapusers connection from the list.
18. Click OK.

2. Tenancy Configuration

1. Navigate to DIT > Root DSE.
2. Expand the dc=example,dc=com node.
3. Right-click the cn=HotDocs group.
4. Select Properties from the drop-down menu.
5. Click both Refresh button in the Create and Modify Information section.
6. Click the Refresh button in the Sizing Information section.
7. Click OK.
8. Right-click the entryUUID value from the cn=HotDocs group tab.
9. Select Copy Value.
10. Paste and save the value in a text file; the ApacheTenancy setting in the HotDocs Hub post-installation scripts uses this value later.

3. Set the Tenancy Administrator e-mail and password

1. Expand the cn=HotDocs group node.
2. Select the cn=admin user.
3. Edit the Email attribute.
4. Enter the e-mail address for the root user.
5. Right-click the userPassword attribute.
6. Select Edit Value.
7. Navigate to the New Password tab.
8. Enter a password in the Enter New Password field.
9. Enter the password in the Confirm New Password field.
10. Select SSHA-256 from the Select Hash Method drop-down menu.
11. Click OK.

4. Password Lockout Configuration (optional)

Optional: you can change the password policy to disable locking of accounts after five incorrect password attempts.

1. Navigate to ou=config > ads-directoryServiceId=<default> > ou=interceptors > ads-interceptorId=authenticationInterceptor > ou=passwordPolicies > ads-pwdld=default
2. Edit the ads-pwdlockout attribute.
3. Enter FALSE as the value for the attribute.

5. Disable Anonymous Access

You must also disable anonymous access for ApacheDS, to prevent unauthorized users from accessing the server.

1. Navigate to the LDAP Servers pane.
2. Right-click the pane and select New > New Server.
3. Select ApacheDS 2.0.0.
4. Click Finish.
5. Right-click ApacheDS 2.0.0 in the LDAP Servers pane.
6. Select Open Configuration.
7. Uncheck the Allow anonymous access setting.
8. Select File > Save to save the configuration.

Next Steps

Install HotDocs Hub with User Management.