Skip to content

Apache Directory Studio (For Admins)

Executables (both Apache Directory Studio and Java) can be found here.

Once the installation succeeds, open the Apache Directory Studio.

1. Creating the LDAP Connection

  1. Go to File → new → ldap browser → ldap connection → next.
  2. Enter your details:
  3. Connection Name: LDAP Server
  4. Hostname: hostname.YOUR-DOMAIN.edu.gh
  5. Port: 389
  6. Encrypted Method: Use STARTTLS
  7. Provider: Apache Directory LDAP Client API
  8. Click Next.
  9. Authentication Method: Simple Authentication
  10. Bind Dn: cn=admin,dc=YOUR-DOMAIN,dc=edu,dc=gh
  11. Bind Password: (your password)
  12. Click "Check Authentication" to make sure your credentials work. For the first time, it asks to trust the self-signed certificate.
  13. Select "Always trust this Certificate" and click OK.
  14. Then click Finish.

To connect, double-click the connection just created from Connections list.

Once connected, you can browse through the directory using the LDAP Browser.

When modifying entries, you may use an LDIF file or the GUI.

2. Using GUI to Create an OU

  1. Select the root location for the OU (e.g., dc=YOUR DOMAIN,dc=edu,dc=gh).
  2. Select "New Entry" on the Right-click Menu.
  3. Then "Create entry from Scratch" → Next.
  4. Select "OrganizationalUnit" and click "Add" and "Next."
  5. Type "OU" as the RDN and the desired value in front of it, then click "Next" and "Finish."

3. Adding a User Group

  1. Select the root location for the OU (e.g., ou=Group,dc=YOUR-DOMAIN,dc=edu,dc=gh).
  2. Select "New Entry" on the Right-click Menu.
  3. Then "Create entry from Scratch" → Next.
  4. Select "groupofNames" and click "Add" and "Next."
  5. Type "CN" as the RDN and the desired value in front of it, then click "Next."
  6. You will be prompted with a user add window as DN Editor. Select a user from the browser and click OK.

4. Adding a New User

  1. Select the root location for the OU (e.g., ou=People,dc=YOUR-DOMAIN,dc=ac,dc=lk).
  2. Select "New Entry" on the Right-click Menu.
  3. Then "Create entry from Scratch" → Next.
  4. Select "inetOrgPerson" and click "Add."
  5. Select "eduPerson" and click "Add" and "Next."
  6. Type "uid" as the RDN and the desired username value in front of it, then "Next."
  7. Enter desired values for "cn" (First Name) and "sn" (last Name).
  8. Enter a new attribute from the right-click menu as "userPassword" and click "Finish." When it asks, enter the new user's password and select "Plaintext" as the hash method and click OK.
  9. You may add any other attribute as well.
  10. Then click "Finish."

More documentation can be found on the Apache Directory Studio User's Guide.