You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@directory.apache.org by bu...@apache.org on 2012/10/29 19:05:30 UTC
svn commit: r836511 - in /websites/staging/directory/trunk/content: ./
apacheds/basic-ug/ apacheds/basic-ug/images/ apacheds/basic-ug/resources/
Author: buildbot
Date: Mon Oct 29 18:05:29 2012
New Revision: 836511
Log:
Staging update by buildbot for directory
Added:
websites/staging/directory/trunk/content/apacheds/basic-ug/resources/
websites/staging/directory/trunk/content/apacheds/basic-ug/resources/apache-ds-tutorial.ldif
Modified:
websites/staging/directory/trunk/content/ (props changed)
websites/staging/directory/trunk/content/apacheds/basic-ug/1.4-basic-configuration-tasks.html
websites/staging/directory/trunk/content/apacheds/basic-ug/1.4.5-anonymous-access.html
websites/staging/directory/trunk/content/apacheds/basic-ug/1.5-sample-configuration.html
websites/staging/directory/trunk/content/apacheds/basic-ug/images/partitions-in-studio-after-addition.png
websites/staging/directory/trunk/content/apacheds/basic-ug/images/sevenseas-naming-context.png
websites/staging/directory/trunk/content/apacheds/basic-ug/images/sevenseas-partition-creation.png
websites/staging/directory/trunk/content/apacheds/basic-ug/images/studio-port-config2.png
Propchange: websites/staging/directory/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Mon Oct 29 18:05:29 2012
@@ -1 +1 @@
-1403441
+1403453
Modified: websites/staging/directory/trunk/content/apacheds/basic-ug/1.4-basic-configuration-tasks.html
==============================================================================
--- websites/staging/directory/trunk/content/apacheds/basic-ug/1.4-basic-configuration-tasks.html (original)
+++ websites/staging/directory/trunk/content/apacheds/basic-ug/1.4-basic-configuration-tasks.html Mon Oct 29 18:05:29 2012
@@ -118,7 +118,7 @@
</div>
<div class="nav_next">
- <a href="1.5-about-sample-configuration.html">1.5. - About the sample configurations and sample directory data </a>
+ <a href="1.5-sample-configuration.html">1.5. - About the sample configurations and sample directory data </a>
</div>
<div class="clearfix"></div>
@@ -148,7 +148,7 @@
</div>
<div class="nav_next">
- <a href="1.5-about-sample-configuration.html">1.5. - About the sample configurations and sample directory data </a>
+ <a href="1.5-sample-configuration.html">1.5. - About the sample configurations and sample directory data </a>
</div>
<div class="clearfix"></div>
Modified: websites/staging/directory/trunk/content/apacheds/basic-ug/1.4.5-anonymous-access.html
==============================================================================
--- websites/staging/directory/trunk/content/apacheds/basic-ug/1.4.5-anonymous-access.html (original)
+++ websites/staging/directory/trunk/content/apacheds/basic-ug/1.4.5-anonymous-access.html Mon Oct 29 18:05:29 2012
@@ -118,7 +118,7 @@
</div>
<div class="nav_next">
- <a href="1.5-about-sample-configuration.html">1.5. - About the sample configurations and sample directory data </a>
+ <a href="1.5-sample-configuration.html">1.5. - About the sample configurations and sample directory data </a>
</div>
<div class="clearfix"></div>
@@ -126,7 +126,12 @@
<h1 id="145-enable-and-disable-anonymous-access">1.4.5 - Enable and disable anonymous access</h1>
-<p>TODO</p>
+<p>This section briefly describes how to enable and disable anonymous access.</p>
+<p>Anonymous access to the server is enabled by default. This includes read and write access! </p>
+<p>You can disable anonymous binds by changing the value for property <em>allow Anonymous Access</em> in the server configuration screen :</p>
+<p><img alt="Anonymous Access" src="images/anonymous-access.png" /></p>
+<p>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. </p>
+<p>Learn more about authentication option in the corresponding section of this guide <a href="3.1. Authentication options">here</a>.</p>
<div class="nav">
@@ -142,7 +147,7 @@
</div>
<div class="nav_next">
- <a href="1.5-about-sample-configuration.html">1.5. - About the sample configurations and sample directory data </a>
+ <a href="1.5-sample-configuration.html">1.5. - About the sample configurations and sample directory data </a>
</div>
<div class="clearfix"></div>
Modified: websites/staging/directory/trunk/content/apacheds/basic-ug/1.5-sample-configuration.html
==============================================================================
--- websites/staging/directory/trunk/content/apacheds/basic-ug/1.5-sample-configuration.html (original)
+++ websites/staging/directory/trunk/content/apacheds/basic-ug/1.5-sample-configuration.html Mon Oct 29 18:05:29 2012
@@ -126,6 +126,89 @@
<h1 id="15-about-the-sample-configurations-and-sample-directory-data">1.5. - About the sample configurations and sample directory data</h1>
+<p>This section describes basic parameters used throughout the examples in this guide. It also introduces the sample directory "Sailors of the seven seas", and other requisites you need.</p>
+<div class="toc">
+<ul>
+<li><a href="#15-about-the-sample-configurations-and-sample-directory-data">1.5. - About the sample configurations and sample directory data</a><ul>
+<li><a href="#basic-server-parameters">Basic server parameters</a></li>
+<li><a href="#ldap-clients">LDAP Clients</a></li>
+<li><a href="#the-sample-data-sailors-of-the-seven-seas">The sample data (Sailors of the seven seas)</a></li>
+</ul>
+</li>
+</ul>
+</div>
+<h2 id="basic-server-parameters">Basic server parameters</h2>
+<p>In the following sections we assume that you will install, configure and run Apache Directory Server on a host with the following host name using the parameters given in the following table:</p>
+<div class="table-wrap">
+ <table class="confluenceTable">
+ <tbody>
+ <tr>
+ <th class="confluenceTh"> Parameter name </th>
+ <th class="confluenceTh"> Parameter value </th>
+ </tr>
+ <tr>
+ <td class="confluenceTd"> Hostname </td>
+ <td class="confluenceTd"> zanzibar </td>
+ </tr>
+ <tr>
+ <td class="confluenceTd"> Port </td>
+ <td class="confluenceTd"> 10389 </td>
+ </tr>
+ <tr>
+ <td class="confluenceTd"> Suffix ("Base DN") </td>
+ <td class="confluenceTd"> o=sevenSeas </td>
+ </tr>
+ <tr>
+ <td class="confluenceTd"> Admin user DN </td>
+ <td class="confluenceTd"> uid=admin,ou=system </td>
+ </tr>
+ <tr>
+ <td class="confluenceTd"> Admin user password </td>
+ <td class="confluenceTd"> secret </td>
+ </tr>
+ </tbody>
+ </table>
+</div>
+
+<p>Before you start playing with the data make sure that you have added a partition with the suffix o=sevenSeas to the server. How to do this is described [here|1.4. Basic configuration tasks#Adding your own partition (suffix)]
+In order to increase recognition, all examples of the Basic User's Guide use these values. Adjust them to your needs (especially the password).</p>
+<h2 id="ldap-clients">LDAP Clients</h2>
+<p>LDAP is a client/server protocol. Hence you need an LDAP client to connect remotely to the Apache Directory Server (or at least the directory part of it, to be precise). There are different options here. Because the protocol is standardized, you may use every LDAP compliant client. This is comparable to HTTP, where you can use each web browser to communicate with virtually each web server, and totally different to relational databases. The latter have a (more or less) standardized query language (SQL), but vendors tend to use individual network access protocols. In practice, the LDAP situation is even better than HTTP, because there were no LDAP browser wars ...</p>
+<p>Many software components may act as an LDAP client. Normally they use LDAP libraries to connect. In the following sections you meet LDAP clients with GUI and LDAP command line tools. Some Java programming examples which takes advantage of JNDI are provided as well.</p>
+<p>In other sections you will learn how E-Mail clients like Mozilla Thunderbird and application servers like Apache Tomcat connect to Apache Directory server, either to use the data stored in the directory (e.g. mail addresses) or to perform authentication and authorization.</p>
+<p>Recapitulating the Basic User's Guide describes connecting to the server with tools provided by ApacheDS as well as third party products. In all cases the examples will use the connection data depicted above (<em>ldap://zanzibar:10389/o=sevenSeas</em>)</p>
+<h2 id="the-sample-data-sailors-of-the-seven-seas">The sample data (Sailors of the seven seas)</h2>
+<p>The file <a href="resources/apache-ds-tutorial.ldif">Apache DS Tutorial</a> contains some sample data, which is used in the following sections. It is a text file in the so called <em>LDIF</em> format. LDIF stands for LDAP Data Interchange Format. It is widely adopted in the LDAP world and standardized in <a href="http://www.faqs.org/rfcs/rfc2849.html">RFC 2849</a>. Therefore you are able to import our sample data into other directory solutions as well, not only into Apache Directory Server.</p>
+<p>The sample directory tree contains entries for persons and groups. These are structured in sub trees (ou=people and ou=groups), see image below. The person entries describe sailors (historic and fictional), the group entries bundle them. An example for a group is the ship crew of HMS Bounty.</p>
+<p><img alt="Sample Structure" src="images/sample-structure.gif" /></p>
+<p>This snippet of the file represents a single entry, just to give you an impression of how LDIF files look like.</p>
+<div class="codehilite"><pre><span class="o">...</span>
+<span class="c1"># Entry for Fletcher Christian</span>
+<span class="c1">#</span>
+<span class="n">dn:</span> <span class="n">cn</span><span class="o">=</span><span class="n">Fletcher</span> <span class="n">Christian</span><span class="p">,</span><span class="n">ou</span><span class="o">=</span><span class="n">people</span><span class="p">,</span><span class="n">o</span><span class="o">=</span><span class="n">sevenSeas</span>
+<span class="n">cn:</span> <span class="n">Fletcher</span> <span class="n">Christian</span>
+<span class="n">objectClass:</span> <span class="n">top</span>
+<span class="n">objectClass:</span> <span class="n">person</span>
+<span class="n">objectClass:</span> <span class="n">organizationalPerson</span>
+<span class="n">objectClass:</span> <span class="n">inetOrgPerson</span>
+<span class="n">sn:</span> <span class="n">Christian</span>
+<span class="n">givenName:</span> <span class="n">Fletcher</span>
+<span class="n">description:</span> <span class="n">Lieutenant</span> <span class="n">Fletcher</span> <span class="n">Christian</span>
+<span class="n">manager:</span> <span class="n">cn</span><span class="o">=</span><span class="n">William</span> <span class="n">Bligh</span><span class="p">,</span><span class="n">ou</span><span class="o">=</span><span class="n">people</span><span class="p">,</span><span class="n">o</span><span class="o">=</span><span class="n">sevenSeas</span>
+<span class="o">...</span>
+</pre></div>
+
+
+<p>There are different ways to import the data. Generally perform the following steps:</p>
+<ul>
+<li>Download and install the server, described in <a href="1.3-installing-and-starting.html">1.3. Installing and starting the server</a></li>
+<li>Configure a partition for the sample date, described in <a href="1.4-basic-configuration-tasks.html">1.4. Basic configuration tasks</a></li>
+<li>Import the data, for instance using <a href="http://directory.apache.org/studio/">Apache Directory Studio</a></li>
+</ul>
+<p>h2. Resources</p>
+<ul>
+<li><a href="http://www.faqs.org/rfcs/rfc2849.html">RFC 2849 - The LDAP Data Interchange Format (LDIF)</a> -- Technical Specification</li>
+</ul>
<div class="nav">
Modified: websites/staging/directory/trunk/content/apacheds/basic-ug/images/partitions-in-studio-after-addition.png
==============================================================================
Binary files - no diff available.
Modified: websites/staging/directory/trunk/content/apacheds/basic-ug/images/sevenseas-naming-context.png
==============================================================================
Binary files - no diff available.
Modified: websites/staging/directory/trunk/content/apacheds/basic-ug/images/sevenseas-partition-creation.png
==============================================================================
Binary files - no diff available.
Modified: websites/staging/directory/trunk/content/apacheds/basic-ug/images/studio-port-config2.png
==============================================================================
Binary files - no diff available.
Added: websites/staging/directory/trunk/content/apacheds/basic-ug/resources/apache-ds-tutorial.ldif
==============================================================================
--- websites/staging/directory/trunk/content/apacheds/basic-ug/resources/apache-ds-tutorial.ldif (added)
+++ websites/staging/directory/trunk/content/apacheds/basic-ug/resources/apache-ds-tutorial.ldif Mon Oct 29 18:05:29 2012
@@ -0,0 +1,219 @@
+# Sample LDIF data for the ApacheDS v1.0 Basic User's Guide
+#
+# Some sailors and their ships
+# userpassword for all persons is "pass"
+#
+version: 1
+
+dn: ou=people,o=sevenSeas
+objectclass: organizationalUnit
+objectclass: top
+description: Contains entries which describe persons (seamen)
+ou: people
+
+dn: ou=groups,o=sevenSeas
+objectclass: organizationalUnit
+objectclass: top
+description: Contains entries which describe groups (crews, for instance)
+ou: groups
+
+dn: ou=crews,ou=groups,o=sevenSeas
+objectclass: organizationalUnit
+objectclass: top
+description: Contains entries which describe ship crews
+ou: crews
+
+dn: ou=ranks,ou=groups,o=sevenSeas
+objectclass: organizationalUnit
+objectclass: top
+description: Contains entries which describe naval ranks (e.g. captain)
+ou: ranks
+
+# HMS Lydia Crew
+# --------------
+
+dn: cn=Horatio Hornblower,ou=people,o=sevenSeas
+objectclass: person
+objectclass: organizationalPerson
+objectclass: inetOrgPerson
+objectclass: top
+cn: Horatio Hornblower
+description: Capt. Horatio Hornblower, R.N
+givenname: Horatio
+sn: Hornblower
+uid: hhornblo
+mail: hhornblo@royalnavy.mod.uk
+userpassword: {SHA}nU4eI71bcnBGqeO0t9tXvY1u5oQ=
+
+dn: cn=William Bush,ou=people,o=sevenSeas
+objectclass: person
+objectclass: organizationalPerson
+objectclass: inetOrgPerson
+objectclass: top
+cn: William Bush
+description: Lt. William Bush
+givenname: William
+manager: cn=Horatio Hornblower,ou=people,o=sevenSeas
+sn: Bush
+uid: wbush
+mail: wbush@royalnavy.mod.uk
+userpassword: {SHA}nU4eI71bcnBGqeO0t9tXvY1u5oQ=
+
+dn: cn=Thomas Quist,ou=people,o=sevenSeas
+objectclass: person
+objectclass: organizationalPerson
+objectclass: inetOrgPerson
+objectclass: top
+cn: Thomas Quist
+description: Seaman Quist
+givenname: Thomas
+manager: cn=Horatio Hornblower,ou=people,o=sevenSeas
+sn: Quist
+uid: tquist
+mail: tquist@royalnavy.mod.uk
+userpassword: {SHA}nU4eI71bcnBGqeO0t9tXvY1u5oQ=
+
+dn: cn=Moultrie Crystal,ou=people,o=sevenSeas
+objectclass: person
+objectclass: organizationalPerson
+objectclass: inetOrgPerson
+objectclass: top
+cn: Moultrie Crystal
+description: Lt. Crystal
+givenname: Moultrie
+manager: cn=Horatio Hornblower,ou=people,o=sevenSeas
+sn: Crystal
+uid: mchrysta
+mail: mchrysta@royalnavy.mod.uk
+userpassword: {SHA}nU4eI71bcnBGqeO0t9tXvY1u5oQ=
+
+dn: cn=HMS Lydia,ou=crews,ou=groups,o=sevenSeas
+objectclass: groupOfUniqueNames
+objectclass: top
+cn: HMS Lydia
+uniquemember: cn=Horatio Hornblower,ou=people,o=sevenSeas
+uniquemember: cn=William Bush,ou=people,o=sevenSeas
+uniquemember: cn=Thomas Quist,ou=people,o=sevenSeas
+uniquemember: cn=Moultrie Crystal,ou=people,o=sevenSeas
+
+# HMS Victory Crew
+# ----------------
+
+dn: cn=Horatio Nelson,ou=people,o=sevenSeas
+objectclass: person
+objectclass: organizationalPerson
+objectclass: inetOrgPerson
+objectclass: top
+cn: Horatio Nelson
+description: Lord Horatio Nelson
+givenname: Horatio
+sn: Nelson
+uid: hnelson
+mail: hnelson@royalnavy.mod.uk
+userpassword: {SHA}nU4eI71bcnBGqeO0t9tXvY1u5oQ=
+
+dn: cn=Thomas Masterman Hardy,ou=people,o=sevenSeas
+objectclass: person
+objectclass: organizationalPerson
+objectclass: inetOrgPerson
+objectclass: top
+cn: Thomas Masterman Hardy
+description: Sir Thomas Masterman Hardy
+givenname: Thomas
+manager: cn=Horatio Nelson,ou=people,o=sevenSeas
+sn: Hardy
+uid: thardy
+mail: thardy@royalnavy.mod.uk
+userpassword: {SHA}nU4eI71bcnBGqeO0t9tXvY1u5oQ=
+
+dn: cn=Cornelius Buckley,ou=people,o=sevenSeas
+objectclass: person
+objectclass: organizationalPerson
+objectclass: inetOrgPerson
+objectclass: top
+cn: Cornelius Buckley
+description: LM Cornelius Buckley
+givenname: Cornelius
+manager: cn=Horatio Nelson,ou=people,o=sevenSeas
+sn: Buckley
+uid: cbuckley
+mail: cbuckley@royalnavy.mod.uk
+userpassword: {SHA}nU4eI71bcnBGqeO0t9tXvY1u5oQ=
+
+dn: cn=HMS Victory,ou=crews,ou=groups,o=sevenSeas
+objectclass: groupOfUniqueNames
+objectclass: top
+cn: HMS Victory
+uniquemember: cn=Horatio Nelson,ou=people,o=sevenSeas
+uniquemember: cn=Thomas Masterman Hardy,ou=people,o=sevenSeas
+uniquemember: cn=Cornelius Buckley,ou=people,o=sevenSeas
+
+# HMS Bounty Crew
+# ---------------
+
+dn: cn=William Bligh,ou=people,o=sevenSeas
+objectclass: person
+objectclass: organizationalPerson
+objectclass: inetOrgPerson
+objectclass: top
+cn: William Bligh
+description: Captain William Bligh
+givenname: William
+sn: Bligh
+uid: wbligh
+mail: wbligh@royalnavy.mod.uk
+userpassword: {SHA}nU4eI71bcnBGqeO0t9tXvY1u5oQ=
+
+dn: cn=Fletcher Christian,ou=people,o=sevenSeas
+objectclass: person
+objectclass: organizationalPerson
+objectclass: inetOrgPerson
+objectclass: top
+cn: Fletcher Christian
+description: Lieutenant Fletcher Christian
+givenname: Fletcher
+manager: cn=William Bligh,ou=people,o=sevenSeas
+sn: Christian
+uid: fchristi
+mail: fchristi@royalnavy.mod.uk
+userpassword: {SHA}nU4eI71bcnBGqeO0t9tXvY1u5oQ=
+
+dn: cn=John Fryer,ou=people,o=sevenSeas
+objectclass: person
+objectclass: organizationalPerson
+objectclass: inetOrgPerson
+objectclass: top
+cn: John Fryer
+description: Master John Fryer
+givenname: John
+manager: cn=William Bligh,ou=people,o=sevenSeas
+sn: Fryer
+uid: jfryer
+mail: jfryer@royalnavy.mod.uk
+userpassword: {SHA}nU4eI71bcnBGqeO0t9tXvY1u5oQ=
+
+dn: cn=John Hallett,ou=people,o=sevenSeas
+objectclass: person
+objectclass: organizationalPerson
+objectclass: inetOrgPerson
+objectclass: top
+cn: John Hallett
+description: Midshipman John Hallett
+givenname: John
+manager: cn=William Bligh,ou=people,o=sevenSeas
+sn: Hallett
+uid: jhallett
+mail: jhallett@royalnavy.mod.uk
+userpassword: {SHA}nU4eI71bcnBGqeO0t9tXvY1u5oQ=
+
+dn: cn=HMS Bounty,ou=crews,ou=groups,o=sevenSeas
+objectclass: groupOfUniqueNames
+objectclass: top
+cn: HMS Bounty
+uniquemember: cn=William Bligh,ou=people,o=sevenSeas
+uniquemember: cn=Fletcher Christian,ou=people,o=sevenSeas
+uniquemember: cn=John Fryer,ou=people,o=sevenSeas
+uniquemember: cn=John Hallett,ou=people,o=sevenSeas
+
+
+