{"id":1312,"date":"2013-08-01T22:16:32","date_gmt":"2013-08-01T10:16:32","guid":{"rendered":"http:\/\/www.zoyinc.com\/?p=1312"},"modified":"2013-09-29T19:47:36","modified_gmt":"2013-09-29T06:47:36","slug":"apache-directory-studio","status":"publish","type":"post","link":"http:\/\/www.zoyinc.com\/?p=1312","title":{"rendered":"Apache Directory Studio"},"content":{"rendered":"

\"Apache<\/a>I recently started playing with OpenLDAP and as a consequence went on the search for a LDAP client. I had been using the Softerra LDAP browser several years ago and it seemed to do what I want but I now see the free version is somewhat limited so I went looking.<\/p>\n

I found the Apache Directory projects “Apache DS”, the LDAP server component and the “Apache Directory Studio” the LDAP administrator\/browser tool. Directory studio utilizes the Eclipse framework, so if you are used to using Eclipse that will help.<\/p>\n

In reality I found the Apache DS to be a pain to get working under Windows and found that OpenLDAP for Windows from UserBooster was easy to install and worked well. However this article is not about LDAP, as such, it’s intention is a place for me to remember some of the bits about how to use the Apache Directory Studio.<\/p>\n

I have added a post OpenLDAP for Windows<\/a> which has brief description of installing OpenLDAP. Neither article is intended as a how-to for LDAP there are lots of places on the Internet with this information.<\/p>\n

As you can tell I chose to use Apache Directory Studio as my LDAP client. Revisiting the subject I see there are quite a few LDAP clients and possibly Apache is not the best ?<\/p>\n

Resources<\/h2>\n

OpenLDAP for Windows – Userbooster<\/h4>\n

http:\/\/userbooster.de\/en\/download\/openldap-for-windows.aspx<\/a>
\n<\/a>I used this as my LDAP server on Windows<\/p>\n

Apache Directory Studio<\/h4>\n

http:\/\/directory.apache.org\/studio\/<\/a><\/p>\n

This site has excellent documentation and of course you can download from here.<\/p>\n

Installation<\/h2>\n

I am not going to detail the installation of Directory Studio as it’s a simple exe you just accept the defaults and all is good. Suffice to say if you choose to use an existing JRE\/JDK you must be careful that if you have a 64bit JRE\/JDK then you must use the 64bit Directory Studio and equally for 32bit installs.<\/p>\n

Once you have installed and started Directory Studio the first thing to do is close the “Welcome” pane. Then select:<\/p>\n

Window | Open Perspective | LDAP<\/p>\n

How-Tos<\/h2>\n

The point of this post is to give me a place to put info on using the Apache client so I can reference it later. This is driven by the fact that not everything in the current version of the Directory Studio is quite as intuitive as it might be.<\/p>\n

Connecting to LDAP<\/h3>\n

Even if you are connecting to LDAP on your local PC\/Laptop you still need to configure a host name and port. Assuming you have select the “LDAP” perspective look for the “Connection” pane, probably around the bottom left of the Studio window:<\/p>\n

\"Connections<\/a>Right click the pane and create a new connection:<\/p>\n\n\n\n\n
\"Apache<\/a><\/td>\n\"Apache<\/a><\/td>\n<\/tr>\n
\"Apache<\/a><\/td>\n\"Apache<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

To open a connection simply double click on the new connection you just created.<\/p>\n

 <\/p>\n

Running an LDIF file<\/h3>\n

A *.ldif file is a list of LDAP entries which allows you to add or modify LDAP entries. You can use this to populate you repository. So it would typically look like:<\/p>\n

# Sample domain definition\r\ndn: dc=example,dc=com\r\ndc: example\r\ndescription: My domain description\r\nobjectClass: dcObject\r\nobjectClass: organization\r\no: Example, Inc.\r\n\r\n# Organizational Unit People\r\ndn: ou=people, dc=example,dc=com\r\nou: people\r\ndescription: everyone in the company\r\nobjectclass: organizationalunit<\/pre>\n
Directory Studio includes a tool to allow you to do this. There are actually a number of ways to invoke this the way I do it is to select: “LDAP | New LDIF File”.<\/p>\n\n\n\n
\"LDIF<\/a><\/td>\n\"LDIF<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Simply type the details in the LDIF window and click on the green “Play” arrow in the top right corner to run the script. This is a great way to test bits of your LDIF file that are giving you trouble.<\/p>\n
Importing from an LDAP server<\/h3>\n
From time to time you may want to copy or clone an entry from one LDAP server to another – you may even want to copy everything. Directory studio has some tools to help you. Be warned if you are copying from dis-similar LDAP server applications you may have problem because different LDAP vendors do things differently and what works for one may not work for another in the same way.<\/p>\n
To import one object simply right click on the object and select “Advanced | Copy Entry as LDIF (all user attributes)”\"Get<\/a>If you then paste the details into a text editor or the LDIF editor in Studio, it will be a valid LDIF entry for re-creating the entry:<\/p>\n
dn: ou=People,dc=maxcrc,dc=com\r\nobjectClass: organizationalUnit\r\nobjectClass: top\r\nou: People\r\ndescription: Container for user entries<\/pre>\n
If you want to get more objects at a time in the form of one long LDIF file, simply select the top most entry of the tree you want to export and right click:<\/p>\n
Export | LDIF Export…<\/p>\n
You will get a dialog similar to:<\/p>\n\n\n\n
\"LDIF<\/a><\/td>\n\"LDIF<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Be careful on the first dialog to select “Subtree” and it’s handy to select “Overwrite existing LDIF file” on the second dialog.<\/p>\n
Getting class or attribute details<\/h3>\n
LDAP entries, such “fred.dagg” are made up of classes and attributes and classes are made up of various definition details and one or more attributes. Again this is not a lesson about LDAP there are many fine resources on the web on that topic.<\/p>\n
To get details of a class used by a particular entry I will give as an example the entry in my tree “fred.dagg”.<\/p>\n