directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r836511 - in /websites/staging/directory/trunk/content: ./ apacheds/basic-ug/ apacheds/basic-ug/images/ apacheds/basic-ug/resources/
Date Mon, 29 Oct 2012 18:05:30 GMT
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
+
+
+



Mime
View raw message