directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r836590 - in /websites/staging/directory/trunk/content: ./ apacheds/basic-ug/ apacheds/basic-ug/images/
Date Tue, 30 Oct 2012 13:40:39 GMT
Author: buildbot
Date: Tue Oct 30 13:40:39 2012
New Revision: 836590

Staging update by buildbot for directory

  (with props)
  (with props)
  (with props)
  (with props)
  (with props)
    websites/staging/directory/trunk/content/   (props changed)

Propchange: websites/staging/directory/trunk/content/
--- cms:source-revision (original)
+++ cms:source-revision Tue Oct 30 13:40:39 2012
@@ -1 +1 @@

Modified: websites/staging/directory/trunk/content/apacheds/basic-ug/4.1-mozilla-thunderbird.html
--- websites/staging/directory/trunk/content/apacheds/basic-ug/4.1-mozilla-thunderbird.html
+++ websites/staging/directory/trunk/content/apacheds/basic-ug/4.1-mozilla-thunderbird.html
Tue Oct 30 13:40:39 2012
@@ -126,6 +126,70 @@
 <h1 id="41-mozilla-thunderbird-integration">4.1 - Mozilla Thunderbird Integration</h1>
+<p>In this section you will learn how to integrate Apache Directory Server into a mail
client in order to use the data as an address book. Mozilla Thunderbird is used as an example.</p>
+<div class="toc">
+<li><a href="#41-mozilla-thunderbird-integration">4.1 - Mozilla Thunderbird Integration</a><ul>
+<li><a href="#e-mail-clients-and-mozilla-thunderbird">E-Mail clients and Mozilla
+<li><a href="#mozilla-thunderbird">Mozilla Thunderbird</a></li>
+<li><a href="#prerequisites">Prerequisites</a></li>
+<li><a href="#define-apache-directory-server-as-an-address-book">Define Apache
Directory Server as an address book</a><ul>
+<li><a href="#open-the-address-book">Open the address book</a></li>
+<li><a href="#define-a-new-ldap-directory">Define a new LDAP directory</a></li>
+<li><a href="#provide-connection-data">Provide connection data</a></li>
+<li><a href="#searching-your-new-address-book">Searching your new address book</a></li>
+<li><a href="#resources">Resources</a></li>
+<h2 id="e-mail-clients-and-mozilla-thunderbird">E-Mail clients and Mozilla Thunderbird</h2>
+<p>Integrating an LDAP server in an E-Mail client is a very traditionally task, because
directories are commonly used as user repositories within companies and organizations. Contact
data is stored for all users of the enterprise, and it is quite common to build the companies
online phone/address book on this directory. These address books are often web based application
within the intranet. But many E-Mail clients allow to connect to an LDAP based directory directly
and use its data as an address book. This seamless integration provides better user experience.
One of these clients is Mozilla Thunderbird. Other E-Mail clients that support LDAP integration
for address books include <a href="">Microsoft Outlook
Expess</a>, <a href="">Eudora Email</a> and <a
href="">IBM Lotus Notes</a>.</p>
+<p>Technically, a mail program acts as a normal LDAP client, as described in earlier
sections (i.e. the client connects to the server and performs LDAP search operations). Therefore
the parameters you have to specify are the same. Main difference between searches with E-Mail
clients and searches with LDAP Browsers like Softerra or JXplorer is that most of the complexity
of the LDAP search is hidden to the user. Hence these tools are easier to use, but less powerful.</p>
+<h3 id="mozilla-thunderbird">Mozilla Thunderbird</h3>
+<p>Mozilla Thunderbird is a popular open source E-Mail client which supports many platforms.
Actually it is more than just an E-Mail client (e.g. a news client as well). Features include
junk mail control and RSS reading. Learn more about this software at the projects Homepage:
<a href="">Mozilla Thunderbird</a>.</p>
+<p>Within this lesson we use Thunderbird primarily because of its broad support for
different operation systems and hardware platforms (and because it allows the integration
of LDAP servers as address books, of course). You may use other E-Mail clients as well. It
is likely that that allow the integration of LDAP directories as well, and even that the configuration
is similar to Thunderbird. Check your product documentation for details.</p>
+<h2 id="prerequisites">Prerequisites</h2>
+<p>We assume that you have Mozilla Thunderbird installed on your system (or you use
another E-Mail client and are willing to assimilate the instructions to your situation). You
may wish to download the software at the homepage (<a href="">Mozilla
Thunderbird</a>) and install it, before proceed with this lesson.
+Furthermore you need an LDAP server up and running, which address data should be used as
an address book within your E-Mail client. For the instructions it is assumed that you have
installed Apache Directory Server as described in the first trail and loaded our sample data.
To sum it up the following is assumed for the environment:
+<em> Apache Directory runs on host </em>zanzibar<em>. LDAP and listens
to port </em>10389<em>
+</em> Anonymous access to the directory is allowed
+<em> Data is imported as described in section 2, Base DN is </em>o=sevenSeas*</p>
+<p>You may use this lesson as a blueprint to integrate other directory servers as well.
At least you need the data given above in <em>bold</em>.</p>
+<h2 id="define-apache-directory-server-as-an-address-book">Define Apache Directory
Server as an address book</h2>
+<h3 id="open-the-address-book">Open the address book</h3>
+<p>After starting Mozilla Thunderbird on your workstation, go to the address book by
+<em> clicking the adress book icon or
+</em> activation of the corresponding  menu item ("Tools" -- "Address Book")  or
+* pressing Ctrl+2</p>
+<p><img alt="Thunderbirs open addressbook" src="images/thunderbird-open-adressbook.png"
+<h3 id="define-a-new-ldap-directory">Define a new LDAP directory</h3>
+<p>Within the adress book window open the dialog to define a new LDAP directory by
+* activation of the corresponding  menu item ("File" -- "New" -- "LDAP Directory...")</p>
+<p><img alt="thunderbird new ldap directory" src="images/thunderbird-new-ldap-directory-menu.png"
+<p>Thunderbird opens a dialog with three tabbed panes to provide the data of the directory.</p>
+<h3 id="provide-connection-data">Provide connection data</h3>
+<p>Within the "General" tab, enter basic connection data to your directory:
+<em> Name: A name which is used by Thunderbird within the UI, e.g. "Seven Seas"
+</em> Hostname: th hostname or IP address of the server, "zanzibar" in our case
+<em> Base DN: Search base for looking up people, we choose "ou=people,o=sevenSeas"
+</em> Port number: The port the LDAP provider of Apache Directory Server is listening
on, "10389" in our case</p>
+<p><img alt="Thunderbird new ldap" src="images/thunderbird-new-ldap-1.png" /></p>
+<p>In this example we do not provide a Bind DN but let Thunderbird look up the users
within our directory anonymously. Apache Directory Server should be appropriately configured
for that, or you have to provide a user here.</p>
+<p>The advance tab of the dialog provides input fields for result set limits, search
scope and search filter. In our example we perform a search with subtree scope and a maximum
number of 100 entries within the result set. The search filter restricts the results to person
entries only.</p>
+<p><img alt="Thunderbird new ldap" src="images/thunderbird-new-ldap-2.png" /></p>
+<p>You probably have noticed that the input fields in the two tabbed panes corresponds
exactly to the parameters for an LDAP search operation as described in lesson [Search the
directory] of this trail.</p>
+<h2 id="searching-your-new-address-book">Searching your new address book</h2>
+<p><img alt="Thunderbird new ldap" src="images/thunderbird-adressbook.png" /></p>
+<h2 id="resources">Resources</h2>
+<li><a href="">An
introduction to Thunderbird</a>, Open Source Articles</li>
+<li><a href="">LDAP
Attribute Mapping</a> for Mozilla Thunderbird</li>
     <div class="nav">

Added: websites/staging/directory/trunk/content/apacheds/basic-ug/images/thunderbird-adressbook.png
Binary file - no diff available.

Propchange: websites/staging/directory/trunk/content/apacheds/basic-ug/images/thunderbird-adressbook.png
    svn:mime-type = image/png

Added: websites/staging/directory/trunk/content/apacheds/basic-ug/images/thunderbird-new-ldap-1.png
Binary file - no diff available.

Propchange: websites/staging/directory/trunk/content/apacheds/basic-ug/images/thunderbird-new-ldap-1.png
    svn:mime-type = image/png

Added: websites/staging/directory/trunk/content/apacheds/basic-ug/images/thunderbird-new-ldap-2.png
Binary file - no diff available.

Propchange: websites/staging/directory/trunk/content/apacheds/basic-ug/images/thunderbird-new-ldap-2.png
    svn:mime-type = image/png

Added: websites/staging/directory/trunk/content/apacheds/basic-ug/images/thunderbird-new-ldap-directory-menu.png
Binary file - no diff available.

Propchange: websites/staging/directory/trunk/content/apacheds/basic-ug/images/thunderbird-new-ldap-directory-menu.png
    svn:mime-type = image/png

Added: websites/staging/directory/trunk/content/apacheds/basic-ug/images/thunderbird-open-adressbook.png
Binary file - no diff available.

Propchange: websites/staging/directory/trunk/content/apacheds/basic-ug/images/thunderbird-open-adressbook.png
    svn:mime-type = image/png

View raw message