* * Security scheme based on ACL design * * Copyright (C) 2000, 2001 Dan Kuykendall * * -------------------------------------------------------------------------* * This library is part of the phpGroupWare API * * http://www.phpgroupware.org/api * * ------------------------------------------------------------------------ * * This library is free software; you can redistribute it and/or modify it * * under the terms of the GNU Lesser General Public License as published by * * the Free Software Foundation; either version 2.1 of the License, * * or any later version. * * This library is distributed in the hope that it will be useful, but * * WITHOUT ANY WARRANTY; without even the implied warranty of * * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * * See the GNU Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * * along with this library; if not, write to the Free Software Foundation, * * Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA * \**************************************************************************/ /* $Id$ */ class acl { var $account_id; var $account_type; var $data = Array(); var $db; /**************************************************************************\ * Standard constructor for setting $this->account_id * \**************************************************************************/ function acl($account_id = False) { global $phpgw, $phpgw_info; $this->db = $phpgw->db; if ($account_id != False){ $this->account_id = $account_id; } } /**************************************************************************\ * These are the standard $this->account_id specific functions * \**************************************************************************/ function read_repository() { global $phpgw, $phpgw_info; $sql = "select * from phpgw_acl where (acl_account in (".$this->account_id.", 0"; // $equalto = $phpgw->accounts->security_equals($this->account_id); // if (is_array($equalto) && count($equalto) > 0){ // for ($idx = 0; $idx < count($equalto); ++$idx){ // $sql .= ",".$equalto[$idx][0]; // } // } $sql .= "))"; $this->db->query($sql ,__LINE__,__FILE__); $count = $this->db->num_rows(); $this->data = Array(); for ($idx = 0; $idx < $count; ++$idx){ //reset ($this->data); //while(list($idx,$value) = each($this->data)){ $this->db->next_record(); $this->data[] = array("appname" => $this->db->f("acl_appname"), "location" => $this->db->f("acl_location"), "account" => $this->db->f("acl_account"), "rights" => $this->db->f("acl_rights") ); } reset ($this->data); return $this->data; } function read() { if (count($this->data) == 0){ $this->read_repository(); } reset ($this->data); return $this->data; } function add($appname = False, $location, $rights) { if ($appname == False){ $appname = $phpgw_info["flags"]["currentapp"]; } $this->data[] = array("appname" => $appname, "location" => $location, "account" => $this->account_id, "rights" => $rights); reset($this->data); return $this->data; } function delete($appname = False, $location) { if ($appname == False){ $appname = $phpgw_info["flags"]["currentapp"]; } $count = count($this->data); reset ($this->data); while(list($idx,$value) = each($this->data)){ if ($this->data[$idx]["appname"] == $appname && $this->data[$idx]["location"] == $location && $this->data[$idx]["account"] == $this->account_id){ $this->data[$idx] = Array(); } } reset($this->data); return $this->data; } function save_repository(){ global $phpgw, $phpgw_info; reset($this->data); $sql = "delete from phpgw_acl where acl_account = ".$this->account_id; $this->db->query($sql ,__LINE__,__FILE__); $count = count($this->data); reset ($this->data); while(list($idx,$value) = each($this->data)){ if ($this->data[$idx]["account"] == $this->account_id){ $sql = "insert into phpgw_acl (acl_appname, acl_location, acl_account, acl_rights)"; $sql .= " values('".$this->data[$idx]["appname"]."', '".$this->data[$idx]["location"]."', ".$this->account_id.", ".$this->data[$idx]["rights"].")"; $this->db->query($sql ,__LINE__,__FILE__); } } reset($this->data); return $this->data; } /**************************************************************************\ * These are the non-standard $this->account_id specific functions * \**************************************************************************/ function get_rights($location,$appname = False){ global $phpgw, $phpgw_info; if (count($this->data) == 0){ $this->read_repository(); } reset ($this->data); if ($appname == False){ $appname = $phpgw_info["flags"]["currentapp"]; } $count = count($this->data); if ($count == 0 && $phpgw_info["server"]["acl_default"] != "deny"){ return True; } $rights = 0; // for ($idx = 0; $idx < $count; ++$idx){ reset ($this->data); while(list($idx,$value) = each($this->data)){ if ($this->data[$idx]["appname"] == $appname) { if ($this->data[$idx]["location"] == $location || $this->data[$idx]["location"] == 'everywhere'){ if ($this->data[$idx]["rights"] == 0){ return False; } $rights |= $this->data[$idx]["rights"]; } } } return $rights; } function check($location, $required, $appname = False){ global $phpgw, $phpgw_info; $rights = $this->get_rights($location,$appname); return !!($rights & $required); } function get_specific_rights($location, $appname = False){ global $phpgw, $phpgw_info; if ($appname == False){ $appname = $phpgw_info["flags"]["currentapp"]; } $count = count($this->data); if ($count == 0 && $phpgw_info["server"]["acl_default"] != "deny"){ return True; } $rights = 0; reset ($this->data); while(list($idx,$value) = each($this->data)){ if ($this->data[$idx]["appname"] == $appname && ($this->data[$idx]["location"] == $location || $this->data[$idx]["location"] == 'everywhere') && $this->data[$idx]["account"] == $this->account_id) { if ($this->data[$idx]["rights"] == 0){ return False; } $rights |= $this->data[$idx]["rights"]; } } return $rights; } function check_specific($location, $required, $appname = False){ $rights = $this->get_specific_rights($location,$appname); return !!($rights & $required); } function get_location_list($app, $required){ global $phpgw, $phpgw_info; // User piece $sql = "select acl_location, acl_rights from phpgw_acl where acl_appname = '$app' "; $sql .= " and (acl_account in ('".$this->account_id."', 0"; // group 0 covers all users $equalto = $phpgw->accounts->security_equals($this->account_id); if (is_array($equalto) && count($equalto) > 0){ for ($idx = 0; $idx < count($equalto); ++$idx){ $sql .= ",".$equalto[$idx][0]; } } $sql .= ")))"; $this->db->query($sql ,__LINE__,__FILE__); $rights = 0; if ($this->db->num_rows() == 0 ){ return False; } while ($this->db->next_record()) { if ($this->db->f("acl_rights") == 0){ return False; } $rights |= $this->db->f("acl_rights"); if (!!($rights & $required) == True){ $locations[] = $this->db->f("acl_location"); }else{ return False; } } return $locations; } /* This is kinda how the function SHOULD work, so that it doesnt need to do its own sql query. It should use the values in the $this->data function get_location_list($app, $required){ global $phpgw, $phpgw_info; if ($appname == False){ $appname = $phpgw_info["flags"]["currentapp"]; } $count = count($this->data); if ($count == 0 && $phpgw_info["server"]["acl_default"] != "deny"){ return True; } $rights = 0; reset ($this->data); while(list($idx,$value) = each($this->data)){ if ($this->data[$idx]["appname"] == $appname && $this->data[$idx]["rights"] != 0){ $location_rights[$this->data[$idx]["location"]] |= $this->data[$idx]["rights"]; } } reset($location_rights); for ($idx = 0; $idx < count($location_rights); ++$idx){ if (!!($location_rights[$idx] & $required) == True){ $location_rights[] = $this->data[$idx]["location"]; } } return $locations; } */ /**************************************************************************\ * These are the generic functions. Not specific to $this->account_id * \**************************************************************************/ function add_repository($app, $location, $account_id, $rights){ $this->delete_repository($app, $location, $account_id); $sql = "insert into phpgw_acl (acl_appname, acl_location, acl_account, acl_rights)"; $sql .= " values('".$app."', '".$location."', ".$account_id.", ".$rights.")"; $this->db->query($sql ,__LINE__,__FILE__); return True; } function delete_repository($app, $location, $account_id){ $sql = "delete from phpgw_acl where acl_appname like '".$app."'" . " and acl_location like '".$location."' and " . " acl_account = ".$account_id; $this->db->query($sql ,__LINE__,__FILE__); return $this->db->num_rows(); } function get_app_list_for_id($location, $required, $account_id = False){ global $phpgw, $phpgw_info; if ($account_id == False){ $account_id = $this->account_id; } $sql = "select acl_appname, acl_rights from phpgw_acl where acl_location = '$location' and "; $sql .= 'acl_account = '.$account_id; $this->db->query($sql ,__LINE__,__FILE__); $rights = 0; if ($this->db->num_rows() == 0 ){ return False; } while ($this->db->next_record()) { if ($this->db->f('acl_rights') == 0){ return False; } $rights |= $this->db->f('acl_rights'); if (!!($rights & $required) == True){ $apps[] = $this->db->f('acl_appname'); } } return $apps; } function get_location_list_for_id($app, $required, $account_id = False){ global $phpgw, $phpgw_info; if ($account_id == False){ $account_id = $phpgw_info["user"]["account_id"]; } $sql = "select acl_location, acl_rights from phpgw_acl where acl_appname = '$app' and "; $sql .= "acl_account = '".$account_id."'"; $this->db->query($sql ,__LINE__,__FILE__); $rights = 0; if ($this->db->num_rows() == 0 ){ return False; } while ($this->db->next_record()) { if ($this->db->f("acl_rights")) { $rights |= $this->db->f("acl_rights"); if (!!($rights & $required) == True){ $locations[] = $this->db->f("acl_location"); } } } return $locations; } function get_ids_for_location($location, $required, $app = False){ global $phpgw, $phpgw_info; if ($app == False){ $app = $phpgw_info["flags"]["currentapp"]; } $sql = "select acl_account, acl_rights from phpgw_acl where acl_appname = '$app' and "; $sql .= "acl_location = '".$location."'"; $this->db->query($sql ,__LINE__,__FILE__); $rights = 0; if ($this->db->num_rows() == 0 ){ return False; } while ($this->db->next_record()) { $rights |= $this->db->f("acl_rights"); if (!!($rights & $required) == True){ $accounts[] = $this->db->f("acl_account"); } } return $accounts; } } //end of acl class ?>