[cvs] [Wiki] changed: AuthCompositeHowTo

[Wiki Guest]

guest [82.242.78.17]  Wed, 25 Feb 2009 03:42:39 -0500

Modified page: http://wiki.horde.org/AuthCompositeHowTo
New Revision:  1.17
Change log:  elaborate the admin_driver features

@@ -2,9 +2,17 @@

  **Contents**
  [[toc]]

-The composite authentication driver allows to use different  
authentication schemes for different purposes or circumstances. You  
can force mobiles of PDAs to ((MIMPHowTo|authenticate with MIMP)) for  
instance, or choose different drivers for authentication and user  
management.
+The composite authentication driver allows to use different  
authentication and user management schemes for different purposes or  
circumstances.
+
+You can define several authentication backends and selectively use  
one of them depending on some criteria:
+* For instance, you can force mobiles of PDAs to  
((MIMPHowTo|authenticate with MIMP)).
+
+Another use of the composite driver is to choose different drivers  
for authentication and user management:
+* For instance you want to let IMP authenticate users against several  
possible email servers
+* but you want to be able to manage users globally from a central  
user repository (such as a corporate SQL database)
+

  ++ Defining the several drivers

  First you need to define all the drivers in {{config/conf.php}} that  
should be part of the composite driver. Each driver is configured like  
a "normal" authentication driver and associated with a sub-driver  
name. This name is completely independent with the authentication  
scheme.
@@ -46,9 +54,11 @@
  </code>

  ++ Defining the administration driver

-In order to manage users you have to tell Horde which of the backends  
contains the user information and should be used for administration  
purposes. For example, to configure it to use "corporate_sql" as admin  
backend, add following line after the backend arrays:
+In order to manage users you have to tell Horde which of the backends  
contains the user information and should be used for administration  
purposes. This driver is not only used by the Horde administrator to  
define system-wide user permissions and groups, but also by Horde  
users who want to define permissions on their shared objects (such as  
Kronolith calendars).
+
+For example, to configure it to use "corporate_sql" as admin backend,  
add following line after the backend arrays:

  <code type="php">
  $conf['auth']['params']['admin_driver'] = 'corporate_sql';
  </code>