Getting started with ApacheDS – LDAP Server and Directory Studio

0
Share this on .. Tweet about this on TwitterShare on LinkedIn1Share on Facebook0Share on Google+0Email this to someoneShare on Tumblr0Buffer this page

Inspired by the work and some excellent blog articles by my colleague Maarten Smeets – and while writing about the LDAP Adapter in SOA Suite 12c for the Oracle SOA Suite 12c Handbook) I decided to give ApacheDS (LDAP Directory) a spin. This article lists the very basic steps for getting started with both the server side LDAP directory (on Linux) and the visual LDAP browser & editor on top that directory. A specific step I describe is the creation of a custom partition in the directory – in this case for Saibot Airport, the fictitious airport from the case on which the book is based.

Install ApacheDS LDAP server on Linux

Download ApacheDS for Linux (http://directory.apache.org/apacheds/downloads.html)

image

Run installer

image

Provide input to installer:

image

Run server

image

 

ApacheDS Directory Studio

Download the installer, in this case for my Windows host on which the Linux VM is running (http://directory.apache.org/studio/downloads.html):

image

Run installer and accept all defaults:

SNAGHTML3200415

After successful installation, run Apache Directory Studio:

image

create a new connection – to the LDAP server we have just installed (ApacheDS on Linux)

image

Provide hostname (soa2admin2 for me – corresponding to IP 10.10.10.21) and (default) port 10389.

SNAGHTML320ba97

Set Bind DN or User to the value uid=admin,ou=system and Bind password to secret.

SNAGHTML320d799

Press Check Authentication if you want to make sure (and I know I do):

SNAGHTML321f382

Press Finish.

The LDAP directory browser is presented with the current contents of the (default, vanilla, out of the box) ApacheDS structure:

image

Note that a connection to the LDAP server is created as well.

Add a custom Partition

ApacheDS makes use of partitions: Each partition contains a complete entry tree, also referred to as a DIT. Multiple partitions may exist and the entry trees they contain are disconnected from each other, meaning that changes to entries in partition A would never affect entries in partition B. The entries in a particular partition are stored below some naming context called the partition suffix.  The ApacheDS default configuration contains a a data partition with the suffix “dc=example,dc=com”. It’s possible to add custom partition implementations (also see https://directory.apache.org/apacheds/basic-ug/1.4.3-adding-partition.html).

Right click on the LDAP connection, to open the configuration:

image

Open the Partitions tab:

image

And click on the Add button. Add a new partition – ID=saibot, Suffix= o:saibot.airport.

image

Press the Save icon (or File | Save) to save the changed configuration – to the server side config file.

Restart the LDAP server to process the changed configuration:

image

Now the tree is refreshed with the new partition:

image

In this partition, we can now create users, organization units and the likes.

Share this on .. Tweet about this on TwitterShare on LinkedIn1Share on Facebook0Share on Google+0Email this to someoneShare on Tumblr0Buffer this page

About Author

Lucas Jellema, active in IT (and with Oracle) since 1994. Oracle ACE Director and Oracle Developer Champion. Solution architect and developer on diverse areas including SQL, JavaScript, Docker, Machine Learning, Java, SOA and microservices, events in various shapes and forms and many other things. Author of the Oracle Press books: Oracle SOA Suite 11g Handbook and Oracle SOA Suite 12c Handbook. Frequent presenter on community events and conferences such as JavaOne, Oracle Code and Oracle OpenWorld.

Leave a Reply