directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From elecha...@apache.org
Subject svn commit: r1403453 - in /directory/site/trunk/content/apacheds/basic-ug: ./ images/ resources/
Date Mon, 29 Oct 2012 18:05:25 GMT
Author: elecharny
Date: Mon Oct 29 18:05:24 2012
New Revision: 1403453

URL: http://svn.apache.org/viewvc?rev=1403453&view=rev
Log:
Added the 1.5-sample-configuration page

Added:
    directory/site/trunk/content/apacheds/basic-ug/resources/
    directory/site/trunk/content/apacheds/basic-ug/resources/apache-ds-tutorial.ldif
Modified:
    directory/site/trunk/content/apacheds/basic-ug/1.4-basic-configuration-tasks.mdtext
    directory/site/trunk/content/apacheds/basic-ug/1.4.5-anonymous-access.mdtext
    directory/site/trunk/content/apacheds/basic-ug/1.5-sample-configuration.mdtext
    directory/site/trunk/content/apacheds/basic-ug/images/partitions-in-studio-after-addition.png
    directory/site/trunk/content/apacheds/basic-ug/images/sevenseas-naming-context.png
    directory/site/trunk/content/apacheds/basic-ug/images/sevenseas-partition-creation.png
    directory/site/trunk/content/apacheds/basic-ug/images/studio-port-config2.png

Modified: directory/site/trunk/content/apacheds/basic-ug/1.4-basic-configuration-tasks.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/1.4-basic-configuration-tasks.mdtext?rev=1403453&r1=1403452&r2=1403453&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/1.4-basic-configuration-tasks.mdtext (original)
+++ directory/site/trunk/content/apacheds/basic-ug/1.4-basic-configuration-tasks.mdtext Mon
Oct 29 18:05:24 2012
@@ -3,7 +3,7 @@ NavPrev: 1.3-installing-and-starting.htm
 NavPrevText: 1.3 - Installing and starting the server
 NavUp: 1-how-to-begin.html
 NavUpText: 1 - How to begin
-NavNext: 1.5-about-sample-configuration.html
+NavNext: 1.5-sample-configuration.html
 NavNextText:  1.5. - About the sample configurations and sample directory data	
 Notice: Licensed to the Apache Software Foundation (ASF) under one
     or more contributor license agreements.  See the NOTICE file

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=1403453&r1=1403452&r2=1403453&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 Mon Oct 29
18:05:24 2012
@@ -3,7 +3,7 @@ NavPrev: 1.4.4-configure-logging.html
 NavprevText: 1.4.4 - Configure logging
 NavUp: 1.4-basic-configuration-tasks.html
 NavUpText: 1.4 - Basic configuration tasks
-NavNext: 1.5-about-sample-configuration.html
+NavNext: 1.5-sample-configuration.html
 NavNextText: 1.5. - About the sample configurations and sample directory data	
 Notice: Licensed to the Apache Software Foundation (ASF) under one
     or more contributor license agreements.  See the NOTICE file
@@ -24,4 +24,14 @@ Notice: Licensed to the Apache Software 
 
 # 1.4.5 - Enable and disable anonymous access
 
-TODO
\ No newline at end of file
+This section briefly describes how to enable and disable anonymous access.
+
+Anonymous access to the server is enabled by default. This includes read and write access!

+
+You can disable anonymous binds by changing the value for property _allow Anonymous Access_
in the server configuration screen :
+
+![Anonymous Access](images/anonymous-access.png)
+
+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

Modified: directory/site/trunk/content/apacheds/basic-ug/1.5-sample-configuration.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/1.5-sample-configuration.mdtext?rev=1403453&r1=1403452&r2=1403453&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/1.5-sample-configuration.mdtext (original)
+++ directory/site/trunk/content/apacheds/basic-ug/1.5-sample-configuration.mdtext Mon Oct
29 18:05:24 2012
@@ -22,4 +22,91 @@ Notice: Licensed to the Apache Software 
     specific language governing permissions and limitations
     under the License.
 
-# 1.5. - About the sample configurations and sample directory data	
\ No newline at end of file
+# 1.5. - About the sample configurations and sample directory data	
+
+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.
+
+[TOC]
+
+## Basic server parameters
+
+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:
+
+<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>
+
+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).
+
+## LDAP Clients
+
+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 ...
+
+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.
+
+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.
+
+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 (_ldap://zanzibar:10389/o=sevenSeas_)
+
+## The sample data (Sailors of the seven seas)
+
+The file [Apache DS Tutorial](resources/apache-ds-tutorial.ldif) contains some sample data,
which is used in the following sections. It is a text file in the so called *LDIF* format.
LDIF stands for LDAP Data Interchange Format. It is widely adopted in the LDAP world and standardized
in [RFC 2849](http://www.faqs.org/rfcs/rfc2849.html). Therefore you are able to import our
sample data into other directory solutions as well, not only into Apache Directory Server.
+
+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.
+
+![Sample Structure](images/sample-structure.gif)
+
+This snippet of the file represents a single entry, just to give you an impression of how
LDIF files look like.
+
+	...
+	# Entry for Fletcher Christian
+	#
+	dn: cn=Fletcher Christian,ou=people,o=sevenSeas
+	cn: Fletcher Christian
+	objectClass: top
+	objectClass: person
+	objectClass: organizationalPerson
+	objectClass: inetOrgPerson
+	sn: Christian
+	givenName: Fletcher
+	description: Lieutenant Fletcher Christian
+	manager: cn=William Bligh,ou=people,o=sevenSeas
+	...
+
+There are different ways to import the data. Generally perform the following steps:
+
+* Download and install the server, described in [1.3. Installing and starting the server](1.3-installing-and-starting.html)
+* Configure a partition for the sample date, described in [1.4. Basic configuration tasks](1.4-basic-configuration-tasks.html)
+* Import the data, for instance using [Apache Directory Studio](http://directory.apache.org/studio/)
+
+h2. Resources
+
+* [RFC 2849 - The LDAP Data Interchange Format (LDIF)](http://www.faqs.org/rfcs/rfc2849.html)
-- Technical Specification

Modified: directory/site/trunk/content/apacheds/basic-ug/images/partitions-in-studio-after-addition.png
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/images/partitions-in-studio-after-addition.png?rev=1403453&r1=1403452&r2=1403453&view=diff
==============================================================================
Binary files - no diff available.

Modified: directory/site/trunk/content/apacheds/basic-ug/images/sevenseas-naming-context.png
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/images/sevenseas-naming-context.png?rev=1403453&r1=1403452&r2=1403453&view=diff
==============================================================================
Binary files - no diff available.

Modified: directory/site/trunk/content/apacheds/basic-ug/images/sevenseas-partition-creation.png
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/images/sevenseas-partition-creation.png?rev=1403453&r1=1403452&r2=1403453&view=diff
==============================================================================
Binary files - no diff available.

Modified: directory/site/trunk/content/apacheds/basic-ug/images/studio-port-config2.png
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/images/studio-port-config2.png?rev=1403453&r1=1403452&r2=1403453&view=diff
==============================================================================
Binary files - no diff available.

Added: directory/site/trunk/content/apacheds/basic-ug/resources/apache-ds-tutorial.ldif
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/resources/apache-ds-tutorial.ldif?rev=1403453&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/resources/apache-ds-tutorial.ldif (added)
+++ directory/site/trunk/content/apacheds/basic-ug/resources/apache-ds-tutorial.ldif Mon Oct
29 18:05:24 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