Differences

This shows you the differences between two versions of the page.

--- browse_ldap [2018/08/25 21:20] – fix header _qaisjp
+++ browse_ldap [2026/09/26 23:58] (current) – removed - external edit (Unknown date) 127.0.0.1
@@ Line 1: / Line 1: @@
-This tutorial shows you how to use //Apache Directory Studio// to browse [[ldap]]. Only system administrators will have access to the credentials required to get through a part of this tutorial. This tutorial also assumes you have SSH all set up.
-====== Getting the software ======
-First, you'll need to grab //Apache Directory Studio// from [[https://directory.apache.org/studio/downloads.html|Apache Directory website]]. It's available for Linux, Windows, and macOS, so don't worry. This tutorial uses macOS Sierra but it should be fairly straightforward for other platforms.
-Once you've got that installed (if you're a macOS user, you may run across [[https://support.apple.com/kb/PH25088?locale=en_GB|this issue]]), run the software.
-====== Finding the main interface ======
-Right now you should be presented with the below welcome screen.
-{{ file_ldap_welcome.png?500x0 }}
-Hit the close button next to the **Welcome** tab (highlighted above) to get access to the main interface.
-{{ file_ldap_main_interface.png?500x0 }}
-====== Adding a connection ======
-Go to File -> New, and then navigate to the //LDAP Connection// wizard. It should be filed under //LDAP Browser//.
-{{ file_ldap_select_wizard.png?500x0 }}
-Navigating to LDAP Connection will bring us to the below screen:
-{{ file_ldap_new_connection.png?500x0 }}
-===== Setting the Network Parameters =====
-Set the name to //Tardis localhost:1389//. You may be wondering, why are we writing //localhost//? Isn't the LDAP server on Tardis?
-Yes, the LDAP server is on Tardis, but it is behind the firewall. We'll be using SSH port forwarding to get a connection through to the LDAP VM on the Tardis network. Run this command to start SSH port forwarding.
-<code>ssh -NL 1389:ldap:389 ssh.tardis.ed.ac.uk</code>
-  *  //-N//: This means we do not want execute a remote command.  This is useful for just forwarding ports, since we don't want to also access the machine using regular SSH.
-  *  //-L 1389:ldap:389//: This means we want all traffic on the port //1389// of localhost to go to the //ldap:389// address on the remote server.
-The reason we use 1389 locally instead of 389, is that all ports under 1024 require **sudo** to be used.
-Once you run the command, depending on how you have things set up, you will be prompted for a password. You'll then receive the welcome message, and then nothing will happen. This is good.
-On the wizard, for the **Hostname**, type in //localhost//. For the **Port**, type in //1389//. This is what your screen should look like:
-{{ file_ldap_new_connection_filled.png?500x0 }}
-Leave the other options as default, and press Next.
-===== Authentication =====
-This screen requires us to provide the details for Simple Authentication. We'll be grabbing these details from the LDAP config file. Open up SSH, and read the <code>/etc/tardis/ldap.conf</code> file. You will need root privileges to do this, use <code>sudo cat</code>.
-The file has the structure of key/value pairs, as well as categories. It should look a little bit like this:
-<code>
-[server]
-...
-binddn=some=stuff,exists=here
-bindpw=and,the,secure,password,here
-...
-</code>
-  *  <code>[server]</code> is the server category
-  *  <code>binddn</code> has the value <code>some=stuff,exists=here</code>
-  *  <code>bindpw</code> has the value <code>and,the,secure,password,here</code>
-The ellipsis just represents that there may be other key/value pairs in the file. On the wizard fill in **Bind DN or user** field with the <code>binddn</code> value, and fill the password field with <code>bindpw</code> value. Smack **Check Authentication** and make sure everything works fine.
-{{ file_ldap_authentication.png?500x0 }}
-Press Finish, and you should be in!
-{{ file_ldap_browsing.png?800x0 }}
-====== Connecting again ======
-All of that was just a one time setup. In the future, when you start Apache Directory Studio, you just need to run  <code>ssh -NL 1389:ldap:389 ssh.tardis.ed.ac.uk</code>, and then select the connection in the bottom-left hand side of the main window.
-{{ file_ldap_connecting_again.png?250x0 }}
-====== Tips & Tricks ======
-  *  Clear groups cache using //sudo nscd --invalidate=group//