[cvs] [Wiki] changed: LdapPref

[Wiki Guest]

guest [82.233.234.109]  Mon, 19 Jun 2006 08:38:45 -0700

Modified page: http://wiki.horde.org/LdapPref
New Revision:  1.2
Change log:  Add info 

@@ -9,22 +9,38 @@
 This document is intended to help administrators set up a LDAP to store Horde and IMP prefs.
 
 ----
 
-1- Installing schema
+++ 1- Installing schema
 Copy the horde/scripts/ldap/horde.schema to /etc/ldap/schema/
 Restart your ldap server.
 
-2- Configuring horde
-Horde config/prefs.php
-Set pref hooks to true
+++ 2- Horde Setup
 
+Storing Horde preferences in the LDAP directory adds a large number of attribute entries to every user DN. If this is something you do not want, you should look into using some other preference backend.
+
+To use LDAP to store Horde preferences, set the preference system to use LDAP as its backend. The field values here are very simular to the Horde configuration.
+
+    * The hostname of the LDAP server - This is the address of your LDAP server. If you have a master and one or more slave LDAP servers, you can provide failover here by entering all of your LDAP servers separated by a space. For ldaps, use ldaps://<hostname> in this field.
+    * The port of the LDAP server - This is the port that your LDAP server is listening on. Most commonly, this will be 389.
+    * LDAP Protocol Version - This should almost always be LDAPv3.
+    * The base DN for the LDAP server - This is the subtree that horde will search through to find user preference information.
+    * The DN of the root (administrative) account to bind for write operations - This is not actually asking for the LDAP root account, this is just the DN that horde uses to bind to the LDAP directory. This account should have write priveleges to the preference fields, as shown below.
+    * The password of the root DN for bind authentication - The password associated with the binding account.
+    * The username search key - This is the field that stores the username.
+
+++ 3- Configuring horde
+
++++ Horde config/prefs.php
+
+Set pref hooks to true.
  *    hook: Call a hook function for the value of this preference
  *             true:  Will call the function _prefs_hook_<prefname>
  *                    to fill in the value of this preference.
  *                    See hooks.php for more details.
- *            false:  Normal behaviour - no hook is called.
+ *             false:  Normal behaviour - no hook is called.
 
+<code>
 // user full name for From: line
 // If you lock this preference, you must specify a value or a hook for it in
 // horde/config/hooks.php.
 $_prefs['fullname'] = array(
@@ -44,10 +60,11 @@
     'shared' => true,
     'type' => 'text',
     'desc' =>  _("Your From: address:")
 );
+</code>
 
-Horde config/hooks.php
++++ Horde config/hooks.php
  * NOTE 1: Having a hook function in this file does NOT mean that the hook
  * will automatically be used. YOU MUST enable the hook. For preferences, set
  * 'hook' => true in that preferences attributes; for other hooks, there will
  * be a configuration option in each application's conf.php file such as
@@ -67,9 +84,9 @@
  *    we saved the results of the hook for them. However, if the preference is
  *    locked, the result of the hook will never be saved.
 
 
-Uncomment and configure the hook you active
+Uncomment and configure the hook you actived.
 _prefs_hook_fullname
 _prefs_hook_from_addr
 
 By modify $ldapServer, $ldapPort,  $searchBase