Code

Fixed mailmthod property.
[gosa.git] / gosa-core / include / class_core.inc
1 <?php
3 /*
4  *   How to use plugin::plInfo()
5  *   ===================
6  *   
7  *   The function returns a descriptive array of the plugin,
8  *    which will then be used by GOsa to populate the plugin, its ACLs, 
9  *    its properties, its schema requirements aso.
10  *
11  *
12  *   The following values can be set:
13  *   ================================
14  *
15  *   plShortName    |-> The name of the plugin in short (e.g. Posix)
16  *                  |   This short-name will be shown for example in the ACL definitions.
17  *                  | 
18  *                  | 
19  *   plDescription  |-> A descriptive text for the plugin (e.g. User posix account extension)
20  *                  |   This will be shown in the ACL definitions.   
21  *                  | 
22  *                  | 
23  *   plSelfModify   |-> If set to true this plugin allows to set 'self' ACLs.
24  *                  |   For exampe to allow to change the users own password, but not the others.
25  *                  | 
26  *                  | 
27  *   plDepends      |-> The plugins dependencies to other classes (e.g. sambaAccount requires posixAccount)
28  *                  |  
29  *                  | 
30  *   plPriority     |-> The priority of the plugin, this influences the ACL listings only.
31  *                  | 
32  *                  | 
33  *   plSection      |-> The section of this plugin 'administration', 'personal', 'addons'
34  *                  | 
35  *                  | 
36  *   plCategory     |-> The plugin category this plugins belongs to (e.g. users, groups, departments) 
37  *                  | 
38  *                  | 
39  *   plRequirements |-> Plugin requirements. 
40  *                  | |
41  *                  | |-> [activePlugin]           The schame checks will only be performed if the given plugin is enabled
42  *                  | |                             in the gosa.conf definitions.
43  *                  | |                            Defaults to the current class name if empty.
44  *                  | |
45  *                  | |-> [ldapSchema]             An array of objectClass requirements.
46  *                  | |                            Syntax [[objectClass => 'version'], ... ]
47  *                  | |                            Version can be emtpy which just checks for the existence of the class.
48  *                  | |
49  *                  | |-> [onFailureDisablePlugin] A list of plugins that which will be disabled if the 
50  *                  |                               requirements couldn't be fillfulled.
51  *                  |
52  *                  |      ---------------------------------------------
53  *                  |      EXAMPLE:
54  *                  |      ---------------------------------------------
55  *                  |      "plRequirements"=> array(
56  *                  |         'activePlugin' => 'applicationManagement', 
57  *                  |         'ldapSchema' => array(
58  *                  |             'gosaObject' => '',
59  *                  |             'gosaAccount' => '>=2.7',
60  *                  |             'gosaLockEntry' => '>=2.7',
61  *                  |             'gosaDepartment' => '>=2.7',
62  *                  |             'gosaCacheEntry' => '>=2.7',
63  *                  |             'gosaProperties' => '>=2.7',
64  *                  |             'gosaConfig' => '>=2.7'
65  *                  |             ),
66  *                  |         'onFailureDisablePlugin' => array(get_class(), 'someClassName')
67  *                  |         ),
68  *                  |      ---------------------------------------------
69  *                  |
70  *                  |
71  *                  |         
72  *   plProvidedAcls |-> The ACLs provided by this plugin
73  *                  |
74  *                  |      ---------------------------------------------
75  *                  |      EXAMPLE:
76  *                  |      ---------------------------------------------
77  *                  |      "plProvidedAcls"=> array(
78  *                  |          'cn'             => _('Name'),
79  *                  |          'uid'            => _('Uid'),
80  *                  |          'phoneNumber'    => _('Phone number')
81  *                  |          ),
82  *                  |      ---------------------------------------------
83  *                  |
84  *                  |
85  *                  | 
86  *   plProperties   |-> Properties used by the plugin.
87  *                  |   Properties which are defined here will be modifyable using the property editor.
88  *                  |   To read properties you can use $config->get_cfg_value(className, propertyName)
89  *                  | 
90  *                  |      ---------------------------------------------
91  *                  |      EXAMPLE:
92  *                  |      ---------------------------------------------
93  *                  |      "plProperties"=> array(
94  *                  |         array(
95  *                  |             "name"          => "htaccessAuthentication",
96  *                  |             "type"          => "bool",
97  *                  |             "default"       => "false",
98  *                  |             "description"   => _("A description..."),
99  *                  |             "check"         => "gosaProperty::isBool",
100  *                  |             "migrate"       => "",
101  *                  |             "group"         => "authentification",
102  *                  |             "mandatory"     => TRUE
103  *                  |             ),
104  *                  |         ),
105  *                  |   See class_core.inc for a huge amount of examples.
106  */
109 class all extends plugin {
110     static function plInfo()
111     {
112         return (array(
113                     "plShortName"   => _("All"),
114                     "plDescription" => _("All objects"),
115                     "plSelfModify"  => TRUE,
116                     "plDepends"     => array(),
117                     "plPriority"    => 0,
118                     "plSection"     => array("administration"),
119                     "plCategory"    => array("all" => array("description" => '*&nbsp;'._("All"))),
120                     "plProvidedAcls"    => array())
121                );
122     }
125 class core extends plugin {
127     static function getPropertyValues($class,$name,$value,$type)
128     {
129         $list = array();
130         switch($name){
131             case 'idAllocationMethod':
132                 $list = array('traditional' => _('Traditional'), 'pool' => _('Use samba pool'));
133                 break;
134             case 'passwordDefaultHash':
135                 $tmp = passwordMethod::get_available_methods();
136                 foreach($tmp['name'] as $id => $method){
137                     $desc = $tmp[$id]['name'];
138                     $list[$method] = $desc;
139                 }
140                 break;
141             case 'theme':
142                 $cmd = "cd ../ihtml/themes; find . -name 'img.styles' | sed s/'^[^\/]*\/\([^\/]*\).*'/'\\1'/g";
143                 $res = `$cmd`  ; 
144                 $list = array();
145                 foreach(preg_split("/\n/",$res) as $entry){
146                     if(!empty($entry)){
147                         $list[$entry] = $entry;
148                     }
149                 }
150                 break;
151             case 'accountPrimaryAttribute':
152                 $list = array('uid' => 'uid', 'cn' => 'cn');
153                 break;
154             case 'loginAttribute':
155                 $list = array(
156                             'uid' => 'uid',
157                             'mail' => 'mail',
158                             'both' => 'uid & mail');
159                 break;
160             case 'timezone': 
161                 $tmp = timezone::_get_tz_zones();
162                 foreach($tmp['TIMEZONES'] as $name => $offset){
163                     if($offset >= 0){
164                         $list[$name] = $name." ( + ".sprintf("%0.2f",$offset/(60*60))." "._("hours").")";
165                     }else{
166                         $offset = $offset * -1;
167                         $list[$name] = $name." ( - ".sprintf("%0.2f",($offset/(60*60)))." "._("hours").")";
168                     }
169                 }
170                 break;
171             case 'mailAttribute':
172                 $list = array('mail' => 'mail','uid' => 'uid');
173                 break;
174             case 'mailMethod': 
175                 $tmp = mailMethod::get_methods();
176                 $list =array();
177                 foreach($tmp as $name => $value){
178                     $name = preg_replace('/^mailMethod/','', $name);
179                     $list[$name] = $value;
180                 }
181                 $list[''] = _("None");
182                 break;
183             case 'language':
184                 $tmp = get_languages(TRUE);
185                 $list[""] = _("Automatic");
186                 foreach($tmp as $key => $desc){
187                     $list[$key] = $desc;
188                 }
189                 break;
190             case 'modificationDetectionAttribute': 
191                 $list = array('entryCSN' => 'entryCSN (OpenLdap)','textCSN'=>'textCSN (Sun DS)');
192                 break;
193             default: echo $name." ";$list = array();
194         }
196         if(!isset($list[$value])){
197             $list[$value] = $value." ("._("User value").")";
198         }
200         return($list);
201     }
203     static function plInfo()
204     {
205         return (array(
206                     "plShortName" => _("Core"),
207                     "plDescription" => _("GOsa core plugin"),
208                     "plSelfModify"  => FALSE,
209                     "plDepends"     => array(),
210                     "plPriority"    => 0,
211                     "plSection"     => array("administration"),
213                     "plRequirements"=> array(
214                         'ldapSchema' => array(
215                             'gosaObject' => '>=2.7',
216                             'gosaAccount' => '>=2.7',
217                             'gosaLockEntry' => '>=2.7',
218                             'gosaDepartment' => '>=2.7',
219                             'gosaCacheEntry' => '>=2.7',
220                             'gosaProperties' => '>=2.7',
221                             'gosaConfig' => '>=2.7'
222                             ),
223                         'onFailureDisablePlugin' => array(get_class())
224                         ),
228                     "plCategory"    => array("all"),
229                     "plProperties"  => array(
231                         array(
232                             "name"          => "htaccessAuthentication",
233                             "type"          => "bool",
234                             "default"       => "false",
235                             "description"   => _("The 'htaccessAuthentication' variable tells GOsa to use either htaccess authentication or LDAP authentication. This can be used if you want to use i.e. kerberos to authenticate the users."),
236                             "check"         => "gosaProperty::isBool",
237                             "migrate"       => "",
238                             "group"         => "authentification",
239                             "mandatory"     => TRUE),
241                         array(
242                             "name"          => "logging",
243                             "type"          => "bool",
244                             "default"       => "true",
245                             "description"   => _("The 'logging' statement enables event logging on GOsa side. Setting it to 'true' GOsa will log every action a user performs via syslog. If you use rsyslog and configure it to mysql logging, you can browse all events within GOsa. GOsa will not log anything, if the logging value is empty or set to 'false'."),
247                             "check"         => "gosaProperty::isBool",
248                             "migrate"       => "",
249                             "group"         => "core",
250                             "mandatory"     => TRUE),
252                         array(
253                                 "name"          => "listSummary",
254                                 "type"          => "bool",
255                                 "default"       => "true",
256                                 "description"   => _("The 'listSummary' statement determines whether a status bar will be shown on the bottom of GOsa generated lists, displaying a short summary of type and number of elements in the list."),
257                                 "check"         => "gosaProperty::isBool",
258                                 "migrate"       => "",
259                                 "group"         => "visual",
260                                 "mandatory"     => FALSE),
262                         array(
263                                 "name"          => "passwordMinLength",
264                                 "type"          => "integer",
265                                 "default"       => "",
266                                 "description"   => _("The 'passwordMinLength' statement determines whether a newly entered password has to be of a minimum length."),
267                                 "check"         => "gosaProperty::isInteger",
268                                 "migrate"       => "",
269                                 "group"         => "password",
270                                 "mandatory"     => FALSE),
272                         array(
273                                 "name"          => "passwordMinDiffer",
274                                 "type"          => "integer",
275                                 "default"       => "",
276                                 "description"   => _("The 'passwordMinDiffer' statement determines whether a newly entered password has to be checked to have at least n different characters."),
277                                 "check"         => "gosaProperty::isInteger",
278                                 "migrate"       => "",
279                                 "group"         => "password",
280                                 "mandatory"     => FALSE),
282                         array(
283                                 "name"          => "passwordHook",
284                                 "type"          => "command",
285                                 "default"       => "",
286                                 "description"   => 
287                                 _("The 'passwordHook' can specify an external script to handle password settings at some other location besides the LDAP.")."&nbsp;".sprintf(_("It will be called this way: %s"),"/path/to/your/script \"username\" \"oldpassword\" \"newpassword\""),
288                         "check"         => "gosaProperty::isCommand",
289                                 "migrate"       => "",
290                                 "group"         => "password",
291                                 "mandatory"     => FALSE),
293                         array(
294                                 "name"          => "passwordProposalHook",
295                                 "type"          => "command",
296                                 "default"       => "",
297                                 "description"   => _("The 'passwordProposalHook' can be used to let GOsa generate password proposals for you. Whenever you change a password, you can then decide whether to use the proposal or to manually specify a password.")." "._("Here is an example command:")." /usr/bin/apg -n1",
298                                 "check"         => "gosaProperty::isCommand",
299                                 "migrate"       => "",
300                                 "group"         => "password",
301                                 "mandatory"     => FALSE),
303                         array(
304                                 "name"          => "displayErrors",
305                                 "type"          => "bool",
306                                 "default"       => "false",
307                                 "description"   => _("The 'displayErrors' statement tells GOsa to show PHP errors in the upper part of the screen. This should be disabled in productive deployments, because there might be some important passwords arround.")." ".sprintf(_("The property '%s' may be interesting too."),'developmentMode'),
308                                 "check"         => "gosaProperty::isBool",
309                                 "migrate"       => "",
310                                 "group"         => "debug",
311                                 "mandatory"     => TRUE),
313                         array(
314                                 "name"          => "developmentMode",
315                                 "type"          => "bool",
316                                 "default"       => "false",
317                                 "description"   => _("The 'developmentMode' statement tells GOsa to show development related error messages, for example messages about missing ACL configuration or classes. Due to the fact that enabling this flag will result in a lot of false error messages it should only be enabled while developing or debugging plugins!"),
318                                 "check"         => "gosaProperty::isBool",
319                                 "migrate"       => "",
320                                 "group"         => "debug",
321                                 "mandatory"     => TRUE),
324                         array(
325                                 "name"          => "schemaCheck",
326                                 "type"          => "bool",
327                                 "default"       => "true",
328                                 "description"   => _("The 'schemaCheck' statement enables or disables schema checking during login. It is recommended to switch this on in order to let GOsa handle object creation more efficient."),
329                                 "check"         => "gosaProperty::isBool",
330                                 "migrate"       => "",
331                                 "group"         => "debug",
332                                 "mandatory"     => TRUE),
334                         array(
335                                 "name"          => "copyPaste",
336                                 "type"          => "bool",
337                                 "default"       => "false",
338                                 "description"   => _("The 'copyPaste' statement enables copy and paste for LDAP entries managed with GOsa."),
339                                 "check"         => "gosaProperty::isBool",
340                                 "migrate"       => "",
341                                 "group"         => "copyPaste",
342                                 "mandatory"     => TRUE),
344                         array(
345                                 "name"          => "forceGlobals",
346                                 "type"          => "noLdap",
347                                 "default"       => "false",
348                                 "description"   => _("The 'forceGlobals' statement enables PHP security checks to force register_global settings to be switched off."),
349                                 "check"         => "gosaProperty::isBool",
350                                 "migrate"       => "",
351                                 "group"         => "security",
352                                 "mandatory"     => TRUE),
354                         array(
355                                 "name"          => "forceSSL",
356                                 "type"          => "noLdap",
357                                 "default"       => "false",
358                                 "description"   => _("The 'forceSSL' statement enables PHP security checks to force encrypted access to the web interface. GOsa will try to redirect to the same URL - just with https://"),
359                                 "check"         => "gosaProperty::isBool",
360                                 "migrate"       => "",
361                                 "group"         => "security",
362                                 "mandatory"     => TRUE),
364                         array(
365                                 "name"          => "ldapStats",
366                                 "type"          => "bool",
367                                 "default"       => "false",
368                                 "description"   => _("Logs information about triggered ldap operations, duration, filter, aso. into syslog."),
369                                 "check"         => "gosaProperty::isBool",
370                                 "migrate"       => "",
371                                 "group"         => "debug",
372                                 "mandatory"     => FALSE),
374                         array(
375                                 "name"          => "ldapFollowReferrals",
376                                 "type"          => "bool",
377                                 "default"       => "false",
378                                 "description"   => _("The 'ldapFollowReferrals' statement tells GOsa to follow LDAP referrals."),
379                                 "check"         => "gosaProperty::isBool",
380                                 "migrate"       => "",
381                                 "group"         => "ldap",
382                                 "mandatory"     => TRUE),
384                         array(
385                                 "name"          => "ldapFilterNestingLimit",
386                                 "type"          => "integer",
387                                 "default"       => 200,
388                                 "description"   => _("The 'ldapFilterNestingLimit' statement can be used to speed up group handling for groups with several hundreds of members. The default behaviour is, that GOsa will resolv the memberUid values in a group to real names. To achieve this, it writes a single filter to minimize searches. Some LDAP servers (namely Sun DS) simply crash when the filter gets too big. You can set a member limit, where GOsa will stop to do these lookups."),
389                                 "check"         => "gosaProperty::isInteger",
390                                 "migrate"       => "",
391                                 "group"         => "ldap",
392                                 "mandatory"     => TRUE),
394                         array(
395                                 "name"          => "ldapSizelimit",
396                                 "type"          => "integer",
397                                 "default"       => 200,
398                                 "description"   => _("The ldapSizelimit statement tells GOsa to retrieve the specified maximum number of results. The user will get  a  warning,  that  not  all entries were shown."), 
399                                 "check"         => "gosaProperty::isInteger",
400                                 "migrate"       => "",
401                                 "group"         => "core",
402                                 "mandatory"     => TRUE),
404                         array(
405                                 "name"          => "ldapSizeIgnore",
406                                 "type"          => "bool",
407                                 "default"       => "false",
408                                 "description"   => _("Disables sizelimit checks, only the configured amount of results will be shown!"),
409                                 "check"         => "gosaProperty::isBool",
410                                 "migrate"       => "",
411                                 "group"         => "core",
412                                 "mandatory"     => FALSE),
414                         array(
415                                 "name"          => "warnSSL",
416                                 "type"          => "noLdap",
417                                 "default"       => "true",
418                                 "description"   => _("The 'warnSSL' statement enables PHP security checks to detect non encrypted access to the web interface. GOsa will display a warning in this case."),
419                                 "check"         => "gosaProperty::isBool",
420                                 "migrate"       => "",
421                                 "group"         => "security",
422                                 "mandatory"     => TRUE),
424                         array(
425                                 "name"          => "ppdGzip",
426                                 "type"          => "bool",
427                                 "default"       => "true",
428                                 "description"   => _("The 'ppdGzip' variable enables PPD file compression."),
429                                 "check"         => "gosaProperty::isBool",
430                                 "migrate"       => "",
431                                 "group"         => "ppd",
432                                 "mandatory"     => FALSE),
435                         array(
436                                 "name"          => "ignoreAcl",
437                                 "type"          => "dn",
438                                 "default"       => "",
439                                 "description"   => _("The 'ignoreAcl' value tells GOsa to ignore complete ACL sets for the given DN. Add your DN here and you'll be able to restore accidently dropped ACLs."),
440                                 "check"         => "gosaProperty::isDN",
441                                 "migrate"       => "",
442                                 "group"         => "debug",
443                                 "mandatory"     => FALSE),
446                         array(
447                                 "name"          => "ppdPath",
448                                 "type"          => "path",
449                                 "default"       => "/var/spool/ppd",
450                                 "description"   => _("The 'ppdPath' variable defines where to store PPD files for the GOto environment plugins."),
451                                 "check"         => "gosaProperty::isPath",
452                                 "migrate"       => "",
453                                 "group"         => "ppd",
454                                 "mandatory"     => FALSE),
456                         array(
457                                 "name"          => "ldapMaxQueryTime",
458                                 "type"          => "integer",
459                                 "default"       => "",
460                                 "description"   => _("The 'ldapMaxQueryTime' statement tells GOsa to stop LDAP actions if there is no answer within the specified number of seconds."),
461                                 "check"         => "gosaProperty::isInteger",
462                                 "migrate"       => "",
463                                 "group"         => "debug",
464                                 "mandatory"     => FALSE),
466                         array(
467                                 "name"          => "storeFilterSettings",
468                                 "type"          => "bool",
469                                 "default"       => "true",
470                                 "description"   => _("The 'storeFilterSettings' statement determines whether GOsa should store filter and plugin settings inside of a cookie."),
471                                 "check"         => "gosaProperty::isBool",
472                                 "migrate"       => "",
473                                 "group"         => "core",
474                                 "mandatory"     => FALSE),
476                         array(
477                                 "name"          => "sendCompressedOutput",
478                                 "type"          => "bool",
479                                 "default"       => "true",
480                                 "description"   => _("The 'sendCompressedOutput' statement determines whether PHP should send compressed HTML pages to browsers or not. This may increase or decrease the performance, depending on your network."),
481                                 "check"         => "gosaProperty::isBool",
482                                 "migrate"       => "",
483                                 "group"         => "core",
484                                 "mandatory"     => FALSE),
486                         array(
487                                 "name"          => "modificationDetectionAttribute",
488                                 "type"          => "switch",
489                                 "default"       => "entryCSN",
490                                 "defaults"      => "core::getPropertyValues",
491                                 "description"   => _("The 'modificationDetectionAttribute' statement enables GOsa to check if a entry currently being edited has been modified from someone else outside GOsa in the meantime. It will display an informative dialog then. It can be set to 'entryCSN' for OpenLDAP based systems or 'contextCSN' for Sun DS based systems."),
492                                 "check"         => "",
493                                 "migrate"       => "",
494                                 "group"         => "core",
495                                 "mandatory"     => TRUE),
497                         array(
498                                 "name"          => "language",
499                                 "type"          => "switch",
500                                 "default"       => "",
501                                 "defaults"      => "core::getPropertyValues",
502                                 "description"   => _("The 'language' statement defines the default language used by GOsa. Normally GOsa autodetects the language from the browser settings. If this is not working or you want to force the language, just add the language code (i.e. de for german) here."),
503                                 "check"         => "",
504                                 "migrate"       => "",
505                                 "group"         => "core",
506                                 "mandatory"     => FALSE),
508                         array(
509                                 "name"          => "theme",
510                                 "type"          => "switch",
511                                 "default"       => "default",
512                                 "defaults"      => "core::getPropertyValues",
513                                 "description"   => _("The 'theme' statement defines what theme is used to display GOsa pages. You can install some corporate identity like theme and/or modify certain templates to fit your needs within themes. Take a look at the GOsa FAQ for more information."),
514                                 "check"         => "",
515                                 "migrate"       => "",
516                                 "group"         => "visual",
517                                 "mandatory"     => TRUE),
519                         array(
520                                 "name"          => "sessionLifetime",
521                                 "type"          => "integer",
522                                 "default"       => 600,
523                                 "description"   => _("The 'sessionLifetime' value defines when a session will expire in seconds. For Debian systems, this will not work because the sessions will be removed by a cron job instead. Please modify the value inside of your php.ini instead."),
524                                 "check"         => "gosaProperty::isInteger",
525                                 "migrate"       => "",
526                                 "group"         => "security",
527                                 "mandatory"     => FALSE),
529                         array(
530                                 "name"          => "templateCompileDirectory",
531                                 "type"          => "path",
532                                 "default"       => "/var/spool/gosa",
533                                 "description"   => _("The 'templateCompileDirectory' statements defines the path, where the PHP templating engins 'smarty' should store its compiled GOsa templates for improved speed. This path needs to be writeable by the user your webserver is running with."),
534                                 "check"         => "gosaProperty::isWriteablePath",
535                                 "migrate"       => "",
536                                 "group"         => "core",
537                                 "mandatory"     => TRUE),
539                         array(
540                                 "name"          => "debugLevel",
541                                 "type"          => "integer",
542                                 "default"       => 0,
543                                 "description"   => sprintf(_("The 'debugLevel' value tells GOsa to display certain information on each page load. Value is an AND combination of the following byte values: %s"),
545 DEBUG_TRACE   = 1
546 DEBUG_LDAP    = 2
547 DEBUG_MYSQL   = 4
548 DEBUG_SHELL   = 8
549 DEBUG_POST    = 16
550 DEBUG_SESSION = 32
551 DEBUG_CONFIG  = 64
552 DEBUG_ACL     = 128
553 DEBUG_SI      = 256"),
554                                 "check"         => "gosaProperty::isInteger",
555                                 "migrate"       => "",
556                                 "group"         => "debug",
557                                 "mandatory"     => FALSE),
559                         array(
560                                 "name"          => "sambaHashHook",
561                                 "type"          => "command",
562                                 "default"       => "perl -MCrypt::SmbHash -e \"print join(q[:], ntlmgen \\\$ARGV[0]), $/;\"",
563                                 "description"   => sprintf(_("The 'sambaHashHook' statement contains an executable to generate samba hash values. This is required for password synchronization, but not required if you apply gosa-si services. If you don't have mkntpasswd from the samba distribution installed, you can use perl to generate the hash: %s"),"perl -MCrypt::SmbHash -e \"print join(q[:], ntlmgen \\\$ARGV[0]), $/;\""),
564                                 "check"         => "gosaProperty::isCommand",
565                                 "migrate"       => "",
566                                 "group"         => "samba",
567                                 "mandatory"     => FALSE),
569                         array(
570                                 "name"          => "passwordDefaultHash",
571                                 "type"          => "switch",
572                                 "default"       => "crypt/md5",
573                                 "defaults"      => "core::getPropertyValues",
574                                 "description"   => _("The 'passwordDefaultHash' statement defines the default password hash to choose for new accounts."),
575                                 "check"         => "",
576                                 "migrate"       => "",
577                                 "group"         => "password",
578                                 "mandatory"     => FALSE),
579                         array(
580                                 "name"          => "strictPasswordRules",
581                                 "type"          => "bool",
582                                 "default"       => "true",
583                                 "description"   => _("The 'strictPasswordRules' tells GOsa to check for UTF-8 characters in the supplied password. These Characters can lead to non working authentications if UTF-8 and none UTF-8 systems locales get mixed. The default is 'true'."),
584                                 "check"         => "gosaProperty::isBool",
585                                 "migrate"       => "",
586                                 "group"         => "password",
587                                 "mandatory"     => FALSE),
589                         array(
590                                 "name"          => "accountPrimaryAttribute",
591                                 "type"          => "switch",
592                                 "default"       => "cn",
593                                 "defaults"      => "core::getPropertyValues",
594                                 "description"   => _("The 'accountPrimaryAttribute' option tells GOsa how to create new accounts. Possible values are 'uid' and 'cn'. In the first case GOsa creates uid style DN entries: 'uid=superuser,ou=staff,dc=example,dc=net'. In the second case, GOsa creates cn style DN entries: 'cn=Foo Bar,ou=staff,dc=example,dc=net'. If you choose \"cn\" to be your 'accountPrimaryAttribute' you can decide whether to include the personal title in your dn by selecting 'personalTitleInDN'."),
595                                 "check"         => "",
596                                 "migrate"       => "",
597                                 "group"         => "security",
598                                 "mandatory"     => TRUE),
600                         array(
601                                 "name"          => "userRDN",
602                                 "type"          => "rdn",
603                                 "default"       => "ou=people,",
604                                 "description"   => _("The 'userRDN' statement defines the location where new accounts will be created inside of defined departments. The default is 'ou=people'."),
605                                 "check"         => "gosaProperty::isRdn",
606                                 "migrate"       => "migrate_userRDN", 
607                                 "group"         => "user",
608                                 "mandatory"     => FALSE),
610                         array(
611                                 "name"          => "groupRDN",
612                                 "type"          => "rdn",
613                                 "default"       => "ou=groups,",
614                                 "description"   => _("The 'groupsRDN' statement defines the location where new groups will be created inside of defined departments. The default is 'ou=groups'."),
615                                 "check"         => "gosaProperty::isRdn",
616                                 "migrate"       => "migrate_groupRDN",
617                                 "group"         => "group",
618                                 "mandatory"     => FALSE),
620                         array(
621                                 "name"          => "gidNumberBase",
622                                 "type"          => "integer",
623                                 "default"       => "1000",
624                                 "description"   => _("The 'gidNumberBase' statement defines where to start looking for a new free group id. This should be synced with your 'adduser.conf' to avoid overlapping gidNumber values between local and LDAP based lookups. The gidNumberBase can even be dynamic. Take a look at the 'nextIdHook' definition."),
625                                 "check"         => "gosaProperty::isInteger",
626                                 "migrate"       => "",
627                                 "group"         => "id",
628                                 "mandatory"     => TRUE),
630                        array(
631                                 "name"          => "baseIdHook",
632                                 "type"          => "command",
633                                 "default"       => "",
634                                 "description"   => _("The 'baseIdHook' statement allows to hook into the id generation method (traditional mode), to define the starting range for new generated ids"), 
635                                 "check"         => "gosaProperty::isCommand",
636                                 "migrate"       => "",
637                                 "group"         => "id",
638                                 "mandatory"     => FALSE),
640                         array(
641                                 "name"          => "gidNumberPoolMin",
642                                 "type"          => "integer",
643                                 "default"       => 10000,
644                                 "description"   => _("The 'uidNumberPoolMin/gidNumberPoolMin' statement defines the lowest assignable user/group id for use with the 'idAllocationMethod = pool'."),
645                                 "check"         => "gosaProperty::isInteger",
646                                 "migrate"       => "",
647                                 "group"         => "id",
648                                 "mandatory"     => FALSE),
650                         array(
651                                 "name"          => "gidNumberPoolMax",
652                                 "type"          => "integer",
653                                 "default"       => 40000,
654                                 "description"   => _("The 'uidNumberPoolMax/gidNumberPoolMax' statement defines the highest assignable user/group id for use with the 'idAllocationMethod = pool'."),
655                                 "check"         => "gosaProperty::isInteger",
656                                 "migrate"       => "",
657                                 "group"         => "id",
658                                 "mandatory"     => FALSE),
660                         array(
661                                 "name"          => "uidNumberPoolMin",
662                                 "type"          => "integer",
663                                 "default"       => 10000,
664                                 "description"   => _("The 'uidNumberPoolMin/gidNumberPoolMin' statement defines the lowest assignable user/group id for use with the 'idAllocationMethod = pool'."),
665                                 "check"         => "gosaProperty::isInteger",
666                                 "migrate"       => "",
667                                 "group"         => "id",
668                                 "mandatory"     => FALSE),
670                         array(
671                                 "name"          => "uidNumberPoolMax",
672                                 "type"          => "integer",
673                                 "default"       => 40000,
674                                 "description"   => _("The 'uidNumberPoolMax/gidNumberPoolMax' statement defines the highest assignable user/group id for use with the 'idAllocationMethod = pool'."),
675                                 "check"         => "gosaProperty::isInteger",
676                                 "migrate"       => "",
677                                 "group"         => "id",
678                                 "mandatory"     => FALSE),
680                         array(
681                                 "name"          => "uidNumberBase",
682                                 "type"          => "integer",
683                                 "default"       => "1000",
684                                 "description"   => _("The 'uidNumberBase' statement defines where to start looking for a new free user id. This should be synced with your 'adduser.conf' to avoid overlapping uidNumber values between local and LDAP based lookups. The uidNumberBase can even be dynamic. Take a look at the 'baseIdHook' definition."),
685                                 "check"         => "gosaProperty::isInteger",
686                                 "migrate"       => "",
687                                 "group"         => "id",
688                                 "mandatory"     => FALSE),
690                         array(
691                                 "name"          => "gosaRpcServer",
692                                 "type"          => "string",
693                                 "default"       => "",
694                                 "description"   => "The server to use for RPC connections! (http://localhost:8080/rpc), Future GOsa-ng service! If this value is set and not empty GOsa will try to establish a connection!",
695                                 "check"         => "",
696                                 "migrate"       => "",
697                                 "group"         => "rpc",
698                                 "mandatory"     => FALSE),
700                         array(
701                                 "name"          => "gosaRpcUser",
702                                 "type"          => "string",
703                                 "default"       => "admin",
704                                 "description"   => "Ther username to use for RPC connections! Future GOsa-ng service!",
705                                 "check"         => "",
706                                 "migrate"       => "",
707                                 "group"         => "rpc",
708                                 "mandatory"     => FALSE),
710                         array(
711                                 "name"          => "gosaRpcPassword",
712                                 "type"          => "string",
713                                 "default"       => "tester",
714                                 "description"   => "Ther password to use for RPC connections! Future GOsa-ng service!",
715                                 "check"         => "",
716                                 "migrate"       => "",
717                                 "group"         => "rpc",
718                                 "mandatory"     => FALSE),
720                         array(
721                                 "name"          => "gosaSupportURI",
722                                 "type"          => "string",
723                                 "default"       => "",
724                                 "description"   => _("The 'gosaSupportURI' defines the major gosa-si server host and the password for GOsa to connect to it. It can be used if you want to use i.e. kerberos to authenticate the users. The format is: credentials@host:port"),
725                                 "check"         => "",
726                                 "migrate"       => "",
727                                 "group"         => "gosa-si",
728                                 "mandatory"     => FALSE),
730                         array(
731                                 "name"          => "gosaSupportTimeout",
732                                 "type"          => "integer",
733                                 "default"       => 15,
734                                 "description"   => _("The 'gosaSupportTimeout' sets a connection timeout for all gosa-si actions. See 'gosaSupportURI' for details."),
735                                 "check"         => "gosaProperty::isInteger",
736                                 "migrate"       => "",
737                                 "group"         => "gosa-si",
738                                 "mandatory"     => FALSE),
740                         array(
741                                 "name"          => "loginAttribute",
742                                 "type"          => "switch",
743                                 "default"       => "uid",
744                                 "defaults"      => "core::getPropertyValues",
745                                 "description"   => _("The 'loginAttribute' statement tells GOsa which LDAP attribute is used as the login name during login. It can be set to 'uid', 'mail' or 'both'"),
746                                 "check"         => "",
747                                 "migrate"       => "",
748                                 "group"         => "security",
749                                 "mandatory"     => TRUE),
751                         array(
752                                 "name"          => "timezone",
753                                 "type"          => "switch",
754                                 "default"       => "",
755                                 "defaults"      => "core::getPropertyValues",
756                                 "description"   => _("The 'timezone' statements defines the timezone used inside of GOsa to handle date related tasks, such as password expiery, vacation messages, etc. The 'timezone' value should be a unix conform timezone value like in /etc/timezone."),
757                                 "check"         => "",
758                                 "migrate"       => "",
759                                 "group"         => "core",
760                                 "mandatory"     => FALSE),
762                         array(
763                                 "name"          => "honourUnitTags",
764                                 "type"          => "bool",
765                                 "default"       => "false",
766                                 "description"   => _("The 'honourUnitTags' statement enables checking of 'unitTag' attributes when using administrative units. If this is set to 'true' GOsa can only see objects inside the administrative unit a user is logged into."),
767                                 "check"         => "",
768                                 "migrate"       => "",
769                                 "group"         => "core",
770                                 "mandatory"     => FALSE),
772                         array(
773                                 "name"          => "useSaslForKerberos",
774                                 "type"          => "bool",
775                                 "default"       => "false",
776                                 "description"   => _("The 'useSaslForKerberos' statement defines the way the kerberos realm is stored in the #userPassword' attribute. Set it to 'true' in order to get {sasl}user@REALM.NET, or to 'false' to get {kerberos}user@REALM.NET. The latter is outdated, but may be needed from time to time."),
777                                 "check"         => "gosaProperty::isBool",
778                                 "migrate"       => "",
779                                 "group"         => "password",
780                                 "mandatory"     => FALSE),
782                         array(
783                                 "name"          => "rfc2307bis",
784                                 "type"          => "bool",
785                                 "default"       => "false",
786                                 "description"   => _("The 'rfc2307bis' statement enables rfc2307bis style groups in GOsa. You can use 'member' attributes instead of memberUid in this case. To make it work on unix systems, you've to adjust your NSS configuration to use rfc2307bis style groups, too"),
787                                 "check"         => "gosaProperty::isBool",
788                                 "migrate"       => "",
789                                 "group"         => "core",
790                                 "mandatory"     => FALSE),
792                         array(
793                                 "name"          => "personalTitleInDN",
794                                 "type"          => "bool",
795                                 "default"       => "false",
796                                 "description"   => _("The 'personalTitleInDN' option tells GOsa to include the personal title in user DNs when #accountPrimaryAttribute' is set to \"cn\"."),
797                                 "check"         => "gosaProperty::isBool",
798                                 "migrate"       => "",
799                                 "group"         => "storage location",
800                                 "mandatory"     => FALSE),
802                         array(
803                                 "name"          => "nextIdHook",
804                                 "type"          => "command",
805                                 "default"       => "",
806                                 "description"   => _("The 'nextIdHook' statement defines a script to be called for finding the next free id for users or groups externaly. It gets called with the current entry \"dn\" and the attribute to be ID'd. It should return an integer value."),
807                                 "check"         => "gosaProperty::isCommand",
808                                 "migrate"       => "",
809                                 "group"         => "id",
810                                 "mandatory"     => FALSE),
812                         array(
813                                 "name"          => "idGenerator",
814                                 "type"          => "string",
815                                 "default"       => "{%sn}-{%givenName[2-4]}",
816                                 "description"   => _("The 'idGenerator' statement describes an automatic way to generate new user ids. There are two basic functions supported - which can be combined: 
818  a) using attributes
820     You can specify LDAP attributes (currently only sn and givenName) in
821     braces {} and add a percent sign befor it. Optionally you can strip it
822     down to a number of characters, specified in []. I.e.
824       idGenerator=\"{%sn}-{%givenName[2-4]}\"
826     will generate an ID using the full surename, adding a dash, and adding at
827     least the first two characters of givenName. If this ID is used, it'll
828     use up to four characters. If no automatic generation is possible, a
829     input box is shown.
831  b) using automatic id's
833     I.e. specifying
835       idGenerator=\"acct{id:3}\"
837     will generate a three digits id with the next free entry appended to \"acct\".
839       idGenerator=\"acct{id!1}\"
841     will generate a one digit id with the next free entry appended to \"acct\" - if needed.
843       idGenerator=\"ext{id#3}\"
845     will generate a three digits random number appended to \"ext\".
846 "),
847                                 "check"         => "",
848                                 "migrate"       => "",
849                                 "group"         => "core",
850                                 "mandatory"     => FALSE),
852                         array(
853                                 "name"          => "strictNamingRules",
854                                 "type"          => "bool",
855                                 "default"       => "true",
856                                 "description"   => _("The 'strictNamingRules' statement enables strict checking of uids and group names. If you need   characters like . or - inside of your accounts, set this to 'false'."),
857                                 "check"         => "gosaProperty::isBool",
858                                 "migrate"       => "",
859                                 "group"         => "core",
860                                 "mandatory"     => FALSE),
862                         array(
863                                 "name"          => "minId",
864                                 "type"          => "integer",
865                                 "default"       => 40,
866                                 "description"   => _("The 'minId' statement defines the minimum assignable user or group id to avoid security leaks with uid 0 accounts. This is used for the 'traditional' method."),
867                                 "check"         => "gosaProperty::isInteger",
868                                 "migrate"       => "",
869                                 "group"         => "id",
870                                 "mandatory"     => FALSE),
872                         array(
873                                 "name"          => "mailAttribute",
874                                 "type"          => "switch",
875                                 "default"       => "mail",
876                                 "defaults"      => "core::getPropertyValues",
877                                 "description"   => _("The 'mailAttribute' statement determines which attribute GOsa will use to create accounts. Valid values are 'mail' and 'uid'."),
878                                 "check"         => "",
879                                 "migrate"       => "",
880                                 "group"         => "mail",
881                                 "mandatory"     => FALSE),
883                         array(
884                                 "name"          => "gosaSharedPrefix",
885                                 "type"          => "string",
886                                 "default"       => "",
887                                 "description"   => _("This attribute allows to override the prefix used to create shared folders."),
888                                 "check"         => "",
889                                 "migrate"       => "",
890                                 "group"         => "mail",
891                                 "mandatory"     => FALSE),
893                         array(
894                                 "name"          => "mailUserCreation",
895                                 "type"          => "string",
896                                 "default"       => "",
897                                 "description"   => _("This attribute allows to override the user account creation syntax, see the 'mailFolderCreation' description for more details.
899 Examples
900  mailUserCreation=\"%prefix%%uid%\"           => \"user.foobar\"
901  mailUserCreation=\"my-prefix.%uid%%domain%\"  => \"my-prefix.foobar@example.com\"
902 "),
903                                 "check"         => "",
904                                 "migrate"       => "",
905                                 "group"         => "mail",
906                                 "mandatory"     => FALSE),
908                         array(
909                                 "name"          => "mailFolderCreation",
910                                 "type"          => "string",
911                                 "default"       => "",
912                                 "description"   => _("Every mail method has its own way to create mail accounts like 'share/development' or 'shared.development@example.com' which is used to identify the accounts, set quotas or add acls.
914 To override the methods default account creation syntax, you can set the 'mailFolderCreation' option.
916 Examples
918  mailFolderCreation=\"%prefix%%cn%\"              => \"shared.development\"
919  mailFolderCreation=\"my-prefix.%cn%%domain%\"    => \"my-prefix.development@example.com\"
921  %prefix%    The methods default prefix. (Depends on cyrusUseSlashes=FALSE/TRUE)
922  %cn%        The groups/users cn.
923  %uid%       The users uid.
924  %mail%      The objects mail attribute.
925  %domain%    The domain part of the objects mail attribute.
926  %mailpart%  The user address part of the mail address.
927  %uattrib%   Depends on mailAttribute=\"uid/mail\".
928 "),
929                                 "check"         => "",
930                                 "migrate"       => "",
931                                 "group"         => "mail",
932                                 "mandatory"     => FALSE),
934                         array(
935                                 "name"          => "imapTimeout",
936                                 "type"          => "integer",
937                                 "default"       => 10,
938                                 "description"   => _("The 'imapTimeout' statement sets the connection timeout for imap actions."),
939                                 "check"         => "gosaProperty::isInteger",
940                                 "migrate"       => "",
941                                 "group"         => "mail",
942                                 "mandatory"     => FALSE),
944                         array(
945                                 "name"          => "mailMethod",
946                                 "type"          => "switch",
947                                 "default"       => "",
948                                 "defaults"      => "core::getPropertyValues",
949                                 "description"   => _("The 'mailMethod' statement tells GOsa which mail method the setup should use to communicate with a possible mail server. Leave this undefined if your mail method does not match the predefined ones."),
950                                 "check"         => "",
951                                 "migrate"       => "",
952                                 "group"         => "mail",
953                                 "mandatory"     => FALSE),
955                         array(
956                                 "name"          => "cyrusUseSlashes",
957                                 "type"          => "bool",
958                                 "default"       => "true",
959                                 "description"   => _("The 'cyrusUseSlashes' statement determines if GOsa should use \"foo/bar\" or \"foo.bar\" namespaces in IMAP. Unix style is with slashes."),
960                                 "check"         => "gosaProperty::isBool",
961                                 "migrate"       => "",
962                                 "group"         => "mail",
963                                 "mandatory"     => FALSE),
965                         array(
966                                 "name"          => "vacationTemplateDirectory",
967                                 "type"          => "path",
968                                 "default"       => "/etc/gosa/vacation",
969                                 "description"   => _("The 'vacationTemplateDirectory' statement sets the path where GOsa will look for vacation message templates. Default is /etc/gosa/vacation. 
971 Example template /etc/gosa/vacation/business.txt:
973    DESC:Away from desk
974    Hi, I'm currently away from my desk. You can contact me on
975    my cell phone via %mobile.
977    Greetings,
978    %givenName %sn
980 "),
981                                 "check"         => "gosaProperty::isWriteablePath",
982                                 "migrate"       => "",
983                                 "group"         => "mail",
984                                 "mandatory"     => FALSE),
986                         array(
987                                 "name"          => "ldapTLS",
988                                 "type"          => "bool",
989                                 "default"       => "false",
990                                 "description"   => _("The 'ldapTLS' statement enables or disables TLS operating on LDAP connections."),
991                                 "check"         => "gosaProperty::isBool",
992                                 "migrate"       => "",
993                                 "group"         => "security",
994                                 "mandatory"     => TRUE),
996                         array(
997                                 "name"          => "honourIvbbAttributes",
998                                 "type"          => "bool",
999                                 "default"       => "false",
1000                                 "description"   => _("The 'honourIvbbAttributes' statement enables the IVBB mode inside of GOsa. You need the ivbb.schema file from used by german authorities."),
1001                                 "check"         => "gosaProperty::isBool",
1002                                 "migrate"       => "",
1003                                 "group"         => "core",
1004                                 "mandatory"     => FALSE),
1006                         array(
1007                                 "name"          => "sambaIdMapping",
1008                                 "type"          => "bool",
1009                                 "default"       => "false",
1010                                 "description"   => _("The 'sambaIdMapping' statement tells GOsa to maintain sambaIdmapEntry objects. Depending on your setup this can drastically improve the windows login performance."),
1011                                 "check"         => "gosaProperty::isBool",
1012                                 "migrate"       => "",
1013                                 "group"         => "samba",
1014                                 "mandatory"     => FALSE),
1016                         array(
1017                                 "name"          => "handleExpiredAccounts",
1018                                 "type"          => "bool",
1019                                 "default"       => "true",
1020                                 "description"   => _("The 'handleExpiredAccounts' statement enables shadow attribute tests during the login to the GOsa web interface and forces password renewal or account lockout."),
1021                                 "check"         => "gosaProperty::isBool",
1022                                 "migrate"       => "",
1023                                 "group"         => "core",
1024                                 "mandatory"     => FALSE),
1026                         array(
1027                                 "name"          => "sambaSID",
1028                                 "type"          => "string",
1029                                 "default"       => "",
1030                                 "description"   => _("The 'sambaSID' statement defines a samba SID if not available inside of the LDAP. You can retrieve the current sid by net getlocalsid."),
1031                                 "check"         => "",
1032                                 "migrate"       => "",
1033                                 "group"         => "samba",
1034                                 "mandatory"     => FALSE),
1036                         array(
1037                                 "name"          => "sambaRidBase",
1038                                 "type"          => "integer",
1039                                 "default"       => "",
1040                                 "description"   => _("The 'sambaRidBase' statement defines the base id to add to ordinary sid calculations - if not available inside of the LDAP."),
1041                                 "check"         => "gosaProperty::isInteger",
1042                                 "migrate"       => "",
1043                                 "group"         => "samba",
1044                                 "mandatory"     => FALSE),
1046                         array(
1047                                 "name"          => "enableSnapshots",
1048                                 "type"          => "bool",
1049                                 "default"       => "false",
1050                                 "description"   => _("The 'enableSnapshots' statement enables a snapshot mechaism in GOsa. This enables you to save certain states of entries and restore them later on."),
1051                                 "check"         => "gosaProperty::isBool",
1052                                 "migrate"       => "",
1053                                 "group"         => "snapshot",
1054                                 "mandatory"     => TRUE),
1056                         array(
1057                                 "name"          => "snapshotBase",
1058                                 "type"          => "dn",
1059                                 "default"       => "ou=snapshots,dc=localhost,dc=de",
1060                                 "description"   => _("The 'snapshotBase' statement defines the base where snapshots should be stored inside of the LDAP."),
1061                                 "check"         => "gosaProperty::isDn",
1062                                 "migrate"       => "",
1063                                 "group"         => "snapshot",
1064                                 "mandatory"     => FALSE),
1066                         array(
1067                                 "name"          => "snapshotAdminDn",
1068                                 "type"          => "dn",
1069                                 "default"       => "cn=admin,dc=localhost,dc=de",
1070                                 "description"   => _("The 'snapshotAdminDn' variable defines the user which is used to authenticate when connecting to 'snapshotURI'."),
1071                                 "check"         => "gosaProperty::isDn",
1072                                 "migrate"       => "",
1073                                 "group"         => "snapshot",
1074                                 "mandatory"     => FALSE),
1076                         array(
1077                                 "name"          => "snapshotAdminPassword",
1078                                 "type"          => "string",
1079                                 "default"       => "secret",
1080                                 "description"   => _("The 'snapshotAdminPassword' variable defines the credentials which are used in combination with 'snapshotAdminDn' and 'snapshotURI' in order to authenticate."),
1081                                 "check"         => "",
1082                                 "migrate"       => "",
1083                                 "group"         => "snapshot",
1084                                 "mandatory"     => FALSE),
1086                         array(
1087                                 "name"          => "idAllocationMethod",
1088                                 "type"          => "switch",
1089                                 "default"       => "traditional",
1090                                 "defaults"      => "core::getPropertyValues",
1091                                 "description"   => _("The 'idAllocationMethod' statement defines how GOsa generates numeric user and group id values. If it is set to 'traditional' GOsa will do create a lock and perform a search for the next free ID. The lock will be removed after the procedure completes. 'pool' will use the sambaUnixIdPool objectclass settings inside your LDAP. This one is unsafe, because it does not check for concurrent LDAP access and already used IDs in this range. On the other hand it is much faster."),
1092                                 "check"         => "",
1093                                 "migrate"       => "",
1094                                 "group"         => "id",
1095                                 "mandatory"     => TRUE),
1096                         array(
1097                                 "name"          => "snapshotURI",
1098                                 "type"          => "uri",
1099                                 "default"       => "ldap://localhost:389",
1100                                 "description"   => _("The 'snapshotURI' variable defines the LDAP URI for the server which is used to do object snapshots."),
1101                                 "check"         => "",
1102                                 "migrate"       => "",
1103                                 "group"         => "snapshot",
1104                                 "mandatory"     => FALSE)
1105                             )));
1106     }
1108 ?>