directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From elecha...@apache.org
Subject svn commit: r1467834 - /directory/site/trunk/content/apacheds/basic-ug/
Date Sun, 14 Apr 2013 22:04:30 GMT
Author: elecharny
Date: Sun Apr 14 22:04:29 2013
New Revision: 1467834

URL: http://svn.apache.org/r1467834
Log:
fixed many broken links

Added:
    directory/site/trunk/content/apacheds/basic-ug/2.3.1-adding-schema-elements.mdtext
    directory/site/trunk/content/apacheds/basic-ug/4-integrating-apacheds.mdtext
    directory/site/trunk/content/apacheds/basic-ug/4.1-mozilla-thunderbird.mdtext
    directory/site/trunk/content/apacheds/basic-ug/5-integrating-apacheds.mdtext
Modified:
    directory/site/trunk/content/apacheds/basic-ug/1-how-to-begin.mdtext
    directory/site/trunk/content/apacheds/basic-ug/1.4.5-anonymous-access.mdtext
    directory/site/trunk/content/apacheds/basic-ug/2-handling-data.mdtext
    directory/site/trunk/content/apacheds/basic-ug/2.3-introducing-schema.mdtext
    directory/site/trunk/content/apacheds/basic-ug/3-basic-security.mdtext
    directory/site/trunk/content/apacheds/basic-ug/3.3-enabling-ssl.mdtext

Modified: directory/site/trunk/content/apacheds/basic-ug/1-how-to-begin.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/1-how-to-begin.mdtext?rev=1467834&r1=1467833&r2=1467834&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/1-how-to-begin.mdtext (original)
+++ directory/site/trunk/content/apacheds/basic-ug/1-how-to-begin.mdtext Sun Apr 14 22:04:29
2013
@@ -1,8 +1,8 @@
 Title: 1 - How To Begin
 NavUp: ../basic-user-guide.html
 NavUpText: Basic User Guide
-NavNext: 1.1-what-apacheds-is.html
-NavNextText: 1.1 - What Apache DS is
+NavNext: 2-handling-data.html
+NavNextText: 2 - Handling of data within your directory
 Notice: Licensed to the Apache Software Foundation (ASF) under one
     or more contributor license agreements.  See the NOTICE file
     distributed with this work for additional information

Modified: directory/site/trunk/content/apacheds/basic-ug/1.4.5-anonymous-access.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/1.4.5-anonymous-access.mdtext?rev=1467834&r1=1467833&r2=1467834&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/1.4.5-anonymous-access.mdtext (original)
+++ directory/site/trunk/content/apacheds/basic-ug/1.4.5-anonymous-access.mdtext Sun Apr 14
22:04:29 2013
@@ -34,4 +34,4 @@ You can disable anonymous binds by chang
 
 A restart of the server is necessary for this change to take effect. Afterwards, all clients
have to provide their name (distinguished name) and password in order to bind to the directory
service. 
 
-Learn more about authentication option in the corresponding section of this guide [here](3.1.
Authentication options).
\ No newline at end of file
+Learn more about authentication option in the corresponding section of this guide [here](3.1-authentication-options.html).
\ No newline at end of file

Modified: directory/site/trunk/content/apacheds/basic-ug/2-handling-data.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/2-handling-data.mdtext?rev=1467834&r1=1467833&r2=1467834&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/2-handling-data.mdtext (original)
+++ directory/site/trunk/content/apacheds/basic-ug/2-handling-data.mdtext Sun Apr 14 22:04:29
2013
@@ -1,10 +1,10 @@
 Title: 2 - Handling of data within your directory
-NavPrev: 1.5-sample-configuration.html
-NavPrevText: 1.5. - About the sample configurations and sample directory data
+NavPrev: 1-how-to-begin.html
+NavPrevText: 1 - How to Begin
 NavUp: ../basic-user-guide.html
 NavUpText: Basic User Guide
-NavNext: 2.1-data-modification.html
-NavNextText: 2.1 - Data modification
+NavNext: 3-basic-security.html
+NavNextText: 3 - Basic Security
 Notice: Licensed to the Apache Software Foundation (ASF) under one
     or more contributor license agreements.  See the NOTICE file
     distributed with this work for additional information

Modified: directory/site/trunk/content/apacheds/basic-ug/2.3-introducing-schema.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/2.3-introducing-schema.mdtext?rev=1467834&r1=1467833&r2=1467834&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/2.3-introducing-schema.mdtext (original)
+++ directory/site/trunk/content/apacheds/basic-ug/2.3-introducing-schema.mdtext Sun Apr 14
22:04:29 2013
@@ -28,6 +28,11 @@ All the data stored into a LDAP server a
 
 We won't describe in the basic user guide how to manage the schema, this will be extensively
described in the _Advanced user guide_, this chapter is just a short introduction.
 
+
+## Table of content
+
+* [2.3.1 - Adding Schema Elements](2.3.1-adding-schema-elements.html)
+
 ## What is the LDAP schema ?
 
 It's a set of elements defining the data structure that can be stored in the server. It defines
the following elements :

Added: directory/site/trunk/content/apacheds/basic-ug/2.3.1-adding-schema-elements.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/2.3.1-adding-schema-elements.mdtext?rev=1467834&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/2.3.1-adding-schema-elements.mdtext (added)
+++ directory/site/trunk/content/apacheds/basic-ug/2.3.1-adding-schema-elements.mdtext Sun
Apr 14 22:04:29 2013
@@ -0,0 +1,25 @@
+Title: 2.3.1 - Adding Schema Elements
+Navprev: 2.3-introducing-schema.html
+NavPrevText: 2.3 - Introducing Schema
+NavUp: 2.3-introducing-schema.html
+NavUpText: 2.3 - Introducing Schema
+NavNext: 3-basic-security.html
+NavNextText: 3 - Basic Security
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+    .
+    http://www.apache.org/licenses/LICENSE-2.0
+    .
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+# 2.3.1 - Adding Schema Elements

Modified: directory/site/trunk/content/apacheds/basic-ug/3-basic-security.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/3-basic-security.mdtext?rev=1467834&r1=1467833&r2=1467834&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/3-basic-security.mdtext (original)
+++ directory/site/trunk/content/apacheds/basic-ug/3-basic-security.mdtext Sun Apr 14 22:04:29
2013
@@ -3,8 +3,8 @@ NavPrev: 2.3-introducing-schema.html
 NavPrevtext: 2.3 - The Schema
 NavUp: ../basic-user-guide.html
 NavUpText: Basic User Guide
-NavNext: 3.1-authentication-options.html
-NavNextText: 3.1 - Authentication options
+NavNext: 4-integrating-apacheds.html
+NavNextText: 4 - Integrating ApacheDS with other programs
 Notice: Licensed to the Apache Software Foundation (ASF) under one
     or more contributor license agreements.  See the NOTICE file
     distributed with this work for additional information

Modified: directory/site/trunk/content/apacheds/basic-ug/3.3-enabling-ssl.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/3.3-enabling-ssl.mdtext?rev=1467834&r1=1467833&r2=1467834&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/3.3-enabling-ssl.mdtext (original)
+++ directory/site/trunk/content/apacheds/basic-ug/3.3-enabling-ssl.mdtext Sun Apr 14 22:04:29
2013
@@ -3,7 +3,7 @@ Navprev: 3.2-basic-authorization.html
 NavPrevText: 3.2 - Basic authorization
 NavUp: 3-basic-security.html
 NavUpText: 3 - Basic Security
-NavNext: 4-integrating-apacheds.html
+NavNext: 4-integration-apacheds.html
 NavNextText: 4 - Integrating ApacheDS with other programs
 Notice: Licensed to the Apache Software Foundation (ASF) under one
     or more contributor license agreements.  See the NOTICE file

Added: directory/site/trunk/content/apacheds/basic-ug/4-integrating-apacheds.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/4-integrating-apacheds.mdtext?rev=1467834&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/4-integrating-apacheds.mdtext (added)
+++ directory/site/trunk/content/apacheds/basic-ug/4-integrating-apacheds.mdtext Sun Apr 14
22:04:29 2013
@@ -0,0 +1,30 @@
+Title: 4 - Integrating ApacheDS with other programs
+Navprev: 3-basic-security.html
+NavPrevText: 3 - Basic Security
+NavUp: ../basic-user-guide.html
+NavUpText: Basic User Guide
+NavNext: 4.1-mozilla-thunderbird.html
+NavNextText: 4.1 - Mozilla Thunderbird Integration
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+    .
+    http://www.apache.org/licenses/LICENSE-2.0
+    .
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+# 4 - Integrating ApacheDS with other programs
+
+In this chapter, we expose various environments that are depending on _Apache Directory Server_,
and how to set those environments. As _Apache Directory Server_ is an **LDAP** server, it
can be used to manage messaging users, web servers like **Tomcat**, users in a **Unix** environment,
etc.
+
+## Table of content
+* [4.1 - Mozilla Thunderbird Integration](4.1-mozilla-thunderbird.html)

Added: directory/site/trunk/content/apacheds/basic-ug/4.1-mozilla-thunderbird.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/4.1-mozilla-thunderbird.mdtext?rev=1467834&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/4.1-mozilla-thunderbird.mdtext (added)
+++ directory/site/trunk/content/apacheds/basic-ug/4.1-mozilla-thunderbird.mdtext Sun Apr
14 22:04:29 2013
@@ -0,0 +1,96 @@
+Title: 4.1 - Mozilla Thunderbird Integration
+Navprev: 4-integrating-apacheds.html
+NavPrevText: 4 - Integrating ApacheDS with other programs
+NavUp: 4-integrating-apacheds.html
+NavUpText: 4 - Integrating ApacheDS with other programs
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+    .
+    http://www.apache.org/licenses/LICENSE-2.0
+    .
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+# 4.1 - Mozilla Thunderbird Integration
+
+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.
+
+[TOC]
+
+## E-Mail clients and Mozilla Thunderbird
+
+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 [Microsoft Outlook Expess](http://www.microsoft.com/windows/oe/),
[Eudora Email](http://www.eudora.com/) and [IBM Lotus Notes](http://www.ibm.com/software/lotus/).
+
+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.
+
+### Mozilla Thunderbird
+
+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:
[Mozilla Thunderbird](http://www.mozilla.org/products/thunderbird/).
+
+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.
+
+## Prerequisites
+
+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 ([Mozilla Thunderbird](http://www.mozilla.org/products/thunderbird/))
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:
+* Apache Directory runs on host *zanzibar*. LDAP and listens to port *10389*
+* Anonymous access to the directory is allowed
+* Data is imported as described in section 2, Base DN is *o=sevenSeas*
+
+You may use this lesson as a blueprint to integrate other directory servers as well. At least
you need the data given above in *bold*.
+
+## Define Apache Directory Server as an address book
+
+### Open the address book
+
+After starting Mozilla Thunderbird on your workstation, go to the address book by
+* clicking the adress book icon or
+* activation of the corresponding  menu item ("Tools" -- "Address Book")  or
+* pressing Ctrl+2
+
+![Thunderbirs open addressbook](images/thunderbird-open-adressbook.png)
+
+### Define a new LDAP directory
+
+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...")
+
+![thunderbird new ldap directory](images/thunderbird-new-ldap-directory-menu.png)
+
+Thunderbird opens a dialog with three tabbed panes to provide the data of the directory.
+
+### Provide connection data
+
+Within the "General" tab, enter basic connection data to your directory:
+* Name: A name which is used by Thunderbird within the UI, e.g. "Seven Seas"
+* Hostname: th hostname or IP address of the server, "zanzibar" in our case
+* Base DN: Search base for looking up people, we choose "ou=people,o=sevenSeas"
+* Port number: The port the LDAP provider of Apache Directory Server is listening on, "10389"
in our case
+
+![Thunderbird new ldap](images/thunderbird-new-ldap-1.png)
+
+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.
+
+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.
+
+![Thunderbird new ldap](images/thunderbird-new-ldap-2.png)
+
+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.
+
+## Searching your new address book
+
+![Thunderbird new ldap](images/thunderbird-adressbook.png)
+
+## Resources
+
+ * [An introduction to Thunderbird](http://opensourcearticles.com/articles/introduction_to_thunderbird),
Open Source Articles
+ * [LDAP Attribute Mapping](http://www.mozilla.org/projects/thunderbird/specs/ldap.html)
for Mozilla Thunderbird
\ No newline at end of file

Added: directory/site/trunk/content/apacheds/basic-ug/5-integrating-apacheds.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/5-integrating-apacheds.mdtext?rev=1467834&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/5-integrating-apacheds.mdtext (added)
+++ directory/site/trunk/content/apacheds/basic-ug/5-integrating-apacheds.mdtext Sun Apr 14
22:04:29 2013
@@ -0,0 +1,30 @@
+Title: 5 - Integrating ApacheDS with other programs
+Navprev: 4-adding-schema-elements.html
+NavPrevText: 4 - Adding Schema Elements
+NavUp: ../basic-user-guide.html
+NavUpText: Basic User Guide
+NavNext: 5.1-mozilla-thunderbird.html
+NavNextText: 5.1 - Mozilla Thunderbird Integration
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+    .
+    http://www.apache.org/licenses/LICENSE-2.0
+    .
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+# 5 - Integrating ApacheDS with other programs
+
+In this chapter, we expose various environments that are depending on _Apache Directory Server_,
and how to set those environments. As _Apache Directory Server_ is an **LDAP** server, it
can be used to manage messaging users, web servers like **Tomcat**, users in a **Unix** environment,
etc.
+
+## Table of content
+* [5.1 - Mozilla Thunderbird Integration](4.1-mozilla-thunderbird.html)



Mime
View raw message