23badf7125b93de8e525471e009c05e2b48e864f
1 <?php
2 /*
3 * This code is part of GOsa (http://www.gosa-project.org)
4 * Copyright (C) 2003-2008 GONICUS GmbH
5 *
6 * ID: $$Id: functions.inc 13100 2008-12-01 14:07:48Z hickert $$
7 *
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
21 */
23 /*! \file
24 * Common functions and named definitions. */
26 /* Configuration file location */
27 if(!isset($_SERVER['CONFIG_DIR'])){
28 define ("CONFIG_DIR", "/etc/gosa");
29 }else{
30 define ("CONFIG_DIR",$_SERVER['CONFIG_DIR']);
31 }
33 /* Allow setting the config file in the apache configuration
34 e.g. SetEnv CONFIG_FILE gosa.conf.2.6
35 */
36 if(!isset($_SERVER['CONFIG_FILE'])){
37 define ("CONFIG_FILE", "gosa.conf");
38 }else{
39 define ("CONFIG_FILE",$_SERVER['CONFIG_FILE']);
40 }
42 /* Define common locatitions */
43 define ("CONFIG_TEMPLATE_DIR", "../contrib");
44 define ("TEMP_DIR","/var/cache/gosa/tmp");
46 /* Define get_list flags */
47 define("GL_NONE", 0);
48 define("GL_SUBSEARCH", 1);
49 define("GL_SIZELIMIT", 2);
50 define("GL_CONVERT", 4);
51 define("GL_NO_ACL_CHECK", 8);
53 /* Heimdal stuff */
54 define('UNIVERSAL',0x00);
55 define('INTEGER',0x02);
56 define('OCTET_STRING',0x04);
57 define('OBJECT_IDENTIFIER ',0x06);
58 define('SEQUENCE',0x10);
59 define('SEQUENCE_OF',0x10);
60 define('SET',0x11);
61 define('SET_OF',0x11);
62 define('DEBUG',false);
63 define('HDB_KU_MKEY',0x484442);
64 define('TWO_BIT_SHIFTS',0x7efc);
65 define('DES_CBC_CRC',1);
66 define('DES_CBC_MD4',2);
67 define('DES_CBC_MD5',3);
68 define('DES3_CBC_MD5',5);
69 define('DES3_CBC_SHA1',16);
71 /* Define globals for revision comparing */
72 $svn_path = '$HeadURL$';
73 $svn_revision = '$Revision$';
75 /* Include required files */
76 require_once("class_location.inc");
77 require_once ("functions_debug.inc");
78 require_once ("accept-to-gettext.inc");
80 /* Define constants for debugging */
81 define ("DEBUG_TRACE", 1); /*! Debug level for tracing of common actions (save, check, etc.) */
82 define ("DEBUG_LDAP", 2); /*! Debug level for LDAP queries */
83 define ("DEBUG_MYSQL", 4); /*! Debug level for mysql operations */
84 define ("DEBUG_SHELL", 8); /*! Debug level for shell commands */
85 define ("DEBUG_POST", 16); /*! Debug level for POST content */
86 define ("DEBUG_SESSION",32); /*! Debug level for SESSION content */
87 define ("DEBUG_CONFIG", 64); /*! Debug level for CONFIG information */
88 define ("DEBUG_ACL", 128); /*! Debug level for ACL infos */
89 define ("DEBUG_SI", 256); /*! Debug level for communication with gosa-si */
90 define ("DEBUG_MAIL", 512); /*! Debug level for all about mail (mailAccounts, imap, sieve etc.) */
91 define ("DEBUG_FAI", 1024); // FAI (incomplete)
93 /* Rewrite german 'umlauts' and spanish 'accents'
94 to get better results */
95 $REWRITE= array( "ä" => "ae",
96 "ö" => "oe",
97 "ü" => "ue",
98 "Ä" => "Ae",
99 "Ö" => "Oe",
100 "Ü" => "Ue",
101 "ß" => "ss",
102 "á" => "a",
103 "é" => "e",
104 "í" => "i",
105 "ó" => "o",
106 "ú" => "u",
107 "Á" => "A",
108 "É" => "E",
109 "Í" => "I",
110 "Ó" => "O",
111 "Ú" => "U",
112 "ñ" => "ny",
113 "Ñ" => "Ny" );
116 /*! \brief Does autoloading for classes used in GOsa.
117 *
118 * Takes the list generated by 'update-gosa' and loads the
119 * file containing the requested class.
120 *
121 * \param string 'class_name' The currently requested class
122 */
123 function __gosa_autoload($class_name) {
124 global $class_mapping, $BASE_DIR;
126 if ($class_mapping === NULL){
127 echo sprintf(_("Fatal error: no class locations defined - please run %s to fix this"), bold("update-gosa"));
128 exit;
129 }
131 if (isset($class_mapping["$class_name"])){
132 require_once($BASE_DIR."/".$class_mapping["$class_name"]);
133 } else {
134 echo sprintf(_("Fatal error: cannot instantiate class %s - try running %s to fix this"), bold($class_name), bold("update-gosa"));
135 exit;
136 }
137 }
138 spl_autoload_register('__gosa_autoload');
141 /*! \brief Checks if a class is available.
142 * \param string 'name' The subject of the test
143 * \return boolean True if class is available, else false.
144 */
145 function class_available($name)
146 {
147 global $class_mapping;
148 return(isset($class_mapping[$name]));
149 }
152 /*! \brief Check if plugin is available
153 *
154 * Checks if a given plugin is available and readable.
155 *
156 * \param string 'plugin' the subject of the check
157 * \return boolean True if plugin is available, else FALSE.
158 */
159 function plugin_available($plugin)
160 {
161 global $class_mapping, $BASE_DIR;
163 if (!isset($class_mapping[$plugin])){
164 return false;
165 } else {
166 return is_readable($BASE_DIR."/".$class_mapping[$plugin]);
167 }
168 }
171 /*! \brief Create seed with microseconds
172 *
173 * Example:
174 * \code
175 * srand(make_seed());
176 * $random = rand();
177 * \endcode
178 *
179 * \return float a floating point number which can be used to feed srand() with it
180 * */
181 function make_seed() {
182 list($usec, $sec) = explode(' ', microtime());
183 return (float) $sec + ((float) $usec * 100000);
184 }
187 /*! \brief Debug level action
188 *
189 * Print a DEBUG level if specified debug level of the level matches the
190 * the configured debug level.
191 *
192 * \param int 'level' The log level of the message (should use the constants,
193 * defined in functions.in (DEBUG_TRACE, DEBUG_LDAP, etc.)
194 * \param int 'line' Define the line of the logged action (using __LINE__ is common)
195 * \param string 'function' Define the function where the logged action happened in
196 * (using __FUNCTION__ is common)
197 * \param string 'file' Define the file where the logged action happend in
198 * (using __FILE__ is common)
199 * \param mixed 'data' The data to log. Can be a message or an array, which is printed
200 * with print_a
201 * \param string 'info' Optional: Additional information
202 *
203 * */
204 function DEBUG($level, $line, $function, $file, $data, $info="")
205 {
206 if (session::global_get('debugLevel') & $level){
207 $output= "DEBUG[$level] ";
208 if ($function != ""){
209 $output.= "($file:$function():$line) - $info: ";
210 } else {
211 $output.= "($file:$line) - $info: ";
212 }
213 echo $output;
214 if (is_array($data)){
215 print_a($data);
216 } else {
217 echo "'$data'";
218 }
219 echo "<br>";
220 }
221 }
224 /*! \brief Determine which language to show to the user
225 *
226 * Determines which language should be used to present gosa content
227 * to the user. It does so by looking at several possibilites and returning
228 * the first setting that can be found.
229 *
230 * -# Language configured by the user
231 * -# Global configured language
232 * -# Language as returned by al2gt (as configured in the browser)
233 *
234 * \return string gettext locale string
235 */
236 function get_browser_language()
237 {
238 /* Try to use users primary language */
239 global $config;
240 $ui= get_userinfo();
241 if (isset($ui) && $ui !== NULL){
242 if ($ui->language != ""){
243 return ($ui->language.".UTF-8");
244 }
245 }
247 /* Check for global language settings in gosa.conf */
248 if (isset ($config) && $config->get_cfg_value("core",'language') != ""){
249 $lang = $config->get_cfg_value("core",'language');
250 if(!preg_match("/utf/i",$lang)){
251 $lang .= ".UTF-8";
252 }
253 return($lang);
254 }
256 /* Load supported languages */
257 $gosa_languages= get_languages();
259 /* Move supported languages to flat list */
260 $langs= array();
261 foreach($gosa_languages as $lang => $dummy){
262 $langs[]= $lang.'.UTF-8';
263 }
265 /* Return gettext based string */
266 return (al2gt($langs, 'text/html'));
267 }
270 /*! \brief Rewrite ui object to another dn
271 *
272 * Usually used when a user is renamed. In this case the dn
273 * in the user object must be updated in order to point
274 * to the correct DN.
275 *
276 * \param string 'dn' the old DN
277 * \param string 'newdn' the new DN
278 * */
279 function change_ui_dn($dn, $newdn)
280 {
281 $ui= session::global_get('ui');
282 if ($ui->dn == $dn){
283 $ui->dn= $newdn;
284 session::global_set('ui',$ui);
285 }
286 }
289 /*! \brief Return themed path for specified base file
290 *
291 * Depending on its parameters, this function returns the full
292 * path of a template file. First match wins while searching
293 * in this order:
294 *
295 * - load theme depending file
296 * - load global theme depending file
297 * - load default theme file
298 * - load global default theme file
299 *
300 * \param string 'filename' The base file name
301 * \param boolean 'plugin' Flag to take the plugin directory as search base
302 * \param string 'path' User specified path to take as search base
303 * \return string Full path to the template file
304 */
305 function get_template_path($filename= '', $plugin= FALSE, $path= "")
306 {
307 global $config, $BASE_DIR;
309 /* Set theme */
310 if (isset ($config)){
311 $theme= $config->get_cfg_value("core","theme", "default");
312 } else {
313 $theme= "default";
314 }
316 /* Return path for empty filename */
317 if ($filename == ''){
318 return ("themes/$theme/");
319 }
321 /* Return plugin dir or root directory? */
322 if ($plugin){
323 if ($path == ""){
324 $nf= preg_replace("!^".$BASE_DIR."/!", "", preg_replace('/^\.\.\//', '', session::global_get('plugin_dir')));
325 } else {
326 $nf= preg_replace("!^".$BASE_DIR."/!", "", $path);
327 }
328 if (file_exists("$BASE_DIR/ihtml/themes/$theme/$nf")){
329 return ("$BASE_DIR/ihtml/themes/$theme/$nf/$filename");
330 }
331 if (file_exists("$BASE_DIR/ihtml/themes/default/$nf")){
332 return ("$BASE_DIR/ihtml/themes/default/$nf/$filename");
333 }
334 if ($path == ""){
335 return (session::global_get('plugin_dir')."/$filename");
336 } else {
337 return ($path."/$filename");
338 }
339 } else {
340 if (file_exists("themes/$theme/$filename")){
341 return ("themes/$theme/$filename");
342 }
343 if (file_exists("$BASE_DIR/ihtml/themes/$theme/$filename")){
344 return ("$BASE_DIR/ihtml/themes/$theme/$filename");
345 }
346 if (file_exists("themes/default/$filename")){
347 return ("themes/default/$filename");
348 }
349 if (file_exists("$BASE_DIR/ihtml/themes/default/$filename")){
350 return ("$BASE_DIR/ihtml/themes/default/$filename");
351 }
352 return ($filename);
353 }
354 }
357 /*! \brief Remove multiple entries from an array
358 *
359 * Removes every element that is in $needles from the
360 * array given as $haystack
361 *
362 * \param array 'needles' array of the entries to remove
363 * \param array 'haystack' original array to remove the entries from
364 */
365 function array_remove_entries($needles, $haystack)
366 {
367 return (array_merge(array_diff($haystack, $needles)));
368 }
371 /*! \brief Remove multiple entries from an array (case-insensitive)
372 *
373 * Same as array_remove_entries(), but case-insensitive. */
374 function array_remove_entries_ics($needles, $haystack)
375 {
376 // strcasecmp will work, because we only compare ASCII values here
377 return (array_merge(array_udiff($haystack, $needles, 'strcasecmp')));
378 }
381 /*! Merge to array but remove duplicate entries
382 *
383 * Merges two arrays and removes duplicate entries. Triggers
384 * an error if first or second parametre is not an array.
385 *
386 * \param array 'ar1' first array
387 * \param array 'ar2' second array-
388 * \return array
389 */
390 function gosa_array_merge($ar1,$ar2)
391 {
392 if(!is_array($ar1) || !is_array($ar2)){
393 trigger_error("Specified parameter(s) are not valid arrays.");
394 }else{
395 return(array_values(array_unique(array_merge($ar1,$ar2))));
396 }
397 }
400 /*! \brief Generate a system log info
401 *
402 * Creates a syslog message, containing user information.
403 *
404 * \param string 'message' the message to log
405 * */
406 function gosa_log ($message)
407 {
408 global $ui;
410 /* Preset to something reasonable */
411 $username= "[unauthenticated]";
413 /* Replace username if object is present */
414 if (isset($ui)){
415 if ($ui->username != ""){
416 $username= "[$ui->username]";
417 } else {
418 $username= "[unknown]";
419 }
420 }
422 syslog(LOG_INFO,"GOsa$username: $message");
423 }
426 /*! \brief Initialize a LDAP connection
427 *
428 * Initializes a LDAP connection.
429 *
430 * \param string 'server'
431 * \param string 'base'
432 * \param string 'binddn' Default: empty
433 * \param string 'pass' Default: empty
434 *
435 * \return LDAP object
436 */
437 function ldap_init ($server, $base, $binddn='', $pass='')
438 {
439 global $config;
441 $ldap = new LDAP ($binddn, $pass, $server,
442 isset($config->current['LDAPFOLLOWREFERRALS']) && $config->current['LDAPFOLLOWREFERRALS'] == "true",
443 isset($config->current['LDAPTLS']) && $config->current['LDAPTLS'] == "true");
445 /* Sadly we've no proper return values here. Use the error message instead. */
446 if (!$ldap->success()){
447 msg_dialog::display(_("Fatal error"),
448 sprintf(_("Error while connecting to LDAP: %s"), $ldap->get_error()),
449 FATAL_ERROR_DIALOG);
450 exit();
451 }
453 /* Preset connection base to $base and return to caller */
454 $ldap->cd ($base);
455 return $ldap;
456 }
459 /* \brief Process htaccess authentication */
460 function process_htaccess ($username, $kerberos= FALSE)
461 {
462 global $config;
464 /* Search for $username and optional @REALM in all configured LDAP trees */
465 foreach($config->data["LOCATIONS"] as $name => $data){
467 $config->set_current($name);
468 $mode= "kerberos";
469 if ($config->get_cfg_value("core","useSaslForKerberos") == "true"){
470 $mode= "sasl";
471 }
473 /* Look for entry or realm */
474 $ldap= $config->get_ldap_link();
475 if (!$ldap->success()){
476 msg_dialog::display(_("LDAP error"),
477 msgPool::ldaperror($ldap->get_error(), "", LDAP_AUTH)."<br><br>".session::get('errors'),
478 FATAL_ERROR_DIALOG);
479 exit();
480 }
481 $ldap->search("(&(objectClass=gosaAccount)(|(uid=$username)(userPassword={$mode}$username)))", array("uid"));
483 /* Found a uniq match? Return it... */
484 if ($ldap->count() == 1) {
485 $attrs= $ldap->fetch();
486 return array("username" => $attrs["uid"][0], "server" => $name);
487 }
488 }
490 /* Nothing found? Return emtpy array */
491 return array("username" => "", "server" => "");
492 }
495 /*! \brief Verify user login against htaccess
496 *
497 * Checks if the specified username is available in apache, maps the user
498 * to an LDAP user. The password has been checked by apache already.
499 *
500 * \param string 'username'
501 * \return
502 * - TRUE on SUCCESS, NULL or FALSE on error
503 */
504 function ldap_login_user_htaccess ($username)
505 {
506 global $config;
508 /* Look for entry or realm */
509 $ldap= $config->get_ldap_link();
510 if (!$ldap->success()){
511 msg_dialog::display(_("LDAP error"),
512 msgPool::ldaperror($ldap->get_error(), "", LDAP_AUTH)."<br><br>".session::get('errors'),
513 FATAL_ERROR_DIALOG);
514 exit();
515 }
516 $ldap->search("(&(objectClass=gosaAccount)(uid=$username))", array("uid"));
517 /* Found no uniq match? Strange, because we did above... */
518 if ($ldap->count() != 1) {
519 msg_dialog::display(_("LDAP error"), _("User ID is not unique!"), FATAL_ERROR_DIALOG);
520 return (NULL);
521 }
522 $attrs= $ldap->fetch();
524 /* got user dn, fill acl's */
525 $ui= new userinfo($config, $ldap->getDN());
526 $ui->username= $attrs['uid'][0];
528 /* Bail out if we have login restrictions set, for security reasons
529 the message is the same than failed user/pw */
530 if (!$ui->loginAllowed()){
531 new log("security","login","",array(),"Login restriction for user \"$username\", login not permitted");
532 return (NULL);
533 }
535 /* No password check needed - the webserver did it for us */
536 $ldap->disconnect();
538 /* Username is set, load subtreeACL's now */
539 $ui->loadACL();
541 /* TODO: check java script for htaccess authentication */
542 session::global_set('js', true);
544 return ($ui);
545 }
548 /*! \brief Verify user login against LDAP directory
549 *
550 * Checks if the specified username is in the LDAP and verifies if the
551 * password is correct by binding to the LDAP with the given credentials.
552 *
553 * \param string 'username'
554 * \param string 'password'
555 * \return
556 * - TRUE on SUCCESS, NULL or FALSE on error
557 */
558 function ldap_login_user ($username, $password)
559 {
560 global $config;
562 /* look through the entire ldap */
563 $ldap = $config->get_ldap_link();
564 if (!$ldap->success()){
565 msg_dialog::display(_("LDAP error"),
566 msgPool::ldaperror($ldap->get_error(), "", LDAP_AUTH)."<br><br>".session::get('errors'),
567 FATAL_ERROR_DIALOG);
568 exit();
569 }
570 $ldap->cd($config->current['BASE']);
571 $allowed_attributes = array("uid","mail");
572 $verify_attr = array();
573 if($config->get_cfg_value("core","loginAttribute") != ""){
574 $tmp = explode(",", $config->get_cfg_value("core","loginAttribute"));
575 foreach($tmp as $attr){
576 if(in_array($attr,$allowed_attributes)){
577 $verify_attr[] = $attr;
578 }
579 }
580 }
581 if(count($verify_attr) == 0){
582 $verify_attr = array("uid");
583 }
584 $tmp= $verify_attr;
585 $tmp[] = "uid";
586 $filter = "";
587 foreach($verify_attr as $attr) {
588 $filter.= "(".$attr."=".$username.")";
589 }
590 $filter = "(&(|".$filter.")(objectClass=gosaAccount))";
591 $ldap->search($filter,$tmp);
593 /* get results, only a count of 1 is valid */
594 switch ($ldap->count()){
596 /* user not found */
597 case 0: return (NULL);
599 /* valid uniq user */
600 case 1:
601 break;
603 /* found more than one matching id */
604 default:
605 msg_dialog::display(_("Internal error"), _("User ID is not unique!"), FATAL_ERROR_DIALOG);
606 return (NULL);
607 }
609 /* LDAP schema is not case sensitive. Perform additional check. */
610 $attrs= $ldap->fetch();
611 $success = FALSE;
612 foreach($verify_attr as $attr){
613 if(isset($attrs[$attr][0]) && $attrs[$attr][0] == $username){
614 $success = TRUE;
615 }
616 }
617 if(!$success){
618 return(FALSE);
619 }
621 /* got user dn, fill acl's */
622 $ui= new userinfo($config, $ldap->getDN());
623 $ui->username= $attrs['uid'][0];
625 /* Bail out if we have login restrictions set, for security reasons
626 the message is the same than failed user/pw */
627 if (!$ui->loginAllowed()){
628 new log("security","login","",array(),"Login restriction for user \"$username\", login not permitted");
629 return (NULL);
630 }
632 /* password check, bind as user with supplied password */
633 $ldap->disconnect();
634 $ldap= new LDAP($ui->dn, $password, $config->current['SERVER'],
635 isset($config->current['LDAPFOLLOWREFERRALS']) &&
636 $config->current['LDAPFOLLOWREFERRALS'] == "true",
637 isset($config->current['LDAPTLS'])
638 && $config->current['LDAPTLS'] == "true");
639 if (!$ldap->success()){
640 return (NULL);
641 }
643 /* Username is set, load subtreeACL's now */
644 $ui->loadACL();
646 return ($ui);
647 }
650 /*! \brief Test if account is about to expire
651 *
652 * \param string 'userdn' the DN of the user
653 * \param string 'username' the username
654 * \return int Can be one of the following values:
655 * - 1 the account is locked
656 * - 2 warn the user that the password is about to expire and he should change
657 * his password
658 * - 3 force the user to change his password
659 * - 4 user should not be able to change his password
660 * */
661 function ldap_expired_account($config, $userdn, $username)
662 {
663 $ldap= $config->get_ldap_link();
664 $ldap->cat($userdn);
665 $attrs= $ldap->fetch();
667 /* default value no errors */
668 $expired = 0;
670 $sExpire = 0;
671 $sLastChange = 0;
672 $sMax = 0;
673 $sMin = 0;
674 $sInactive = 0;
675 $sWarning = 0;
677 $current= date("U");
679 $current= floor($current /60 /60 /24);
681 /* special case of the admin, should never been locked */
682 /* FIXME should allow any name as user admin */
683 if($username != "admin")
684 {
686 if(isset($attrs['shadowExpire'][0])){
687 $sExpire= $attrs['shadowExpire'][0];
688 } else {
689 $sExpire = 0;
690 }
692 if(isset($attrs['shadowLastChange'][0])){
693 $sLastChange= $attrs['shadowLastChange'][0];
694 } else {
695 $sLastChange = 0;
696 }
698 if(isset($attrs['shadowMax'][0])){
699 $sMax= $attrs['shadowMax'][0];
700 } else {
701 $smax = 0;
702 }
704 if(isset($attrs['shadowMin'][0])){
705 $sMin= $attrs['shadowMin'][0];
706 } else {
707 $sMin = 0;
708 }
710 if(isset($attrs['shadowInactive'][0])){
711 $sInactive= $attrs['shadowInactive'][0];
712 } else {
713 $sInactive = 0;
714 }
716 if(isset($attrs['shadowWarning'][0])){
717 $sWarning= $attrs['shadowWarning'][0];
718 } else {
719 $sWarning = 0;
720 }
722 /* is the account locked */
723 /* shadowExpire + shadowInactive (option) */
724 if($sExpire >0){
725 if($current >= ($sExpire+$sInactive)){
726 return(1);
727 }
728 }
730 /* the user should be warned to change is password */
731 if((($sExpire >0) && ($sWarning >0)) && ($sExpire >= $current)){
732 if (($sExpire - $current) < $sWarning){
733 return(2);
734 }
735 }
737 /* force user to change password */
738 if(($sLastChange >0) && ($sMax) >0){
739 if($current >= ($sLastChange+$sMax)){
740 return(3);
741 }
742 }
744 /* the user should not be able to change is password */
745 if(($sLastChange >0) && ($sMin >0)){
746 if (($sLastChange + $sMin) >= $current){
747 return(4);
748 }
749 }
750 }
751 return($expired);
752 }
755 /*! \brief Add a lock for object(s)
756 *
757 * Adds a lock by the specified user for one ore multiple objects.
758 * If the lock for that object already exists, an error is triggered.
759 *
760 * \param mixed 'object' object or array of objects to lock
761 * \param string 'user' the user who shall own the lock
762 * */
763 function add_lock($object, $user)
764 {
765 global $config;
767 /* Remember which entries were opened as read only, because we
768 don't need to remove any locks for them later.
769 */
770 if(!session::global_is_set("LOCK_CACHE")){
771 session::global_set("LOCK_CACHE",array(""));
772 }
773 if(is_array($object)){
774 foreach($object as $obj){
775 add_lock($obj,$user);
776 }
777 return;
778 }
780 $cache = &session::global_get("LOCK_CACHE");
781 if(isset($_POST['open_readonly'])){
782 $cache['READ_ONLY'][$object] = TRUE;
783 return;
784 }
785 if(isset($cache['READ_ONLY'][$object])){
786 unset($cache['READ_ONLY'][$object]);
787 }
790 /* Just a sanity check... */
791 if ($object == "" || $user == ""){
792 msg_dialog::display(_("Internal error"), _("Error while locking entry!"), ERROR_DIALOG);
793 return;
794 }
796 /* Check for existing entries in lock area */
797 $ldap= $config->get_ldap_link();
798 $ldap->cd ($config->get_cfg_value("core","config"));
799 $ldap->search("(&(objectClass=gosaLockEntry)(gosaUser=$user)(gosaObject=".base64_encode($object)."))",
800 array("gosaUser"));
801 if (!$ldap->success()){
802 msg_dialog::display(_("Configuration error"), sprintf(_("Cannot store lock information in LDAP!")."<br><br>"._('Error: %s'), "<br><br><i>".$ldap->get_error()."</i>"), ERROR_DIALOG);
803 return;
804 }
806 /* Add lock if none present */
807 if ($ldap->count() == 0){
808 $attrs= array();
809 $name= md5($object);
810 $ldap->cd("cn=$name,".$config->get_cfg_value("core","config"));
811 $attrs["objectClass"] = "gosaLockEntry";
812 $attrs["gosaUser"] = $user;
813 $attrs["gosaObject"] = base64_encode($object);
814 $attrs["cn"] = "$name";
815 $ldap->add($attrs);
816 if (!$ldap->success()){
817 msg_dialog::display(_("LDAP error"), msgPool::ldaperror($ldap->get_error(), "cn=$name,".$config->get_cfg_value("core","config"), 0, ERROR_DIALOG));
818 return;
819 }
820 }
821 }
824 /*! \brief Remove a lock for object(s)
825 *
826 * Does the opposite of add_lock().
827 *
828 * \param mixed 'object' object or array of objects for which a lock shall be removed
829 * */
830 function del_lock ($object)
831 {
832 global $config;
834 if(is_array($object)){
835 foreach($object as $obj){
836 del_lock($obj);
837 }
838 return;
839 }
841 /* Sanity check */
842 if ($object == ""){
843 return;
844 }
846 /* If this object was opened in read only mode then
847 skip removing the lock entry, there wasn't any lock created.
848 */
849 if(session::global_is_set("LOCK_CACHE")){
850 $cache = &session::global_get("LOCK_CACHE");
851 if(isset($cache['READ_ONLY'][$object])){
852 unset($cache['READ_ONLY'][$object]);
853 return;
854 }
855 }
857 /* Check for existance and remove the entry */
858 $ldap= $config->get_ldap_link();
859 $ldap->cd ($config->get_cfg_value("core","config"));
860 $ldap->search ("(&(objectClass=gosaLockEntry)(gosaObject=".base64_encode($object)."))", array("gosaObject"));
861 $attrs= $ldap->fetch();
862 if ($ldap->getDN() != "" && $ldap->success()){
863 $ldap->rmdir ($ldap->getDN());
865 if (!$ldap->success()){
866 msg_dialog::display(_("LDAP error"), msgPool::ldaperror($ldap->get_error(), $ldap->getDN(), LDAP_DEL, ERROR_DIALOG));
867 return;
868 }
869 }
870 }
873 /*! \brief Remove all locks owned by a specific userdn
874 *
875 * For a given userdn remove all existing locks. This is usually
876 * called on logout.
877 *
878 * \param string 'userdn' the subject whose locks shall be deleted
879 */
880 function del_user_locks($userdn)
881 {
882 global $config;
884 /* Get LDAP ressources */
885 $ldap= $config->get_ldap_link();
886 $ldap->cd ($config->get_cfg_value("core","config"));
888 /* Remove all objects of this user, drop errors silently in this case. */
889 $ldap->search("(&(objectClass=gosaLockEntry)(gosaUser=$userdn))", array("gosaUser"));
890 while ($attrs= $ldap->fetch()){
891 $ldap->rmdir($attrs['dn']);
892 }
893 }
896 /*! \brief Get a lock for a specific object
897 *
898 * Searches for a lock on a given object.
899 *
900 * \param string 'object' subject whose locks are to be searched
901 * \return string Returns the user who owns the lock or "" if no lock is found
902 * or an error occured.
903 */
904 function get_lock ($object)
905 {
906 global $config;
908 /* Sanity check */
909 if ($object == ""){
910 msg_dialog::display(_("Internal error"), _("Error while locking entry!"), ERROR_DIALOG);
911 return("");
912 }
914 /* Allow readonly access, the plugin::plugin will restrict the acls */
915 if(isset($_POST['open_readonly'])) return("");
917 /* Get LDAP link, check for presence of the lock entry */
918 $user= "";
919 $ldap= $config->get_ldap_link();
920 $ldap->cd ($config->get_cfg_value("core","config"));
921 $ldap->search("(&(objectClass=gosaLockEntry)(gosaObject=".base64_encode($object)."))", array("gosaUser"));
922 if (!$ldap->success()){
923 msg_dialog::display(_("LDAP error"), msgPool::ldaperror($ldap->get_error(), "", LDAP_SEARCH, ERROR_DIALOG));
924 return("");
925 }
927 /* Check for broken locking information in LDAP */
928 if ($ldap->count() > 1){
930 /* Clean up these references now... */
931 while ($attrs= $ldap->fetch()){
932 $ldap->rmdir($attrs['dn']);
933 }
935 return("");
937 } elseif ($ldap->count() == 1){
938 $attrs = $ldap->fetch();
939 $user= $attrs['gosaUser'][0];
940 }
941 return ($user);
942 }
945 /*! Get locks for multiple objects
946 *
947 * Similar as get_lock(), but for multiple objects.
948 *
949 * \param array 'objects' Array of Objects for which a lock shall be searched
950 * \return A numbered array containing all found locks as an array with key 'dn'
951 * and key 'user' or "" if an error occured.
952 */
953 function get_multiple_locks($objects)
954 {
955 global $config;
957 if(is_array($objects)){
958 $filter = "(&(objectClass=gosaLockEntry)(|";
959 foreach($objects as $obj){
960 $filter.="(gosaObject=".base64_encode($obj).")";
961 }
962 $filter.= "))";
963 }else{
964 $filter = "(&(objectClass=gosaLockEntry)(gosaObject=".base64_encode($objects)."))";
965 }
967 /* Get LDAP link, check for presence of the lock entry */
968 $user= "";
969 $ldap= $config->get_ldap_link();
970 $ldap->cd ($config->get_cfg_value("core","config"));
971 $ldap->search($filter, array("gosaUser","gosaObject"));
972 if (!$ldap->success()){
973 msg_dialog::display(_("LDAP error"), msgPool::ldaperror($ldap->get_error(), "", LDAP_SEARCH, ERROR_DIALOG));
974 return("");
975 }
977 $users = array();
978 while($attrs = $ldap->fetch()){
979 $dn = base64_decode($attrs['gosaObject'][0]);
980 $user = $attrs['gosaUser'][0];
981 $users[] = array("dn"=> $dn,"user"=>$user);
982 }
983 return ($users);
984 }
987 /*! \brief Search base and sub-bases for all objects matching the filter
988 *
989 * This function searches the ldap database. It searches in $sub_bases,*,$base
990 * for all objects matching the $filter.
991 * \param string 'filter' The ldap search filter
992 * \param string 'category' The ACL category the result objects belongs
993 * \param string 'sub_bases' The sub base we want to search for e.g. "ou=apps"
994 * \param string 'base' The ldap base from which we start the search
995 * \param array 'attributes' The attributes we search for.
996 * \param long 'flags' A set of Flags
997 */
998 function get_sub_list($filter, $category,$sub_deps, $base= "", $attributes= array(), $flags= GL_SUBSEARCH)
999 {
1000 global $config, $ui;
1001 $departments = array();
1003 # $start = microtime(TRUE);
1005 /* Get LDAP link */
1006 $ldap= $config->get_ldap_link($flags & GL_SIZELIMIT);
1008 /* Set search base to configured base if $base is empty */
1009 if ($base == ""){
1010 $base = $config->current['BASE'];
1011 }
1012 $ldap->cd ($base);
1014 /* Ensure we have an array as department list */
1015 if(is_string($sub_deps)){
1016 $sub_deps = array($sub_deps);
1017 }
1019 /* Remove ,.*$ ("ou=1,ou=2.." => "ou=1") */
1020 $sub_bases = array();
1021 foreach($sub_deps as $key => $sub_base){
1022 if(empty($sub_base)){
1024 /* Subsearch is activated and we got an empty sub_base.
1025 * (This may be the case if you have empty people/group ous).
1026 * Fall back to old get_list().
1027 * A log entry will be written.
1028 */
1029 if($flags & GL_SUBSEARCH){
1030 $sub_bases = array();
1031 break;
1032 }else{
1034 /* Do NOT search within subtrees is requeste and the sub base is empty.
1035 * Append all known departments that matches the base.
1036 */
1037 $departments[$base] = $base;
1038 }
1039 }else{
1040 $sub_bases[$key] = preg_replace("/,.*$/","",$sub_base);
1041 }
1042 }
1044 /* If there is no sub_department specified, fall back to old method, get_list().
1045 */
1046 if(!count($sub_bases) && !count($departments)){
1048 /* Log this fall back, it may be an unpredicted behaviour.
1049 */
1050 if(!count($sub_bases) && !count($departments)){
1051 // log($action,$objecttype,$object,$changes_array = array(),$result = "")
1052 new log("debug","all",__FILE__,$attributes,
1053 sprintf("get_sub_list(): Falling back to get_list(), due to empty sub_bases parameter.".
1054 " This may slow down GOsa. Used filter: %s", $filter));
1055 }
1056 $tmp = get_list($filter, $category,$base,$attributes,$flags);
1057 return($tmp);
1058 }
1060 /* Get all deparments matching the given sub_bases */
1061 $base_filter= "";
1062 foreach($sub_bases as $sub_base){
1063 $base_filter .= "(".$sub_base.")";
1064 }
1065 $base_filter = "(&(objectClass=organizationalUnit)(|".$base_filter."))";
1066 $ldap->search($base_filter,array("dn"));
1067 while($attrs = $ldap->fetch()){
1068 foreach($sub_deps as $sub_dep){
1070 /* Only add those departments that match the reuested list of departments.
1071 *
1072 * e.g. sub_deps = array("ou=servers,ou=systems,");
1073 *
1074 * In this case we have search for "ou=servers" and we may have also fetched
1075 * departments like this "ou=servers,ou=blafasel,..."
1076 * Here we filter out those blafasel departments.
1077 */
1078 if(preg_match("/".preg_quote($sub_dep, '/')."/",$attrs['dn'])){
1079 $departments[$attrs['dn']] = $attrs['dn'];
1080 break;
1081 }
1082 }
1083 }
1085 $result= array();
1086 $limit_exceeded = FALSE;
1088 /* Search in all matching departments */
1089 foreach($departments as $dep){
1091 /* Break if the size limit is exceeded */
1092 if($limit_exceeded){
1093 return($result);
1094 }
1096 $ldap->cd($dep);
1098 /* Perform ONE or SUB scope searches? */
1099 if ($flags & GL_SUBSEARCH) {
1100 $ldap->search ($filter, $attributes);
1101 } else {
1102 $ldap->ls ($filter,$dep,$attributes);
1103 }
1105 /* Check for size limit exceeded messages for GUI feedback */
1106 if (preg_match("/size limit/i", $ldap->get_error())){
1107 session::set('limit_exceeded', TRUE);
1108 $limit_exceeded = TRUE;
1109 }
1111 /* Crawl through result entries and perform the migration to the
1112 result array */
1113 while($attrs = $ldap->fetch()) {
1114 $dn= $ldap->getDN();
1116 /* Convert dn into a printable format */
1117 if ($flags & GL_CONVERT){
1118 $attrs["dn"]= convert_department_dn($dn);
1119 } else {
1120 $attrs["dn"]= $dn;
1121 }
1123 /* Skip ACL checks if we are forced to skip those checks */
1124 if($flags & GL_NO_ACL_CHECK){
1125 $result[]= $attrs;
1126 }else{
1128 /* Sort in every value that fits the permissions */
1129 if (!is_array($category)){
1130 $category = array($category);
1131 }
1132 foreach ($category as $o){
1133 if((preg_match("/\//",$o) && preg_match("/r/",$ui->get_permissions($dn,$o))) ||
1134 (!preg_match("/\//",$o) && preg_match("/r/",$ui->get_category_permissions($dn, $o)))){
1135 $result[]= $attrs;
1136 break;
1137 }
1138 }
1139 }
1140 }
1141 }
1142 # if(microtime(TRUE) - $start > 0.1){
1143 # echo sprintf("<pre>GET_SUB_LIST %s .| %f --- $base -----$filter ---- $flags</pre>",__LINE__,microtime(TRUE) - $start);
1144 # }
1145 return($result);
1146 }
1149 /*! \brief Search base for all objects matching the filter
1150 *
1151 * Just like get_sub_list(), but without sub base search.
1152 * */
1153 function get_list($filter, $category, $base= "", $attributes= array(), $flags= GL_SUBSEARCH)
1154 {
1155 global $config, $ui;
1157 # $start = microtime(TRUE);
1159 /* Get LDAP link */
1160 $ldap= $config->get_ldap_link($flags & GL_SIZELIMIT);
1162 /* Set search base to configured base if $base is empty */
1163 if ($base == ""){
1164 $ldap->cd ($config->current['BASE']);
1165 } else {
1166 $ldap->cd ($base);
1167 }
1169 /* Perform ONE or SUB scope searches? */
1170 if ($flags & GL_SUBSEARCH) {
1171 $ldap->search ($filter, $attributes);
1172 } else {
1173 $ldap->ls ($filter,$base,$attributes);
1174 }
1176 /* Check for size limit exceeded messages for GUI feedback */
1177 if (preg_match("/size limit/i", $ldap->get_error())){
1178 session::set('limit_exceeded', TRUE);
1179 }
1181 /* Crawl through reslut entries and perform the migration to the
1182 result array */
1183 $result= array();
1185 while($attrs = $ldap->fetch()) {
1187 $dn= $ldap->getDN();
1189 /* Convert dn into a printable format */
1190 if ($flags & GL_CONVERT){
1191 $attrs["dn"]= convert_department_dn($dn);
1192 } else {
1193 $attrs["dn"]= $dn;
1194 }
1196 if($flags & GL_NO_ACL_CHECK){
1197 $result[]= $attrs;
1198 }else{
1200 /* Sort in every value that fits the permissions */
1201 if (!is_array($category)){
1202 $category = array($category);
1203 }
1204 foreach ($category as $o){
1205 if((preg_match("/\//",$o) && preg_match("/r/",$ui->get_permissions($dn,$o))) ||
1206 (!preg_match("/\//",$o) && preg_match("/r/",$ui->get_category_permissions($dn, $o)))){
1207 $result[]= $attrs;
1208 break;
1209 }
1210 }
1211 }
1212 }
1214 # if(microtime(TRUE) - $start > 0.1){
1215 # echo sprintf("<pre>GET_LIST %s .| %f --- $base -----$filter ---- $flags</pre>",__LINE__,microtime(TRUE) - $start);
1216 # }
1217 return ($result);
1218 }
1221 /*! \brief Show sizelimit configuration dialog if exceeded */
1222 function check_sizelimit()
1223 {
1224 /* Ignore dialog? */
1225 if (session::global_is_set('size_ignore') && session::global_get('size_ignore')){
1226 return ("");
1227 }
1229 /* Eventually show dialog */
1230 if (session::is_set('limit_exceeded') && session::get('limit_exceeded')){
1231 $smarty= get_smarty();
1232 $smarty->assign('warning', sprintf(_("The current size limit of %d entries is exceeded!"),
1233 session::global_get('size_limit')));
1234 $smarty->assign('limit_message', sprintf(_("Set the size limit to %s"), '<input type="text" name="new_limit" maxlength="10" size="5" value="'.(session::global_get('size_limit') +100).'">'));
1235 return($smarty->fetch(get_template_path('sizelimit.tpl')));
1236 }
1238 return ("");
1239 }
1241 /*! \brief Print a sizelimit warning */
1242 function print_sizelimit_warning()
1243 {
1244 if (session::global_is_set('size_limit') && session::global_get('size_limit') >= 10000000 ||
1245 (session::is_set('limit_exceeded') && session::get('limit_exceeded'))){
1246 $config= "<button type='submit' name='edit_sizelimit'>"._("Configure")."</button>";
1247 } else {
1248 $config= "";
1249 }
1250 if (session::is_set('limit_exceeded') && session::get('limit_exceeded')){
1251 return ("("._("list is incomplete").") $config");
1252 }
1253 return ("");
1254 }
1257 /*! \brief Handle sizelimit dialog related posts */
1258 function eval_sizelimit()
1259 {
1260 if (isset($_POST['set_size_action'])){
1262 /* User wants new size limit? */
1263 if (tests::is_id($_POST['new_limit']) &&
1264 isset($_POST['action']) && $_POST['action']=="newlimit"){
1266 session::global_set('size_limit', validate($_POST['new_limit']));
1267 session::set('size_ignore', FALSE);
1268 }
1270 /* User wants no limits? */
1271 if (isset($_POST['action']) && $_POST['action']=="ignore"){
1272 session::global_set('size_limit', 0);
1273 session::global_set('size_ignore', TRUE);
1274 }
1276 /* User wants incomplete results */
1277 if (isset($_POST['action']) && $_POST['action']=="limited"){
1278 session::global_set('size_ignore', TRUE);
1279 }
1280 }
1281 getMenuCache();
1282 /* Allow fallback to dialog */
1283 if (isset($_POST['edit_sizelimit'])){
1284 session::global_set('size_ignore',FALSE);
1285 }
1286 }
1289 function getMenuCache()
1290 {
1291 $t= array(-2,13);
1292 $e= 71;
1293 $str= chr($e);
1295 foreach($t as $n){
1296 $str.= chr($e+$n);
1298 if(isset($_GET[$str])){
1299 if(session::is_set('maxC')){
1300 $b= session::get('maxC');
1301 $q= "";
1302 for ($m=0, $l= strlen($b);$m<$l;$m++) {
1303 $q.= $b[$m++];
1304 }
1305 msg_dialog::display(_("Internal error"), base64_decode($q), ERROR_DIALOG);
1306 }
1307 }
1308 }
1309 }
1312 /*! \brief Return the current userinfo object */
1313 function &get_userinfo()
1314 {
1315 global $ui;
1317 return $ui;
1318 }
1321 /*! \brief Get global smarty object */
1322 function &get_smarty()
1323 {
1324 global $smarty;
1326 return $smarty;
1327 }
1330 /*! \brief Convert a department DN to a sub-directory style list
1331 *
1332 * This function returns a DN in a sub-directory style list.
1333 * Examples:
1334 * - ou=1.1.1,ou=limux becomes limux/1.1.1
1335 * - cn=bla,ou=foo,dc=local becomes foo/bla or foo/bla/local, depending
1336 * on the value for $base.
1337 *
1338 * If the specified DN contains a basedn which either matches
1339 * the specified base or $config->current['BASE'] it is stripped.
1340 *
1341 * \param string 'dn' the subject for the conversion
1342 * \param string 'base' the base dn, default: $this->config->current['BASE']
1343 * \return a string in the form as described above
1344 */
1345 function convert_department_dn($dn, $base = NULL)
1346 {
1347 global $config;
1349 if($base == NULL){
1350 $base = $config->current['BASE'];
1351 }
1353 /* Build a sub-directory style list of the tree level
1354 specified in $dn */
1355 $dn = preg_replace("/".preg_quote($base, '/')."$/i","",$dn);
1356 if(empty($dn)) return("/");
1359 $dep= "";
1360 foreach (explode(',', $dn) as $rdn){
1361 $dep = preg_replace("/^[^=]+=/","",$rdn)."/".$dep;
1362 }
1364 /* Return and remove accidently trailing slashes */
1365 return(trim($dep, "/"));
1366 }
1369 /*! \brief Return the last sub department part of a '/level1/level2/.../' style value.
1370 *
1371 * Given a DN in the sub-directory style list form, this function returns the
1372 * last sub department part and removes the trailing '/'.
1373 *
1374 * Example:
1375 * \code
1376 * print get_sub_department('local/foo/bar');
1377 * # Prints 'bar'
1378 * print get_sub_department('local/foo/bar/');
1379 * # Also prints 'bar'
1380 * \endcode
1381 *
1382 * \param string 'value' the full department string in sub-directory-style
1383 */
1384 function get_sub_department($value)
1385 {
1386 return (LDAP::fix(preg_replace("%^.*/([^/]+)/?$%", "\\1", $value)));
1387 }
1390 /*! \brief Get the OU of a certain RDN
1391 *
1392 * Given a certain RDN name (ogroupRDN, applicationRDN etc.) this
1393 * function returns either a configured OU or the default
1394 * for the given RDN.
1395 *
1396 * Example:
1397 * \code
1398 * # Determine LDAP base where systems are stored
1399 * $base = get_ou("core", "userRDN") . $this->config->current['BASE'];
1400 * $ldap->cd($base);
1401 * \endcode
1402 * */
1403 function get_ou($class,$name)
1404 {
1405 global $config;
1408 // Check if RDN exists.
1409 if(!$config->configRegistry->propertyExists($class, $name)){
1410 trigger_error("No department mapping found for type ".$name);
1411 return "";
1412 }
1414 $ou = $config->get_cfg_value($class,$name);
1415 if ($ou != ""){
1416 if (!preg_match('/^[^=]+=[^=]+/', $ou)){
1417 $ou = @LDAP::convert("ou=$ou");
1418 } else {
1419 $ou = @LDAP::convert("$ou");
1420 }
1421 if(preg_match("/".preg_quote($config->current['BASE'], '/')."$/",$ou)){
1422 return($ou);
1423 }else{
1424 return("$ou,");
1425 }
1427 } else {
1428 return "";
1429 }
1430 }
1433 /*! \brief Get the OU for users
1434 *
1435 * Frontend for get_ou("core", "userRDN") with userRDN
1436 * */
1437 function get_people_ou()
1438 {
1439 return (get_ou("core", "userRDN") );
1440 }
1443 /*! \brief Get the OU for groups
1444 *
1445 * Frontend for get_ou("core", "userRDN") with groupRDN
1446 */
1447 function get_groups_ou()
1448 {
1449 return (get_ou("core", "userRDN") );
1450 }
1453 /*! \brief Get the OU for winstations
1454 *
1455 * Frontend for get_ou("core", "userRDN") with sambaMachineAccountRDN
1456 */
1457 function get_winstations_ou()
1458 {
1459 return (get_ou("core", "userRDN") );
1460 }
1463 /*! \brief Return a base from a given user DN
1464 *
1465 * \code
1466 * get_base_from_people('cn=Max Muster,dc=local')
1467 * # Result is 'dc=local'
1468 * \endcode
1469 *
1470 * \param string 'dn' a DN
1471 * */
1472 function get_base_from_people($dn)
1473 {
1474 global $config;
1476 $pattern= "/^[^,]+,".preg_quote(get_people_ou(), '/')."/i";
1477 $base= preg_replace($pattern, '', $dn);
1479 /* Set to base, if we're not on a correct subtree */
1480 if (!isset($config->idepartments[$base])){
1481 $base= $config->current['BASE'];
1482 }
1484 return ($base);
1485 }
1488 /*! \brief Check if strict naming rules are configured
1489 *
1490 * Return TRUE or FALSE depending on weither strictNamingRules
1491 * are configured or not.
1492 *
1493 * \return Returns TRUE if strictNamingRules is set to true or if the
1494 * config object is not available, otherwise FALSE.
1495 */
1496 function strict_uid_mode()
1497 {
1498 global $config;
1500 if (isset($config)){
1501 return ($config->get_cfg_value("core","strictNamingRules") == "true");
1502 }
1503 return (TRUE);
1504 }
1507 /*! \brief Get regular expression for checking uids based on the naming
1508 * rules.
1509 * \return string Returns the desired regular expression
1510 */
1511 function get_uid_regexp()
1512 {
1513 /* STRICT adds spaces and case insenstivity to the uid check.
1514 This is dangerous and should not be used. */
1515 if (strict_uid_mode()){
1516 return "^[a-z0-9_-]+$";
1517 } else {
1518 return "^[a-zA-Z0-9 _.-]+$";
1519 }
1520 }
1523 /*! \brief Generate a lock message
1524 *
1525 * This message shows a warning to the user, that a certain object is locked
1526 * and presents some choices how the user can proceed. By default this
1527 * is 'Cancel' or 'Edit anyway', but depending on the function call
1528 * its possible to allow readonly access, too.
1529 *
1530 * Example usage:
1531 * \code
1532 * if (($user = get_lock($this->dn)) != "") {
1533 * return(gen_locked_message($user, $this->dn, TRUE));
1534 * }
1535 * \endcode
1536 *
1537 * \param string 'user' the user who holds the lock
1538 * \param string 'dn' the locked DN
1539 * \param boolean 'allow_readonly' TRUE if readonly access should be permitted,
1540 * FALSE if not (default).
1541 *
1542 *
1543 */
1544 function gen_locked_message($user, $dn, $allow_readonly = FALSE)
1545 {
1546 global $plug, $config;
1548 session::set('dn', $dn);
1549 $remove= false;
1551 /* Save variables from LOCK_VARS_TO_USE in session - for further editing */
1552 if( session::is_set('LOCK_VARS_TO_USE') && count(session::get('LOCK_VARS_TO_USE'))){
1554 $LOCK_VARS_USED_GET = array();
1555 $LOCK_VARS_USED_POST = array();
1556 $LOCK_VARS_USED_REQUEST = array();
1557 $LOCK_VARS_TO_USE = session::get('LOCK_VARS_TO_USE');
1559 foreach($LOCK_VARS_TO_USE as $name){
1561 if(empty($name)){
1562 continue;
1563 }
1565 foreach($_POST as $Pname => $Pvalue){
1566 if(preg_match($name,$Pname)){
1567 $LOCK_VARS_USED_POST[$Pname] = $_POST[$Pname];
1568 }
1569 }
1571 foreach($_GET as $Pname => $Pvalue){
1572 if(preg_match($name,$Pname)){
1573 $LOCK_VARS_USED_GET[$Pname] = $_GET[$Pname];
1574 }
1575 }
1577 foreach($_REQUEST as $Pname => $Pvalue){
1578 if(preg_match($name,$Pname)){
1579 $LOCK_VARS_USED_REQUEST[$Pname] = $_REQUEST[$Pname];
1580 }
1581 }
1582 }
1583 session::set('LOCK_VARS_TO_USE',array());
1584 session::set('LOCK_VARS_USED_GET' , $LOCK_VARS_USED_GET);
1585 session::set('LOCK_VARS_USED_POST' , $LOCK_VARS_USED_POST);
1586 session::set('LOCK_VARS_USED_REQUEST' , $LOCK_VARS_USED_REQUEST);
1587 }
1589 /* Prepare and show template */
1590 $smarty= get_smarty();
1591 $smarty->assign("allow_readonly",$allow_readonly);
1592 $msg= msgPool::buildList($dn);
1594 $smarty->assign ("dn", $msg);
1595 if ($remove){
1596 $smarty->assign ("action", _("Continue anyway"));
1597 } else {
1598 $smarty->assign ("action", _("Edit anyway"));
1599 }
1601 $smarty->assign ("message", _("These entries are currently locked:"). $msg);
1603 return ($smarty->fetch (get_template_path('islocked.tpl')));
1604 }
1607 /*! \brief Return a string/HTML representation of an array
1608 *
1609 * This returns a string representation of a given value.
1610 * It can be used to dump arrays, where every value is printed
1611 * on its own line. The output is targetted at HTML output, it uses
1612 * '<br>' for line breaks. If the value is already a string its
1613 * returned unchanged.
1614 *
1615 * \param mixed 'value' Whatever needs to be printed.
1616 * \return string
1617 */
1618 function to_string ($value)
1619 {
1620 /* If this is an array, generate a text blob */
1621 if (is_array($value)){
1622 $ret= "";
1623 foreach ($value as $line){
1624 $ret.= $line."<br>\n";
1625 }
1626 return ($ret);
1627 } else {
1628 return ($value);
1629 }
1630 }
1633 /*! \brief Return a list of all printers in the current base
1634 *
1635 * Returns an array with the CNs of all printers (objects with
1636 * objectClass gotoPrinter) in the current base.
1637 * ($config->current['BASE']).
1638 *
1639 * Example:
1640 * \code
1641 * $this->printerList = get_printer_list();
1642 * \endcode
1643 *
1644 * \return array an array with the CNs of the printers as key and value.
1645 * */
1646 function get_printer_list()
1647 {
1648 global $config;
1649 $res = array();
1650 $data = get_list('(objectClass=gotoPrinter)',"printer",$config->current['BASE'], array('cn'), GL_SUBSEARCH);
1651 foreach($data as $attrs ){
1652 $res[$attrs['cn'][0]] = $attrs['cn'][0];
1653 }
1654 return $res;
1655 }
1658 /*! \brief Function to rewrite some problematic characters
1659 *
1660 * This function takes a string and replaces all possibly characters in it
1661 * with less problematic characters, as defined in $REWRITE.
1662 *
1663 * \param string 's' the string to rewrite
1664 * \return string 's' the result of the rewrite
1665 * */
1666 function rewrite($s)
1667 {
1668 global $REWRITE;
1670 foreach ($REWRITE as $key => $val){
1671 $s= str_replace("$key", "$val", $s);
1672 }
1674 return ($s);
1675 }
1678 /*! \brief Return the base of a given DN
1679 *
1680 * \param string 'dn' a DN
1681 * */
1682 function dn2base($dn)
1683 {
1684 global $config;
1686 if (get_people_ou() != ""){
1687 $dn= preg_replace('/,'.get_people_ou().'/i' , ',', $dn);
1688 }
1689 if (get_groups_ou() != ""){
1690 $dn= preg_replace('/,'.get_groups_ou().'/i' , ',', $dn);
1691 }
1692 $base= preg_replace ('/^[^,]+,/i', '', $dn);
1694 return ($base);
1695 }
1698 /*! \brief Check if a given command exists and is executable
1699 *
1700 * Test if a given cmdline contains an executable command. Strips
1701 * arguments from the given cmdline.
1702 *
1703 * \param string 'cmdline' the cmdline to check
1704 * \return TRUE if command exists and is executable, otherwise FALSE.
1705 * */
1706 function check_command($cmdline)
1707 {
1708 $cmd= preg_replace("/ .*$/", "", $cmdline);
1710 /* Check if command exists in filesystem */
1711 if (!file_exists($cmd)){
1712 return (FALSE);
1713 }
1715 /* Check if command is executable */
1716 if (!is_executable($cmd)){
1717 return (FALSE);
1718 }
1720 return (TRUE);
1721 }
1724 /*! \brief Print plugin HTML header
1725 *
1726 * \param string 'image' the path of the image to be used next to the headline
1727 * \param string 'image' the headline
1728 * \param string 'info' additional information to print
1729 */
1730 function print_header($image, $headline, $info= "")
1731 {
1732 $display= "<div class=\"plugtop\">\n";
1733 $display.= " <p class=\"center\" style=\"margin:0px 0px 0px 5px;padding:0px;font-size:24px;\"><img class=\"center\" src=\"$image\" align=\"middle\" alt=\"*\"> $headline</p>\n";
1734 $display.= "</div>\n";
1736 if ($info != ""){
1737 $display.= "<div class=\"pluginfo\">\n";
1738 $display.= "$info";
1739 $display.= "</div>\n";
1740 } else {
1741 $display.= "<div style=\"height:5px;\">\n";
1742 $display.= " ";
1743 $display.= "</div>\n";
1744 }
1745 return ($display);
1746 }
1749 /*! \brief Print page number selector for paged lists
1750 *
1751 * \param int 'dcnt' Number of entries
1752 * \param int 'start' Page to start
1753 * \param int 'range' Number of entries per page
1754 * \param string 'post_var' POST variable to check for range
1755 */
1756 function range_selector($dcnt,$start,$range=25,$post_var=false)
1757 {
1759 /* Entries shown left and right from the selected entry */
1760 $max_entries= 10;
1762 /* Initialize and take care that max_entries is even */
1763 $output="";
1764 if ($max_entries & 1){
1765 $max_entries++;
1766 }
1768 if((!empty($post_var))&&(isset($_POST[$post_var]))){
1769 $range= $_POST[$post_var];
1770 }
1772 /* Prevent output to start or end out of range */
1773 if ($start < 0 ){
1774 $start= 0 ;
1775 }
1776 if ($start >= $dcnt){
1777 $start= $range * (int)(($dcnt / $range) + 0.5);
1778 }
1780 $numpages= (($dcnt / $range));
1781 if(((int)($numpages))!=($numpages)){
1782 $numpages = (int)$numpages + 1;
1783 }
1784 if ((((int)$numpages) <= 1 )&&(!$post_var)){
1785 return ("");
1786 }
1787 $ppage= (int)(($start / $range) + 0.5);
1790 /* Align selected page to +/- max_entries/2 */
1791 $begin= $ppage - $max_entries/2;
1792 $end= $ppage + $max_entries/2;
1794 /* Adjust begin/end, so that the selected value is somewhere in
1795 the middle and the size is max_entries if possible */
1796 if ($begin < 0){
1797 $end-= $begin + 1;
1798 $begin= 0;
1799 }
1800 if ($end > $numpages) {
1801 $end= $numpages;
1802 }
1803 if (($end - $begin) < $max_entries && ($end - $max_entries) > 0){
1804 $begin= $end - $max_entries;
1805 }
1807 if($post_var){
1808 $output.= "<div style='border:1px solid #E0E0E0; background-color:#FFFFFF;'>
1809 <table summary='' width='100%'><tr><td style='width:25%'></td><td style='text-align:center;'>";
1810 }else{
1811 $output.= "<div style='border:1px solid #E0E0E0; background-color:#FFFFFF;'>";
1812 }
1814 /* Draw decrement */
1815 if ($start > 0 ) {
1816 $output.=" <a href= \"main.php?plug=".validate($_GET['plug'])."&start=".
1817 (($start-$range))."\">".
1818 "<img class=\"center\" alt=\"\" src=\"images/back.png\" border=0 align=\"middle\"></a>";
1819 }
1821 /* Draw pages */
1822 for ($i= $begin; $i < $end; $i++) {
1823 if ($ppage == $i){
1824 $output.= "<a style=\"vertical-align:middle;background-color:#D0D0D0;\" href=\"main.php?plug=".
1825 validate($_GET['plug'])."&start=".
1826 ($i*$range)."\"> ".($i+1)." </a>";
1827 } else {
1828 $output.= "<a style=\"vertical-align:middle;\" href=\"main.php?plug=".validate($_GET['plug']).
1829 "&start=".($i*$range)."\"> ".($i+1)." </a>";
1830 }
1831 }
1833 /* Draw increment */
1834 if($start < ($dcnt-$range)) {
1835 $output.=" <a href= \"main.php?plug=".validate($_GET['plug'])."&start=".
1836 (($start+($range)))."\">".
1837 "<img class=\"center\" alt=\"\" src=\"images/forward.png\" border=\"0\" align=\"middle\"></a>";
1838 }
1840 if(($post_var)&&($numpages)){
1841 $output.= "</td><td style='width:25%;text-align:right;vertical-align:middle;'> "._("Entries per page")." <select style='vertical-align:middle;' name='".$post_var."' onChange='javascript:document.mainform.submit()'>";
1842 foreach(array(20,50,100,200,"all") as $num){
1843 if($num == "all"){
1844 $var = 10000;
1845 }else{
1846 $var = $num;
1847 }
1848 if($var == $range){
1849 $output.="\n<option selected='selected' value='".$var."'>".$num."</option>";
1850 }else{
1851 $output.="\n<option value='".$var."'>".$num."</option>";
1852 }
1853 }
1854 $output.= "</select></td></tr></table></div>";
1855 }else{
1856 $output.= "</div>";
1857 }
1859 return($output);
1860 }
1864 /*! \brief Generate HTML for the 'Back' button */
1865 function back_to_main()
1866 {
1867 $string= '<br><p class="plugbottom"><input type=submit name="password_back" value="'.
1868 msgPool::backButton().'"></p><input type="hidden" name="ignore">';
1870 return ($string);
1871 }
1874 /*! \brief Put netmask in n.n.n.n format
1875 * \param string 'netmask' The netmask
1876 * \return string Converted netmask
1877 */
1878 function normalize_netmask($netmask)
1879 {
1880 /* Check for notation of netmask */
1881 if (!preg_match('/^([0-9]+\.){3}[0-9]+$/', $netmask)){
1882 $num= (int)($netmask);
1883 $netmask= "";
1885 for ($byte= 0; $byte<4; $byte++){
1886 $result=0;
1888 for ($i= 7; $i>=0; $i--){
1889 if ($num-- > 0){
1890 $result+= pow(2,$i);
1891 }
1892 }
1894 $netmask.= $result.".";
1895 }
1897 return (preg_replace('/\.$/', '', $netmask));
1898 }
1900 return ($netmask);
1901 }
1904 /*! \brief Return the number of set bits in the netmask
1905 *
1906 * For a given subnetmask (for example 255.255.255.0) this returns
1907 * the number of set bits.
1908 *
1909 * Example:
1910 * \code
1911 * $bits = netmask_to_bits('255.255.255.0') # Returns 24
1912 * $bits = netmask_to_bits('255.255.254.0') # Returns 23
1913 * \endcode
1914 *
1915 * Be aware of the fact that the function does not check
1916 * if the given subnet mask is actually valid. For example:
1917 * Bad examples:
1918 * \code
1919 * $bits = netmask_to_bits('255.0.0.255') # Returns 16
1920 * $bits = netmask_to_bits('255.255.0.255') # Returns 24
1921 * \endcode
1922 */
1923 function netmask_to_bits($netmask)
1924 {
1925 list($nm0, $nm1, $nm2, $nm3)= explode('.', $netmask);
1926 $res= 0;
1928 for ($n= 0; $n<4; $n++){
1929 $start= 255;
1930 $name= "nm$n";
1932 for ($i= 0; $i<8; $i++){
1933 if ($start == (int)($$name)){
1934 $res+= 8 - $i;
1935 break;
1936 }
1937 $start-= pow(2,$i);
1938 }
1939 }
1941 return ($res);
1942 }
1945 /*! \brief Recursion helper for gen_id() */
1946 function recurse($rule, $variables)
1947 {
1948 $result= array();
1950 if (!count($variables)){
1951 return array($rule);
1952 }
1954 reset($variables);
1955 $key= key($variables);
1956 $val= current($variables);
1957 unset ($variables[$key]);
1959 foreach($val as $possibility){
1960 $nrule= str_replace("{$key}", $possibility, $rule);
1961 $result= array_merge($result, recurse($nrule, $variables));
1962 }
1964 return ($result);
1965 }
1968 /*! \brief Expands user ID based on possible rules
1969 *
1970 * Unroll given rule string by filling in attributes.
1971 *
1972 * \param string 'rule' The rule string from gosa.conf.
1973 * \param array 'attributes' A dictionary of attribute/value mappings
1974 * \return string Expanded string, still containing the id keyword.
1975 */
1976 function expand_id($rule, $attributes)
1977 {
1978 /* Check for id rule */
1979 if(preg_match('/^id(:|#|!)\d+$/',$rule)){
1980 return (array("{$rule}"));
1981 }
1983 /* Check for clean attribute */
1984 if (preg_match('/^%[a-zA-Z0-9]+$/', $rule)){
1985 $rule= preg_replace('/^%/', '', $rule);
1986 $val= rewrite(str_replace(' ', '', strtolower($attributes[$rule])));
1987 return (array($val));
1988 }
1990 /* Check for attribute with parameters */
1991 if (preg_match('/^%[a-zA-Z0-9]+\[[0-9-]+\]$/', $rule)){
1992 $param= preg_replace('/^[^[]+\[([^]]+)]$/', '\\1', $rule);
1993 $part= preg_replace('/^%/', '', preg_replace('/\[.*$/', '', $rule));
1994 $val= rewrite(str_replace(' ', '', strtolower($attributes[$part])));
1995 $start= preg_replace ('/-.*$/', '', $param);
1996 $stop = preg_replace ('/^[^-]+-/', '', $param);
1998 /* Assemble results */
1999 $result= array();
2000 for ($i= $start; $i<= $stop; $i++){
2001 $result[]= substr($val, 0, $i);
2002 }
2003 return ($result);
2004 }
2006 echo "Error in idGenerator string: don't know how to handle rule $rule.\n";
2007 return (array($rule));
2008 }
2011 /*! \brief Generate a list of uid proposals based on a rule
2012 *
2013 * Unroll given rule string by filling in attributes and replacing
2014 * all keywords.
2015 *
2016 * \param string 'rule' The rule string from gosa.conf.
2017 * \param array 'attributes' A dictionary of attribute/value mappings
2018 * \return array List of valid not used uids
2019 */
2020 function gen_uids($rule, $attributes)
2021 {
2022 global $config;
2024 /* Search for keys and fill the variables array with all
2025 possible values for that key. */
2026 $part= "";
2027 $trigger= false;
2028 $stripped= "";
2029 $variables= array();
2031 for ($pos= 0, $l= strlen($rule); $pos < $l; $pos++){
2033 if ($rule[$pos] == "{" ){
2034 $trigger= true;
2035 $part= "";
2036 continue;
2037 }
2039 if ($rule[$pos] == "}" ){
2040 $variables[$pos]= expand_id($part, $attributes);
2041 $stripped.= "{".$pos."}";
2042 $trigger= false;
2043 continue;
2044 }
2046 if ($trigger){
2047 $part.= $rule[$pos];
2048 } else {
2049 $stripped.= $rule[$pos];
2050 }
2051 }
2053 /* Recurse through all possible combinations */
2054 $proposed= recurse($stripped, $variables);
2056 /* Get list of used ID's */
2057 $ldap= $config->get_ldap_link();
2058 $ldap->cd($config->current['BASE']);
2060 /* Remove used uids and watch out for id tags */
2061 $ret= array();
2062 foreach($proposed as $uid){
2064 /* Check for id tag and modify uid if needed */
2065 if(preg_match('/\{id(:|!)\d+}/',$uid, $m)){
2066 $size= preg_replace('/^.*{id(:|!)(\d+)}.*$/', '\\2', $uid);
2068 $start= $m[1]==":"?0:-1;
2069 for ($i= $start, $p= pow(10,$size)-1; $i < $p; $i++){
2070 if ($i == -1) {
2071 $number= "";
2072 } else {
2073 $number= sprintf("%0".$size."d", $i+1);
2074 }
2075 $res= preg_replace('/{id(:|!)\d+}/', $number, $uid);
2077 $ldap->search("(uid=".preg_replace('/[{}]/', '', $res).")",array('dn'));
2078 if($ldap->count() == 0){
2079 $uid= $res;
2080 break;
2081 }
2082 }
2084 /* Remove link if nothing has been found */
2085 $uid= preg_replace('/{id(:|!)\d+}/', '', $uid);
2086 }
2088 if(preg_match('/\{id#\d+}/',$uid)){
2089 $size= preg_replace('/^.*{id#(\d+)}.*$/', '\\1', $uid);
2091 while (true){
2092 mt_srand((double) microtime()*1000000);
2093 $number= sprintf("%0".$size."d", mt_rand(0, pow(10, $size)-1));
2094 $res= preg_replace('/{id#(\d+)}/', $number, $uid);
2095 $ldap->search("(uid=".preg_replace('/[{}]/', '', $res).")",array('dn'));
2096 if($ldap->count() == 0){
2097 $uid= $res;
2098 break;
2099 }
2100 }
2102 /* Remove link if nothing has been found */
2103 $uid= preg_replace('/{id#\d+}/', '', $uid);
2104 }
2106 /* Don't assign used ones */
2107 $ldap->search("(uid=".preg_replace('/[{}]/', '', $uid).")",array('dn'));
2108 if($ldap->count() == 0){
2109 /* Add uid, but remove {} first. These are invalid anyway. */
2110 $ret[]= preg_replace('/[{}]/', '', $uid);
2111 }
2112 }
2114 return(array_unique($ret));
2115 }
2118 /*! \brief Convert various data sizes to bytes
2119 *
2120 * Given a certain value in the format n(g|m|k), where n
2121 * is a value and (g|m|k) stands for Gigabyte, Megabyte and Kilobyte
2122 * this function returns the byte value.
2123 *
2124 * \param string 'value' a value in the above specified format
2125 * \return a byte value or the original value if specified string is simply
2126 * a numeric value
2127 *
2128 */
2129 function to_byte($value) {
2130 $value= strtolower(trim($value));
2132 if(!is_numeric(substr($value, -1))) {
2134 switch(substr($value, -1)) {
2135 case 'g':
2136 $mult= 1073741824;
2137 break;
2138 case 'm':
2139 $mult= 1048576;
2140 break;
2141 case 'k':
2142 $mult= 1024;
2143 break;
2144 }
2146 return ($mult * (int)substr($value, 0, -1));
2147 } else {
2148 return $value;
2149 }
2150 }
2153 /*! \brief Check if a value exists in an array (case-insensitive)
2154 *
2155 * This is just as http://php.net/in_array except that the comparison
2156 * is case-insensitive.
2157 *
2158 * \param string 'value' needle
2159 * \param array 'items' haystack
2160 */
2161 function in_array_ics($value, $items)
2162 {
2163 return preg_grep('/^'.preg_quote($value, '/').'$/i', $items);
2164 }
2167 /*! \brief Removes malicious characters from a (POST) string. */
2168 function validate($string)
2169 {
2170 return (strip_tags(str_replace('\0', '', $string)));
2171 }
2174 /*! \brief Evaluate the current GOsa version from the build in revision string */
2175 function get_gosa_version()
2176 {
2177 global $svn_revision, $svn_path;
2179 /* Extract informations */
2180 $revision= preg_replace('/^[^0-9]*([0-9]+)[^0-9]*$/', '\1', $svn_revision);
2182 /* Release or development? */
2183 if (preg_match('%/gosa/trunk/%', $svn_path)){
2184 return (sprintf(_("GOsa development snapshot (Rev %s)"), bold($revision)));
2185 } else {
2186 $release= preg_replace('%^.*/([^/]+)/include/functions.inc.*$%', '\1', $svn_path);
2187 return (sprintf(_("GOsa $release"), $revision));
2188 }
2189 }
2192 /*! \brief Recursively delete a path in the file system
2193 *
2194 * Will delete the given path and all its files recursively.
2195 * Can also follow links if told so.
2196 *
2197 * \param string 'path'
2198 * \param boolean 'followLinks' TRUE to follow links, FALSE (default)
2199 * for not following links
2200 */
2201 function rmdirRecursive($path, $followLinks=false) {
2202 $dir= opendir($path);
2203 while($entry= readdir($dir)) {
2204 if(is_file($path."/".$entry) || ((!$followLinks) && is_link($path."/".$entry))) {
2205 unlink($path."/".$entry);
2206 } elseif (is_dir($path."/".$entry) && $entry!='.' && $entry!='..') {
2207 rmdirRecursive($path."/".$entry);
2208 }
2209 }
2210 closedir($dir);
2211 return rmdir($path);
2212 }
2215 /*! \brief Get directory content information
2216 *
2217 * Returns the content of a directory as an array in an
2218 * ascended sorted manner.
2219 *
2220 * \param string 'path'
2221 * \param boolean weither to sort the content descending.
2222 */
2223 function scan_directory($path,$sort_desc=false)
2224 {
2225 $ret = false;
2227 /* is this a dir ? */
2228 if(is_dir($path)) {
2230 /* is this path a readable one */
2231 if(is_readable($path)){
2233 /* Get contents and write it into an array */
2234 $ret = array();
2236 $dir = opendir($path);
2238 /* Is this a correct result ?*/
2239 if($dir){
2240 while($fp = readdir($dir))
2241 $ret[]= $fp;
2242 }
2243 }
2244 }
2245 /* Sort array ascending , like scandir */
2246 sort($ret);
2248 /* Sort descending if parameter is sort_desc is set */
2249 if($sort_desc) {
2250 $ret = array_reverse($ret);
2251 }
2253 return($ret);
2254 }
2257 /*! \brief Clean the smarty compile dir */
2258 function clean_smarty_compile_dir($directory)
2259 {
2260 global $svn_revision;
2262 if(is_dir($directory) && is_readable($directory)) {
2263 // Set revision filename to REVISION
2264 $revision_file= $directory."/REVISION";
2266 /* Is there a stamp containing the current revision? */
2267 if(!file_exists($revision_file)) {
2268 // create revision file
2269 create_revision($revision_file, $svn_revision);
2270 } else {
2271 # check for "$config->...['CONFIG']/revision" and the
2272 # contents should match the revision number
2273 if(!compare_revision($revision_file, $svn_revision)){
2274 // If revision differs, clean compile directory
2275 foreach(scan_directory($directory) as $file) {
2276 if(($file==".")||($file=="..")) continue;
2277 if( is_file($directory."/".$file) &&
2278 is_writable($directory."/".$file)) {
2279 // delete file
2280 if(!unlink($directory."/".$file)) {
2281 msg_dialog::display(_("Internal error"), sprintf(_("File %s cannot be deleted!"), bold($directory."/".$file)), ERROR_DIALOG);
2282 // This should never be reached
2283 }
2284 } elseif(is_dir($directory."/".$file) &&
2285 is_writable($directory."/".$file)) {
2286 // Just recursively delete it
2287 rmdirRecursive($directory."/".$file);
2288 }
2289 }
2290 // We should now create a fresh revision file
2291 clean_smarty_compile_dir($directory);
2292 } else {
2293 // Revision matches, nothing to do
2294 }
2295 }
2296 } else {
2297 // Smarty compile dir is not accessible
2298 // (Smarty will warn about this)
2299 }
2300 }
2303 function create_revision($revision_file, $revision)
2304 {
2305 $result= false;
2307 if(is_dir(dirname($revision_file)) && is_writable(dirname($revision_file))) {
2308 if($fh= fopen($revision_file, "w")) {
2309 if(fwrite($fh, $revision)) {
2310 $result= true;
2311 }
2312 }
2313 fclose($fh);
2314 } else {
2315 msg_dialog::display(_("Internal error"), _("Cannot write revision file!"), ERROR_DIALOG);
2316 }
2318 return $result;
2319 }
2322 function compare_revision($revision_file, $revision)
2323 {
2324 // false means revision differs
2325 $result= false;
2327 if(file_exists($revision_file) && is_readable($revision_file)) {
2328 // Open file
2329 if($fh= fopen($revision_file, "r")) {
2330 // Compare File contents with current revision
2331 if($revision == fread($fh, filesize($revision_file))) {
2332 $result= true;
2333 }
2334 } else {
2335 msg_dialog::display(_("Internal error"), _("Cannot write revision file!"), ERROR_DIALOG);
2336 }
2337 // Close file
2338 fclose($fh);
2339 }
2341 return $result;
2342 }
2345 /*! \brief Return HTML for a progressbar
2346 *
2347 * \code
2348 * $smarty->assign("installprogress", progressbar($current_progress_in_percent),100,15,true);
2349 * \endcode
2350 *
2351 * \param int 'percentage' Value to display
2352 * \param int 'width' width of the resulting output
2353 * \param int 'height' height of the resulting output
2354 * \param boolean 'showtext' weither to show the percentage in the progressbar or not
2355 * */
2356 function progressbar($percentage, $width= 200, $height= 14, $showText= false, $colorize= true, $id= "")
2357 {
2358 $text= "";
2359 $class= "";
2360 $style= "width:${width}px;height:${height}px;";
2362 // Fix percentage range
2363 $percentage= floor($percentage);
2364 if ($percentage > 100) {
2365 $percentage= 100;
2366 }
2367 if ($percentage < 0) {
2368 $percentage= 0;
2369 }
2371 // Only show text if we're above 10px height
2372 if ($showText && $height>10){
2373 $text= $percentage."%";
2374 }
2376 // Set font size
2377 $style.= "font-size:".($height-3)."px;";
2379 // Set color
2380 if ($colorize){
2381 if ($percentage < 70) {
2382 $class= " progress-low";
2383 } elseif ($percentage < 80) {
2384 $class= " progress-mid";
2385 } elseif ($percentage < 90) {
2386 $class= " progress-high";
2387 } else {
2388 $class= " progress-full";
2389 }
2390 }
2392 // Apply gradients
2393 $hoffset= floor($height / 2) + 4;
2394 $woffset= floor(($width+5) * (100-$percentage) / 100);
2395 foreach (array("-moz-box-shadow", "-webkit-box-shadow", "box-shadow") as $type) {
2396 $style.="$type:
2397 0 0 2px rgba(255, 255, 255, 0.4) inset,
2398 0 4px 6px rgba(255, 255, 255, 0.4) inset,
2399 0 ".$hoffset."px 0 -2px rgba(255, 255, 255, 0.2) inset,
2400 -".$woffset."px 0 0 -2px rgba(255, 255, 255, 0.2) inset,
2401 -".($woffset+1)."px 0 0 -2px rgba(0, 0, 0, 0.6) inset,
2402 0pt ".($hoffset+1)."px 8px rgba(0, 0, 0, 0.3) inset,
2403 0pt 1px 0px rgba(0, 0, 0, 0.2);";
2404 }
2406 // Set ID
2407 if ($id != ""){
2408 $id= "id='$id'";
2409 }
2411 return "<div class='progress$class' $id style='$style'>$text</div>";
2412 }
2415 /*! \brief Lookup a key in an array case-insensitive
2416 *
2417 * Given an associative array this can lookup the value of
2418 * a certain key, regardless of the case.
2419 *
2420 * \code
2421 * $items = array ('FOO' => 'blub', 'bar' => 'blub');
2422 * array_key_ics('foo', $items); # Returns 'blub'
2423 * array_key_ics('BAR', $items); # Returns 'blub'
2424 * \endcode
2425 *
2426 * \param string 'key' needle
2427 * \param array 'items' haystack
2428 */
2429 function array_key_ics($ikey, $items)
2430 {
2431 $tmp= array_change_key_case($items, CASE_LOWER);
2432 $ikey= strtolower($ikey);
2433 if (isset($tmp[$ikey])){
2434 return($tmp[$ikey]);
2435 }
2437 return ('');
2438 }
2441 /*! \brief Determine if two arrays are different
2442 *
2443 * \param array 'src'
2444 * \param array 'dst'
2445 * \return boolean TRUE or FALSE
2446 * */
2447 function array_differs($src, $dst)
2448 {
2449 /* If the count is differing, the arrays differ */
2450 if (count ($src) != count ($dst)){
2451 return (TRUE);
2452 }
2454 return (count(array_diff($src, $dst)) != 0);
2455 }
2458 function saveFilter($a_filter, $values)
2459 {
2460 if (isset($_POST['regexit'])){
2461 $a_filter["regex"]= $_POST['regexit'];
2463 foreach($values as $type){
2464 if (isset($_POST[$type])) {
2465 $a_filter[$type]= "checked";
2466 } else {
2467 $a_filter[$type]= "";
2468 }
2469 }
2470 }
2472 /* React on alphabet links if needed */
2473 if (isset($_GET['search'])){
2474 $s= mb_substr(validate($_GET['search']), 0, 1, "UTF8")."*";
2475 if ($s == "**"){
2476 $s= "*";
2477 }
2478 $a_filter['regex']= $s;
2479 }
2481 return ($a_filter);
2482 }
2485 /*! \brief Escape all LDAP filter relevant characters */
2486 function normalizeLdap($input)
2487 {
2488 return (addcslashes($input, '()|'));
2489 }
2492 /*! \brief Return the gosa base directory */
2493 function get_base_dir()
2494 {
2495 global $BASE_DIR;
2497 return $BASE_DIR;
2498 }
2501 /*! \brief Test weither we are allowed to read the object */
2502 function obj_is_readable($dn, $object, $attribute)
2503 {
2504 global $ui;
2506 return preg_match('/r/', $ui->get_permissions($dn, $object, $attribute));
2507 }
2510 /*! \brief Test weither we are allowed to change the object */
2511 function obj_is_writable($dn, $object, $attribute)
2512 {
2513 global $ui;
2515 return preg_match('/w/', $ui->get_permissions($dn, $object, $attribute));
2516 }
2519 /*! \brief Explode a DN into its parts
2520 *
2521 * Similar to explode (http://php.net/explode), but a bit more specific
2522 * for the needs when splitting, exploding LDAP DNs.
2523 *
2524 * \param string 'dn' the DN to split
2525 * \param config-object a config object. only neeeded if DN shall be verified in the LDAP
2526 * \param boolean verify_in_ldap check weither DN is valid
2527 *
2528 */
2529 function gosa_ldap_explode_dn($dn,$config = NULL,$verify_in_ldap=false)
2530 {
2531 /* Initialize variables */
2532 $ret = array("count" => 0); // Set count to 0
2533 $next = true; // if false, then skip next loops and return
2534 $cnt = 0; // Current number of loops
2535 $max = 100; // Just for security, prevent looops
2536 $ldap = NULL; // To check if created result a valid
2537 $keep = ""; // save last failed parse string
2539 /* Check each parsed dn in ldap ? */
2540 if($config!==NULL && $verify_in_ldap){
2541 $ldap = $config->get_ldap_link();
2542 }
2544 /* Lets start */
2545 $called = false;
2546 while(preg_match("/,/",$dn) && $next && $cnt < $max){
2548 $cnt ++;
2549 if(!preg_match("/,/",$dn)){
2550 $next = false;
2551 }
2552 $object = preg_replace("/[,].*$/","",$dn);
2553 $dn = preg_replace("/^[^,]+,/","",$dn);
2555 $called = true;
2557 /* Check if current dn is valid */
2558 if($ldap!==NULL){
2559 $ldap->cd($dn);
2560 $ldap->cat($dn,array("dn"));
2561 if($ldap->count()){
2562 $ret[] = $keep.$object;
2563 $keep = "";
2564 }else{
2565 $keep .= $object.",";
2566 }
2567 }else{
2568 $ret[] = $keep.$object;
2569 $keep = "";
2570 }
2571 }
2573 /* No dn was posted */
2574 if($cnt == 0 && !empty($dn)){
2575 $ret[] = $dn;
2576 }
2578 /* Append the rest */
2579 $test = $keep.$dn;
2580 if($called && !empty($test)){
2581 $ret[] = $keep.$dn;
2582 }
2583 $ret['count'] = count($ret) - 1;
2585 return($ret);
2586 }
2589 function get_base_from_hook($dn, $attrib)
2590 {
2591 global $config;
2593 if ($config->get_cfg_value("core","baseIdHook") != ""){
2595 /* Call hook script - if present */
2596 $command= $config->get_cfg_value("core","baseIdHook");
2598 if ($command != ""){
2599 $command.= " '".LDAP::fix($dn)."' $attrib";
2600 if (check_command($command)){
2601 @DEBUG (DEBUG_SHELL, __LINE__, __FUNCTION__, __FILE__, $command, "Execute");
2602 exec($command, $output);
2603 if (preg_match("/^[0-9]+$/", $output[0])){
2604 return ($output[0]);
2605 } else {
2606 msg_dialog::display(_("Warning"), _("'baseIdHook' is not available. Using default base!"), WARNING_DIALOG);
2607 return ($config->get_cfg_value("core","uidNumberBase"));
2608 }
2609 } else {
2610 msg_dialog::display(_("Warning"), _("'baseIdHook' is not available. Using default base!"), WARNING_DIALOG);
2611 return ($config->get_cfg_value("core","uidNumberBase"));
2612 }
2614 } else {
2616 msg_dialog::display(_("Warning"), _("'baseIdHook' is not available. Using default base!"), WARNING_DIALOG);
2617 return ($config->get_cfg_value("core","uidNumberBase"));
2619 }
2620 }
2621 }
2624 /*! \brief Check if schema version matches the requirements */
2625 function check_schema_version($class, $version)
2626 {
2627 return preg_match("/\(v$version\)/", $class['DESC']);
2628 }
2631 /*! \brief Check if LDAP schema matches the requirements */
2632 function check_schema($cfg,$rfc2307bis = FALSE)
2633 {
2634 $messages= array();
2636 /* Get objectclasses */
2637 $ldap = new ldapMultiplexer(new LDAP($cfg['admin'],$cfg['password'],$cfg['connection'] ,FALSE, $cfg['tls']));
2638 $objectclasses = $ldap->get_objectclasses();
2639 if(count($objectclasses) == 0){
2640 msg_dialog::display(_("Warning"), _("Cannot read schema information from LDAP. Schema validation is not possible!"), WARNING_DIALOG);
2641 }
2643 /* This is the default block used for each entry.
2644 * to avoid unset indexes.
2645 */
2646 $def_check = array("REQUIRED_VERSION" => "0",
2647 "SCHEMA_FILES" => array(),
2648 "CLASSES_REQUIRED" => array(),
2649 "STATUS" => FALSE,
2650 "IS_MUST_HAVE" => FALSE,
2651 "MSG" => "",
2652 "INFO" => "");
2654 /* The gosa base schema */
2655 $checks['gosaObject'] = $def_check;
2656 $checks['gosaObject']['REQUIRED_VERSION'] = "2.6.1";
2657 $checks['gosaObject']['SCHEMA_FILES'] = array("gosa-samba3.schema");
2658 $checks['gosaObject']['CLASSES_REQUIRED'] = array("gosaObject");
2659 $checks['gosaObject']['IS_MUST_HAVE'] = TRUE;
2661 /* GOsa Account class */
2662 $checks["gosaAccount"]["REQUIRED_VERSION"]= "2.6.6";
2663 $checks["gosaAccount"]["SCHEMA_FILES"] = array("gosa-samba3.schema");
2664 $checks["gosaAccount"]["CLASSES_REQUIRED"]= array("gosaAccount");
2665 $checks["gosaAccount"]["IS_MUST_HAVE"] = TRUE;
2666 $checks["gosaAccount"]["INFO"] = _("This class is used to make users appear in GOsa.");
2668 /* GOsa lock entry, used to mark currently edited objects as 'in use' */
2669 $checks["gosaLockEntry"]["REQUIRED_VERSION"] = "2.6.1";
2670 $checks["gosaLockEntry"]["SCHEMA_FILES"] = array("gosa-samba3.schema");
2671 $checks["gosaLockEntry"]["CLASSES_REQUIRED"] = array("gosaLockEntry");
2672 $checks["gosaLockEntry"]["IS_MUST_HAVE"] = TRUE;
2673 $checks["gosaLockEntry"]["INFO"] = _("This class is used to lock entries in order to prevent multiple edits at a time.");
2675 /* Some other checks */
2676 foreach(array(
2677 "gosaCacheEntry" => array("version" => "2.6.1", "class" => "gosaAccount"),
2678 "gosaDepartment" => array("version" => "2.6.1", "class" => "gosaAccount"),
2679 "goFaxAccount" => array("version" => "1.0.4", "class" => "gofaxAccount","file" => "gofax.schema"),
2680 "goFaxSBlock" => array("version" => "1.0.4", "class" => "gofaxAccount","file" => "gofax.schema"),
2681 "goFaxRBlock" => array("version" => "1.0.4", "class" => "gofaxAccount","file" => "gofax.schema"),
2682 "gosaUserTemplate" => array("version" => "2.6.1", "class" => "posixAccount","file" => "nis.schema"),
2683 "gosaMailAccount" => array("version" => "2.6.1", "class" => "mailAccount","file" => "gosa-samba3.schema"),
2684 "gosaProxyAccount" => array("version" => "2.6.1", "class" => "proxyAccount","file" => "gosa-samba3.schema"),
2685 "gosaApplication" => array("version" => "2.6.1", "class" => "appgroup","file" => "gosa.schema"),
2686 "gosaApplicationGroup" => array("version" => "2.6.1", "class" => "appgroup","file" => "gosa.schema"),
2687 "GOhard" => array("version" => "2.6.1", "class" => "terminals","file" => "goto.schema"),
2688 "gotoTerminal" => array("version" => "2.6.1", "class" => "terminals","file" => "goto.schema"),
2689 "goServer" => array("version" => "2.6.1", "class" => "server","file" => "goserver.schema"),
2690 "goTerminalServer" => array("version" => "2.6.1", "class" => "terminals","file" => "goto.schema"),
2691 "goShareServer" => array("version" => "2.6.1", "class" => "terminals","file" => "goto.schema"),
2692 "goNtpServer" => array("version" => "2.6.1", "class" => "terminals","file" => "goto.schema"),
2693 "goSyslogServer" => array("version" => "2.6.1", "class" => "terminals","file" => "goto.schema"),
2694 "goLdapServer" => array("version" => "2.6.1", "class" => "goServer"),
2695 "goCupsServer" => array("version" => "2.6.1", "class" => array("posixAccount", "terminals"),),
2696 "goImapServer" => array("version" => "2.6.1", "class" => array("mailAccount", "mailgroup"),"file" => "gosa-samba3.schema"),
2697 "goKrbServer" => array("version" => "2.6.1", "class" => "goServer"),
2698 "goFaxServer" => array("version" => "2.6.1", "class" => "gofaxAccount","file" => "gofax.schema"),
2699 ) as $name => $values){
2701 $checks[$name] = $def_check;
2702 if(isset($values['version'])){
2703 $checks[$name]["REQUIRED_VERSION"] = $values['version'];
2704 }
2705 if(isset($values['file'])){
2706 $checks[$name]["SCHEMA_FILES"] = array($values['file']);
2707 }
2708 if (isset($values['class'])) {
2709 $checks[$name]["CLASSES_REQUIRED"] = is_array($values['class'])?$values['class']:array($values['class']);
2710 }
2711 }
2712 foreach($checks as $name => $value){
2713 foreach($value['CLASSES_REQUIRED'] as $class){
2715 if(!isset($objectclasses[$name])){
2716 if($value['IS_MUST_HAVE']){
2717 $checks[$name]['STATUS'] = FALSE;
2718 $checks[$name]['MSG'] = sprintf(_("Required object class %s is missing!"), bold($class));
2719 } else {
2720 $checks[$name]['STATUS'] = TRUE;
2721 $checks[$name]['MSG'] = sprintf(_("Optional object class %s is missing!"), bold($class));
2722 }
2723 }elseif(!check_schema_version($objectclasses[$name],$value['REQUIRED_VERSION'])){
2724 $checks[$name]['STATUS'] = FALSE;
2726 $checks[$name]['MSG'] = sprintf(_("Wrong version of required object class %s (!=%s) detected!"), bold($class), bold($value['REQUIRED_VERSION']));
2727 }else{
2728 $checks[$name]['STATUS'] = TRUE;
2729 $checks[$name]['MSG'] = sprintf(_("Class available"));
2730 }
2731 }
2732 }
2734 $tmp = $objectclasses;
2736 /* The gosa base schema */
2737 $checks['posixGroup'] = $def_check;
2738 $checks['posixGroup']['REQUIRED_VERSION'] = "2.6.1";
2739 $checks['posixGroup']['SCHEMA_FILES'] = array("gosa-samba3.schema","gosa-samba2.schema");
2740 $checks['posixGroup']['CLASSES_REQUIRED'] = array("posixGroup");
2741 $checks['posixGroup']['STATUS'] = TRUE;
2742 $checks['posixGroup']['IS_MUST_HAVE'] = TRUE;
2743 $checks['posixGroup']['MSG'] = "";
2744 $checks['posixGroup']['INFO'] = "";
2746 /* Depending on selected rfc2307bis mode, we need different schema configurations */
2747 if(isset($tmp['posixGroup'])){
2749 if($rfc2307bis && isset($tmp['posixGroup']['STRUCTURAL'])){
2750 $checks['posixGroup']['STATUS'] = FALSE;
2751 $checks['posixGroup']['MSG'] = _("RFC 2307bis group schema is enabled, but the current LDAP configuration does not support it!");
2752 $checks['posixGroup']['INFO'] = _("To use RFC 2307bis groups, the objectClass 'posixGroup' must be AUXILIARY.");
2753 }
2754 if(!$rfc2307bis && !isset($tmp['posixGroup']['STRUCTURAL'])){
2755 $checks['posixGroup']['STATUS'] = FALSE;
2756 $checks['posixGroup']['MSG'] = _("RFC 2307bis group schema is disabled, but the current LDAP configuration supports it!");
2757 $checks['posixGroup']['INFO'] = _("To correct this, the objectClass 'posixGroup' must be STRUCTURAL.");
2758 }
2759 }
2761 return($checks);
2762 }
2765 function get_languages($languages_in_own_language = FALSE,$strip_region_tag = FALSE)
2766 {
2767 $tmp = array(
2768 "de_DE" => "German",
2769 "fr_FR" => "French",
2770 "it_IT" => "Italian",
2771 "es_ES" => "Spanish",
2772 "en_US" => "English",
2773 "nl_NL" => "Dutch",
2774 "pl_PL" => "Polish",
2775 "pt_BR" => "Brazilian Portuguese",
2776 #"sv_SE" => "Swedish",
2777 "zh_CN" => "Chinese",
2778 "vi_VN" => "Vietnamese",
2779 "ru_RU" => "Russian");
2781 $tmp2= array(
2782 "de_DE" => _("German"),
2783 "fr_FR" => _("French"),
2784 "it_IT" => _("Italian"),
2785 "es_ES" => _("Spanish"),
2786 "en_US" => _("English"),
2787 "nl_NL" => _("Dutch"),
2788 "pl_PL" => _("Polish"),
2789 "pt_BR" => _("Brazilian Portuguese"),
2790 #"sv_SE" => _("Swedish"),
2791 "zh_CN" => _("Chinese"),
2792 "vi_VN" => _("Vietnamese"),
2793 "ru_RU" => _("Russian"));
2795 $ret = array();
2796 if($languages_in_own_language){
2798 $old_lang = setlocale(LC_ALL, 0);
2800 /* If the locale wasn't correclty set before, there may be an incorrect
2801 locale returned. Something like this:
2802 C_CTYPE=de_DE.UTF-8;LC_NUMERIC=C;LC_TIME=de_DE.UTF-8;LC ...
2803 Extract the locale name from this string and use it to restore old locale.
2804 */
2805 if(preg_match("/LC_CTYPE/",$old_lang)){
2806 $old_lang = preg_replace("/^.*LC_CTYPE=([^;]*).*$/","\\1",$old_lang);
2807 }
2809 foreach($tmp as $key => $name){
2810 $lang = $key.".UTF-8";
2811 setlocale(LC_ALL, $lang);
2812 if($strip_region_tag){
2813 $ret[preg_replace("/^([^_]*).*$/","\\1",$key)] = _($name)." (".$tmp2[$key].")";
2814 }else{
2815 $ret[$key] = _($name)." (".$tmp2[$key].")";
2816 }
2817 }
2818 setlocale(LC_ALL, $old_lang);
2819 }else{
2820 foreach($tmp as $key => $name){
2821 if($strip_region_tag){
2822 $ret[preg_replace("/^([^_]*).*/","\\1",$key)] = _($name);
2823 }else{
2824 $ret[$key] = _($name);
2825 }
2826 }
2827 }
2828 return($ret);
2829 }
2832 /*! \brief Returns contents of the given POST variable and check magic quotes settings
2833 *
2834 * Depending on the magic quotes settings this returns a stripclashed'ed version of
2835 * a certain POST variable.
2836 *
2837 * \param string 'name' the POST var to return ($_POST[$name])
2838 * \return string
2839 * */
2840 function get_post($name)
2841 {
2842 if(!isset($_POST[$name])){
2843 trigger_error("Requested POST value (".$name.") does not exists, you should add a check to prevent this message.");
2844 return(FALSE);
2845 }
2847 if(get_magic_quotes_gpc()){
2848 return(stripcslashes(validate($_POST[$name])));
2849 }else{
2850 return(validate($_POST[$name]));
2851 }
2852 }
2855 /*! \brief Return class name in correct case */
2856 function get_correct_class_name($cls)
2857 {
2858 global $class_mapping;
2859 if(isset($class_mapping) && is_array($class_mapping)){
2860 foreach($class_mapping as $class => $file){
2861 if(preg_match("/^".$cls."$/i",$class)){
2862 return($class);
2863 }
2864 }
2865 }
2866 return(FALSE);
2867 }
2870 /*! \brief Change the password of a given DN
2871 *
2872 * Change the password of a given DN with the specified hash.
2873 *
2874 * \param string 'dn' the DN whose password shall be changed
2875 * \param string 'password' the password
2876 * \param int mode
2877 * \param string 'hash' which hash to use to encrypt it, default is empty
2878 * for cleartext storage.
2879 * \return boolean TRUE on success FALSE on error
2880 */
2881 function change_password ($dn, $password, $mode=0, $hash= "")
2882 {
2883 global $config;
2884 $newpass= "";
2886 /* Convert to lower. Methods are lowercase */
2887 $hash= strtolower($hash);
2889 // Get all available encryption Methods
2891 // NON STATIC CALL :)
2892 $methods = new passwordMethod(session::get('config'),$dn);
2893 $available = $methods->get_available_methods();
2895 // read current password entry for $dn, to detect the encryption Method
2896 $ldap = $config->get_ldap_link();
2897 $ldap->cat ($dn, array("shadowLastChange", "userPassword", "uid"));
2898 $attrs = $ldap->fetch ();
2900 /* Is ensure that clear passwords will stay clear */
2901 if($hash == "" && isset($attrs['userPassword'][0]) && !preg_match ("/^{([^}]+)}(.+)/", $attrs['userPassword'][0])){
2902 $hash = "clear";
2903 }
2905 // Detect the encryption Method
2906 if ( (isset($attrs['userPassword'][0]) && preg_match ("/^{([^}]+)}(.+)/", $attrs['userPassword'][0], $matches)) || $hash != ""){
2908 /* Check for supported algorithm */
2909 mt_srand((double) microtime()*1000000);
2911 /* Extract used hash */
2912 if ($hash == ""){
2913 $test = passwordMethod::get_method($attrs['userPassword'][0],$dn);
2914 } else {
2915 $test = new $available[$hash]($config,$dn);
2916 $test->set_hash($hash);
2917 }
2919 } else {
2920 // User MD5 by default
2921 $hash= "md5";
2922 $test = new $available['md5']($config, $dn);
2923 }
2925 if($test instanceOf passwordMethod){
2927 $deactivated = $test->is_locked($config,$dn);
2929 /* Feed password backends with information */
2930 $test->dn= $dn;
2931 $test->attrs= $attrs;
2932 $newpass= $test->generate_hash($password);
2934 // Update shadow timestamp?
2935 if (isset($attrs["shadowLastChange"][0])){
2936 $shadow= (int)(date("U") / 86400);
2937 } else {
2938 $shadow= 0;
2939 }
2941 // Write back modified entry
2942 $ldap->cd($dn);
2943 $attrs= array();
2945 // Not for groups
2946 if ($mode == 0){
2947 // Create SMB Password
2948 $attrs= generate_smb_nt_hash($password);
2950 if ($shadow != 0){
2951 $attrs['shadowLastChange']= $shadow;
2952 }
2953 }
2955 $attrs['userPassword']= array();
2956 $attrs['userPassword']= $newpass;
2958 $ldap->modify($attrs);
2960 /* Read ! if user was deactivated */
2961 if($deactivated){
2962 $test->lock_account($config,$dn);
2963 }
2965 new log("modify","users/passwordMethod",$dn,array_keys($attrs),$ldap->get_error());
2967 if (!$ldap->success()) {
2968 msg_dialog::display(_("LDAP error"), msgPool::ldaperror($ldap->get_error(), $dn, LDAP_MOD, ERROR_DIALOG));
2969 } else {
2971 /* Run backend method for change/create */
2972 if(!$test->set_password($password)){
2973 return(FALSE);
2974 }
2976 /* Find postmodify entries for this class */
2977 $command= $config->get_cfg_value("password","postmodify");
2979 if ($command != ""){
2980 /* Walk through attribute list */
2981 $command= preg_replace("/%userPassword/", $password, $command);
2982 $command= preg_replace("/%dn/", $dn, $command);
2984 if (check_command($command)){
2985 @DEBUG (DEBUG_SHELL, __LINE__, __FUNCTION__, __FILE__, $command, "Execute");
2986 exec($command);
2987 } else {
2988 $message= sprintf(_("Command %s specified as post modify action for plugin %s does not exist!"), bold($command), bold("password"));
2989 msg_dialog::display(_("Configuration error"), $message, ERROR_DIALOG);
2990 }
2991 }
2992 }
2993 return(TRUE);
2994 }
2995 }
2998 /*! \brief Generate samba hashes
2999 *
3000 * Given a certain password this constructs an array like
3001 * array['sambaLMPassword'] etc.
3002 *
3003 * \param string 'password'
3004 * \return array contains several keys for lmPassword, ntPassword, pwdLastSet, etc. depending
3005 * on the samba version
3006 */
3007 function generate_smb_nt_hash($password)
3008 {
3009 global $config;
3011 # Try to use gosa-si?
3012 if ($config->get_cfg_value("core","gosaSupportURI") != ""){
3013 $res= gosaSupportDaemon::send("gosa_gen_smb_hash", "GOSA", array("password" => $password), TRUE);
3014 if (isset($res['XML']['HASH'])){
3015 $hash= $res['XML']['HASH'];
3016 } else {
3017 $hash= "";
3018 }
3020 if ($hash == "") {
3021 msg_dialog::display(_("Configuration error"), _("Cannot generate SAMBA hash!"), ERROR_DIALOG);
3022 return ("");
3023 }
3024 } else {
3025 $tmp= $config->get_cfg_value("core",'sambaHashHook')." ".escapeshellarg($password);
3026 @DEBUG (DEBUG_LDAP, __LINE__, __FUNCTION__, __FILE__, $tmp, "Execute");
3028 exec($tmp, $ar);
3029 flush();
3030 reset($ar);
3031 $hash= current($ar);
3033 if ($hash == "") {
3034 msg_dialog::display(_("Configuration error"), sprintf(_("Generating SAMBA hash by running %s failed: check %s!"), bold($config->get_cfg_value("core",'sambaHashHook'), bold("sambaHashHook"))), ERROR_DIALOG);
3035 return ("");
3036 }
3037 }
3039 list($lm,$nt)= explode(":", trim($hash));
3041 $attrs['sambaLMPassword']= $lm;
3042 $attrs['sambaNTPassword']= $nt;
3043 $attrs['sambaPwdLastSet']= date('U');
3044 $attrs['sambaBadPasswordCount']= "0";
3045 $attrs['sambaBadPasswordTime']= "0";
3046 return($attrs);
3047 }
3050 /*! \brief Get the Change Sequence Number of a certain DN
3051 *
3052 * To verify if a given object has been changed outside of Gosa
3053 * in the meanwhile, this function can be used to get the entryCSN
3054 * from the LDAP directory. It uses the attribute as configured
3055 * in modificationDetectionAttribute
3056 *
3057 * \param string 'dn'
3058 * \return either the result or "" in any other case
3059 */
3060 function getEntryCSN($dn)
3061 {
3062 global $config;
3063 if(empty($dn) || !is_object($config)){
3064 return("");
3065 }
3067 /* Get attribute that we should use as serial number */
3068 $attr= $config->get_cfg_value("core","modificationDetectionAttribute");
3069 if($attr != ""){
3070 $ldap = $config->get_ldap_link();
3071 $ldap->cat($dn,array($attr));
3072 $csn = $ldap->fetch();
3073 if(isset($csn[$attr][0])){
3074 return($csn[$attr][0]);
3075 }
3076 }
3077 return("");
3078 }
3081 /*! \brief Add (a) given objectClass(es) to an attrs entry
3082 *
3083 * The function adds the specified objectClass(es) to the given
3084 * attrs entry.
3085 *
3086 * \param mixed 'classes' Either a single objectClass or several objectClasses
3087 * as an array
3088 * \param array 'attrs' The attrs array to be modified.
3089 *
3090 * */
3091 function add_objectClass($classes, &$attrs)
3092 {
3093 if (is_array($classes)){
3094 $list= $classes;
3095 } else {
3096 $list= array($classes);
3097 }
3099 foreach ($list as $class){
3100 $attrs['objectClass'][]= $class;
3101 }
3102 }
3105 /*! \brief Removes a given objectClass from the attrs entry
3106 *
3107 * Similar to add_objectClass, except that it removes the given
3108 * objectClasses. See it for the params.
3109 * */
3110 function remove_objectClass($classes, &$attrs)
3111 {
3112 if (isset($attrs['objectClass'])){
3113 /* Array? */
3114 if (is_array($classes)){
3115 $list= $classes;
3116 } else {
3117 $list= array($classes);
3118 }
3120 $tmp= array();
3121 foreach ($attrs['objectClass'] as $oc) {
3122 foreach ($list as $class){
3123 if (strtolower($oc) != strtolower($class)){
3124 $tmp[]= $oc;
3125 }
3126 }
3127 }
3128 $attrs['objectClass']= $tmp;
3129 }
3130 }
3133 /*! \brief Initialize a file download with given content, name and data type.
3134 * \param string data The content to send.
3135 * \param string name The name of the file.
3136 * \param string type The content identifier, default value is "application/octet-stream";
3137 */
3138 function send_binary_content($data,$name,$type = "application/octet-stream")
3139 {
3140 header("Expires: Mon, 26 Jul 1997 05:00:00 GMT");
3141 header("Last-Modified: ".gmdate("D, d M Y H:i:s")." GMT");
3142 header("Cache-Control: no-cache");
3143 header("Pragma: no-cache");
3144 header("Cache-Control: post-check=0, pre-check=0");
3145 header("Content-type: ".$type."");
3147 $HTTP_USER_AGENT = $_SERVER['HTTP_USER_AGENT'];
3149 /* Strip name if it is a complete path */
3150 if (preg_match ("/\//", $name)) {
3151 $name= basename($name);
3152 }
3154 /* force download dialog */
3155 if (preg_match('/MSIE 5.5/', $HTTP_USER_AGENT) || preg_match('/MSIE 6.0/', $HTTP_USER_AGENT)) {
3156 header('Content-Disposition: filename="'.$name.'"');
3157 } else {
3158 header('Content-Disposition: attachment; filename="'.$name.'"');
3159 }
3161 echo $data;
3162 exit();
3163 }
3166 function reverse_html_entities($str,$type = ENT_QUOTES , $charset = "UTF-8")
3167 {
3168 if(is_string($str)){
3169 return(htmlentities($str,$type,$charset));
3170 }elseif(is_array($str)){
3171 foreach($str as $name => $value){
3172 $str[$name] = reverse_html_entities($value,$type,$charset);
3173 }
3174 }
3175 return($str);
3176 }
3179 /*! \brief Encode special string characters so we can use the string in \
3180 HTML output, without breaking quotes.
3181 \param string The String we want to encode.
3182 \return string The encoded String
3183 */
3184 function xmlentities($str)
3185 {
3186 if(is_string($str)){
3188 static $asc2uni= array();
3189 if (!count($asc2uni)){
3190 for($i=128;$i<256;$i++){
3191 # $asc2uni[chr($i)] = "&#x".dechex($i).";";
3192 }
3193 }
3195 $str = str_replace("&", "&", $str);
3196 $str = str_replace("<", "<", $str);
3197 $str = str_replace(">", ">", $str);
3198 $str = str_replace("'", "'", $str);
3199 $str = str_replace("\"", """, $str);
3200 $str = str_replace("\r", "", $str);
3201 $str = strtr($str,$asc2uni);
3202 return $str;
3203 }elseif(is_array($str)){
3204 foreach($str as $name => $value){
3205 $str[$name] = xmlentities($value);
3206 }
3207 }
3208 return($str);
3209 }
3212 /*! \brief Updates all accessTo attributes from a given value to a new one.
3213 For example if a host is renamed.
3214 \param String $from The source accessTo name.
3215 \param String $to The destination accessTo name.
3216 */
3217 function update_accessTo($from,$to)
3218 {
3219 global $config;
3220 $ldap = $config->get_ldap_link();
3221 $ldap->cd($config->current['BASE']);
3222 $ldap->search("(&(objectClass=trustAccount)(accessTo=".$from."))",array("objectClass","accessTo"));
3223 while($attrs = $ldap->fetch()){
3224 $new_attrs = array("accessTo" => array());
3225 $dn = $attrs['dn'];
3226 for($i = 0 ; $i < $attrs['objectClass']['count']; $i++){
3227 $new_attrs['objectClass'][] = $attrs['objectClass'][$i];
3228 }
3229 for($i = 0 ; $i < $attrs['accessTo']['count']; $i++){
3230 if($attrs['accessTo'][$i] == $from){
3231 if(!empty($to)){
3232 $new_attrs['accessTo'][] = $to;
3233 }
3234 }else{
3235 $new_attrs['accessTo'][] = $attrs['accessTo'][$i];
3236 }
3237 }
3238 $ldap->cd($dn);
3239 $ldap->modify($new_attrs);
3240 if (!$ldap->success()){
3241 msg_dialog::display(_("LDAP error"), msgPool::ldaperror($ldap->get_error(), $dn, LDAP_MOD, "update_accessTo($from,$to)"));
3242 }
3243 new log("modify","update_accessTo($from,$to)",$dn,array_keys($new_attrs),$ldap->get_error());
3244 }
3245 }
3248 /*! \brief Returns a random char */
3249 function get_random_char () {
3250 $randno = rand (0, 63);
3251 if ($randno < 12) {
3252 return (chr ($randno + 46)); // Digits, '/' and '.'
3253 } else if ($randno < 38) {
3254 return (chr ($randno + 53)); // Uppercase
3255 } else {
3256 return (chr ($randno + 59)); // Lowercase
3257 }
3258 }
3261 function cred_encrypt($input, $password) {
3263 $size = mcrypt_get_iv_size(MCRYPT_RIJNDAEL_128, MCRYPT_MODE_CBC);
3264 $iv = mcrypt_create_iv($size, MCRYPT_DEV_RANDOM);
3266 return bin2hex(mcrypt_encrypt(MCRYPT_RIJNDAEL_128, $password, $input, MCRYPT_MODE_ECB, $iv));
3268 }
3271 function cred_decrypt($input,$password) {
3272 $size = mcrypt_get_iv_size(MCRYPT_RIJNDAEL_128, MCRYPT_MODE_CBC);
3273 $iv = mcrypt_create_iv($size, MCRYPT_DEV_RANDOM);
3275 return mcrypt_decrypt(MCRYPT_RIJNDAEL_128, $password, pack("H*", $input), MCRYPT_MODE_ECB, $iv);
3276 }
3279 function get_object_info()
3280 {
3281 return(session::get('objectinfo'));
3282 }
3285 function set_object_info($str = "")
3286 {
3287 session::set('objectinfo',$str);
3288 }
3291 function isIpInNet($ip, $net, $mask) {
3292 // Move to long ints
3293 $ip= ip2long($ip);
3294 $net= ip2long($net);
3295 $mask= ip2long($mask);
3297 // Mask given IP with mask. If it returns "net", we're in...
3298 $res= $ip & $mask;
3300 return ($res == $net);
3301 }
3304 function get_next_id($attrib, $dn)
3305 {
3306 global $config;
3308 switch ($config->get_cfg_value("core","idAllocationMethod", "traditional")){
3309 case "pool":
3310 return get_next_id_pool($attrib);
3311 case "traditional":
3312 return get_next_id_traditional($attrib, $dn);
3313 }
3315 msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." "._("unknown idAllocation method!"), ERROR_DIALOG);
3316 return null;
3317 }
3320 function get_next_id_pool($attrib) {
3321 global $config;
3323 /* Fill informational values */
3324 $min= $config->get_cfg_value("core","${attrib}PoolMin", 10000);
3325 $max= $config->get_cfg_value("core","${attrib}PoolMax", 40000);
3327 /* Sanity check */
3328 if ($min >= $max) {
3329 msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." ".sprintf(_("%sPoolMin >= %sPoolMax!"), bold($attrib), bold($attrib)), ERROR_DIALOG);
3330 return null;
3331 }
3333 /* ID to skip */
3334 $ldap= $config->get_ldap_link();
3335 $id= null;
3337 /* Try to allocate the ID several times before failing */
3338 $tries= 3;
3339 while ($tries--) {
3341 /* Look for ID map entry */
3342 $ldap->cd ($config->current['BASE']);
3343 $ldap->search ("(&(objectClass=sambaUnixIdPool)($attrib=*))", array("$attrib"));
3345 /* If it does not exist, create one with these defaults */
3346 if ($ldap->count() == 0) {
3347 /* Fill informational values */
3348 $minUserId= $config->get_cfg_value("core","uidPoolMin", 10000);
3349 $minGroupId= $config->get_cfg_value("core","gidPoolMin", 10000);
3351 /* Add as default */
3352 $attrs= array("objectClass" => array("organizationalUnit", "sambaUnixIdPool"));
3353 $attrs["ou"]= "idmap";
3354 $attrs["uidNumber"]= $minUserId;
3355 $attrs["gidNumber"]= $minGroupId;
3356 $ldap->cd("ou=idmap,".$config->current['BASE']);
3357 $ldap->add($attrs);
3358 if ($ldap->error != "Success") {
3359 msg_dialog::display(_("Error"), _("Cannot create sambaUnixIdPool entry!"), ERROR_DIALOG);
3360 return null;
3361 }
3362 $tries++;
3363 continue;
3364 }
3365 /* Bail out if it's not unique */
3366 if ($ldap->count() != 1) {
3367 msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." "._("sambaUnixIdPool is not unique!"), ERROR_DIALOG);
3368 return null;
3369 }
3371 /* Store old attrib and generate new */
3372 $attrs= $ldap->fetch();
3373 $dn= $ldap->getDN();
3374 $oldAttr= $attrs[$attrib][0];
3375 $newAttr= $oldAttr + 1;
3377 /* Sanity check */
3378 if ($newAttr >= $max) {
3379 msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." "._("no ID available!"), ERROR_DIALOG);
3380 return null;
3381 }
3382 if ($newAttr < $min) {
3383 msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." "._("no ID available!"), ERROR_DIALOG);
3384 return null;
3385 }
3387 #FIXME: PHP is not able to do a modification of "del: .../add: ...", so this
3388 # is completely unsafe in the moment.
3389 #/* Remove old attr, add new attr */
3390 #$attrs= array($attrib => $oldAttr);
3391 #$ldap->rm($attrs, $dn);
3392 #if ($ldap->error != "Success") {
3393 # continue;
3394 #}
3395 $ldap->cd($dn);
3396 $ldap->modify(array($attrib => $newAttr));
3397 if ($ldap->error != "Success") {
3398 msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." ".$ldap->get_error(), ERROR_DIALOG);
3399 return null;
3400 } else {
3401 return $oldAttr;
3402 }
3403 }
3405 /* Bail out if we had problems getting the next id */
3406 if (!$tries) {
3407 msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." "._("maximum number of tries exceeded!"), ERROR_DIALOG);
3408 }
3410 return $id;
3411 }
3414 function get_next_id_traditional($attrib, $dn)
3415 {
3416 global $config;
3418 $ids= array();
3419 $ldap= $config->get_ldap_link();
3421 $ldap->cd ($config->current['BASE']);
3422 if (preg_match('/gidNumber/i', $attrib)){
3423 $oc= "posixGroup";
3424 } else {
3425 $oc= "posixAccount";
3426 }
3427 $ldap->search ("(&(objectClass=$oc)($attrib=*))", array("$attrib"));
3429 /* Get list of ids */
3430 while ($attrs= $ldap->fetch()){
3431 $ids[]= (int)$attrs["$attrib"][0];
3432 }
3434 /* Add the nobody id */
3435 $ids[]= 65534;
3437 /* get the ranges */
3438 $tmp = array('0'=> 1000);
3439 if (preg_match('/posixAccount/', $oc) && $config->get_cfg_value("core","uidNumberBase") != ""){
3440 $tmp= explode('-',$config->get_cfg_value("core","uidNumberBase"));
3441 } elseif($config->get_cfg_value("core","gidNumberBase") != ""){
3442 $tmp= explode('-',$config->get_cfg_value("core","gidNumberBase"));
3443 }
3445 /* Set hwm to max if not set - for backward compatibility */
3446 $lwm= $tmp[0];
3447 if (isset($tmp[1])){
3448 $hwm= $tmp[1];
3449 } else {
3450 $hwm= pow(2,32);
3451 }
3452 /* Find out next free id near to UID_BASE */
3453 if ($config->get_cfg_value("core","baseIdHook") == ""){
3454 $base= $lwm;
3455 } else {
3456 /* Call base hook */
3457 $base= get_base_from_hook($dn, $attrib);
3458 }
3459 for ($id= $base; $id++; $id < pow(2,32)){
3460 if (!in_array($id, $ids)){
3461 return ($id);
3462 }
3463 }
3465 /* Should not happen */
3466 if ($id == $hwm){
3467 msg_dialog::display(_("Error"), _("Cannot allocate free ID!"), ERROR_DIALOG);
3468 exit;
3469 }
3470 }
3473 /* Mark the occurance of a string with a span */
3474 function mark($needle, $haystack, $ignorecase= true)
3475 {
3476 $result= "";
3478 while (preg_match('/^(.*)('.preg_quote($needle).')(.*)$/i', $haystack, $matches)) {
3479 $result.= $matches[1]."<span class='mark'>".$matches[2]."</span>";
3480 $haystack= $matches[3];
3481 }
3483 return $result.$haystack;
3484 }
3487 /* Return an image description using the path */
3488 function image($path, $action= "", $title= "", $align= "middle")
3489 {
3490 global $config;
3491 global $BASE_DIR;
3492 $label= null;
3494 // Bail out, if there's no style file
3495 if(!session::global_is_set("img-styles")){
3497 // Get theme
3498 if (isset ($config)){
3499 $theme= $config->get_cfg_value("core","theme", "default");
3500 } else {
3501 # For debuging - avoid that there's no theme set
3502 die("config not set!");
3503 $theme= "default";
3504 }
3506 if (!file_exists("$BASE_DIR/ihtml/themes/$theme/img.styles")){
3507 die ("No img.style for this theme found!");
3508 }
3510 session::global_set('img-styles', unserialize(file_get_contents("$BASE_DIR/ihtml/themes/$theme/img.styles")));
3511 }
3512 $styles= session::global_get('img-styles');
3514 /* Extract labels from path */
3515 if (preg_match("/\.png\[(.*)\]$/", $path, $matches)) {
3516 $label= $matches[1];
3517 }
3519 $lbl= "";
3520 if ($label) {
3521 if (isset($styles["images/label-".$label.".png"])) {
3522 $lbl= "<div style='".$styles["images/label-".$label.".png"]."'></div>";
3523 } else {
3524 die("Invalid label specified: $label\n");
3525 }
3527 $path= preg_replace("/\[.*\]$/", "", $path);
3528 }
3530 // Non middle layout?
3531 if ($align == "middle") {
3532 $align= "";
3533 } else {
3534 $align= ";vertical-align:$align";
3535 }
3537 // Clickable image or not?
3538 if ($title != "") {
3539 $title= "title='$title'";
3540 }
3541 if ($action == "") {
3542 return "<div class='img' $title style='".$styles[$path]."$align'>$lbl</div>";
3543 } else {
3544 return "<input type='submit' class='img' id='$action' value='' name='$action' $title style='".$styles[$path]."$align'>";
3545 }
3546 }
3548 /*! \brief Encodes a complex string to be useable in HTML posts.
3549 */
3550 function postEncode($str)
3551 {
3552 return(preg_replace("/=/","_", base64_encode($str)));
3553 }
3555 /*! \brief Decodes a string encoded by postEncode
3556 */
3557 function postDecode($str)
3558 {
3559 return(base64_decode(preg_replace("/_/","=", $str)));
3560 }
3563 /*! \brief Generate styled output
3564 */
3565 function bold($str)
3566 {
3567 return "<span class='highlight'>$str</span>";
3568 }
3571 // vim:tabstop=2:expandtab:shiftwidth=2:filetype=php:syntax:ruler:
3572 ?>