Symas OpenLDAP Knowledge Base

Linking Database to Apache Directory Studio

Linking Example Database to Apache Directory Studio

You will have to execute the exampledb.sh in order for it to be running. In the directory opt/symas/share/symas/ execute exampled.sh

    ./exampledb.sh
    choose cn=config (2). 

This will prompt you to delete any other databases to make room for the one currently executing. Type YES to start the process, and YES again to allow the search.

Setting up the Database within Adobe Apache Directory Studio

Since we will be adding a new directory to the list of directories you will have access to, we will pay our attention to the bottom-left corner where databases will be listed. Within this box, there are multiple buttons that allow us to control our databases. These five icons serve five different purposes, such as :

  • New Connection: Creates a new connection between Apache Directory Studio and an established database configuration.
  • Open Connection: Connects to an established new connection and allows Apache Directory Studio to visualize and edit the entries.
  • Close Connection: Cease the connection with the database, but remain an option within the program.
  • Expand All: This will open all connected databases presently held within the window
  • Collapse All: This will minimize all connected databases presently held within the window.

We will click on “New Connection” to connect our database to the program. This will bring up a prompted menu that step-by-step will ask us for data from our database to help connect.

Network Parameters

Network Parameters
  1. Connection Name: choose a title for your connected database that will be displayed within the bottom-left menu. For this exercise we will put “Exampe Database”
  2. Hostname: Retrieve your IP address associated with your database configuration and enter it in here.
  3. Port: This should be set to port 389, which is specifically used for LDAP directories according to internet protocol

NOTE: Depending on your configuration and your firewall settings, this port may in the future be set to 389, 636, 3268 or 3269. Each one of these ports serve a specific purpose and should be researched before using them. In this scenario, example.db will be best suited for port 389 and its specific LDAP configurations.

  1. Connection timeout(s): This will be set to 30 and for the time being, we will keep it set at 30.
  2. Encryption method: If you have a firewall set up on your database, this is a step that will have to be accounted for; otherwise, select “No encryption”.
Check Network Parameter
  1. Click ’Check Network Parameter” to ensure you have the proper data before going further. This should return “The connection was established successfully” with no error.
  2. Click Next

Authentication

Authentication
  1. Make sure the Authentication Method is set to “Simple Authentication”
  2. Authentication Parameters should reflect what your dn= in your example.db. This can be found within /opt/symas/share/symas/exampledb.sh (dc=example,dc=com)
  3. Bind Password: the example password is set to secret
  4. Click “Check Authentication” to make sure the set up is properly input before procedding. This should reutrn with “The authentication was successful”. Below is an example:
Check Authentication
  1. Click next

Browser Options

Browser Options
  1. Set count limits and time limits to 0
  2. Follow referrals automatically
  3. Fetch subentries while browsing
  4. Fetch operational attributes while browsing
  5. Click Finish

If done correctly, this should show dc=example,dc=com as a tree.

Final Look

From this point, you can see the tree presented in the top left window and can edit entries as you please.