'name'); will validate mapActions against model $name::isAuthorized(user, controller, mapAction) * 'object' will validate Controller::action against object::isAuthorized(user, controller, action) * * @var mixed * @access public * @link http://book.cakephp.org/view/1275/authorize */ var $authorize = false; /** * The name of an optional view element to render when an Ajax request is made * with an invalid or expired session * * @var string * @access public * @link http://book.cakephp.org/view/1277/ajaxLogin */ var $ajaxLogin = null; /** * The name of the element used for SessionComponent::setFlash * * @var string * @access public */ var $flashElement = 'default'; /** * The name of the model that represents users which will be authenticated. Defaults to 'User'. * * @var string * @access public * @link http://book.cakephp.org/view/1266/userModel */ var $userModel = 'User'; /** * Additional query conditions to use when looking up and authenticating users, * i.e. array('User.is_active' => 1). * * @var array * @access public * @link http://book.cakephp.org/view/1268/userScope */ var $userScope = array(); /** * Allows you to specify non-default login name and password fields used in * $userModel, i.e. array('username' => 'login_name', 'password' => 'passwd'). * * @var array * @access public * @link http://book.cakephp.org/view/1267/fields */ var $fields = array('username' => 'username', 'password' => 'password'); /** * The session key name where the record of the current user is stored. If * unspecified, it will be "Auth.{$userModel name}". * * @var string * @access public * @link http://book.cakephp.org/view/1276/sessionKey */ var $sessionKey = null; /** * If using action-based access control, this defines how the paths to action * ACO nodes is computed. If, for example, all controller nodes are nested * under an ACO node named 'Controllers', $actionPath should be set to * "Controllers/". * * @var string * @access public * @link http://book.cakephp.org/view/1279/actionPath */ var $actionPath = null; /** * A URL (defined as a string or array) to the controller action that handles * logins. * * @var mixed * @access public * @link http://book.cakephp.org/view/1269/loginAction */ var $loginAction = null; /** * Normally, if a user is redirected to the $loginAction page, the location they * were redirected from will be stored in the session so that they can be * redirected back after a successful login. If this session value is not * set, the user will be redirected to the page specified in $loginRedirect. * * @var mixed * @access public * @link http://book.cakephp.org/view/1270/loginRedirect */ var $loginRedirect = null; /** * The default action to redirect to after the user is logged out. While AuthComponent does * not handle post-logout redirection, a redirect URL will be returned from AuthComponent::logout(). * Defaults to AuthComponent::$loginAction. * * @var mixed * @access public * @see AuthComponent::$loginAction * @see AuthComponent::logout() * @link http://book.cakephp.org/view/1271/logoutRedirect */ var $logoutRedirect = null; /** * The name of model or model object, or any other object has an isAuthorized method. * * @var string * @access public */ var $object = null; /** * Error to display when user login fails. For security purposes, only one error is used for all * login failures, so as not to expose information on why the login failed. * * @var string * @access public * @link http://book.cakephp.org/view/1272/loginError */ var $loginError = null; /** * Error to display when user attempts to access an object or action to which they do not have * acccess. * * @var string * @access public * @link http://book.cakephp.org/view/1273/authError */ var $authError = null; /** * Determines whether AuthComponent will automatically redirect and exit if login is successful. * * @var boolean * @access public * @link http://book.cakephp.org/view/1274/autoRedirect */ var $autoRedirect = true; /** * Controller actions for which user validation is not required. * * @var array * @access public * @see AuthComponent::allow() * @link http://book.cakephp.org/view/1251/Setting-Auth-Component-Variables */ var $allowedActions = array(); /** * Maps actions to CRUD operations. Used for controller-based validation ($validate = 'controller'). * * @var array * @access public * @see AuthComponent::mapActions() */ var $actionMap = array( 'index' => 'read', 'add' => 'create', 'edit' => 'update', 'view' => 'read', 'remove' => 'delete' ); /** * Form data from Controller::$data * * @var array * @access public */ var $data = array(); /** * Parameter data from Controller::$params * * @var array * @access public */ var $params = array(); /** * Method list for bound controller * * @var array * @access protected */ var $_methods = array(); /** * Initializes AuthComponent for use in the controller * * @param object $controller A reference to the instantiating controller object * @return void * @access public */ function initialize(&$controller, $settings = array()) { $this->params = $controller->params; $crud = array('create', 'read', 'update', 'delete'); $this->actionMap = array_merge($this->actionMap, array_combine($crud, $crud)); $this->_methods = $controller->methods; $prefixes = Router::prefixes(); if (!empty($prefixes)) { foreach ($prefixes as $prefix) { $this->actionMap = array_merge($this->actionMap, array( $prefix . '_index' => 'read', $prefix . '_add' => 'create', $prefix . '_edit' => 'update', $prefix . '_view' => 'read', $prefix . '_remove' => 'delete', $prefix . '_create' => 'create', $prefix . '_read' => 'read', $prefix . '_update' => 'update', $prefix . '_delete' => 'delete' )); } } $this->_set($settings); if (Configure::read() > 0) { App::import('Debugger'); Debugger::checkSecurityKeys(); } } /** * Main execution method. Handles redirecting of invalid users, and processing * of login form data. * * @param object $controller A reference to the instantiating controller object * @return boolean * @access public */ function startup(&$controller) { $isErrorOrTests = ( strtolower($controller->name) == 'cakeerror' || (strtolower($controller->name) == 'tests' && Configure::read() > 0) ); if ($isErrorOrTests) { return true; } $methods = array_flip($controller->methods); $action = strtolower($controller->params['action']); $isMissingAction = ( $controller->scaffold === false && !isset($methods[$action]) ); if ($isMissingAction) { return true; } if (!$this->__setDefaults()) { return false; } $this->data = $controller->data = $this->hashPasswords($controller->data); $url = ''; if (isset($controller->params['url']['url'])) { $url = $controller->params['url']['url']; } $url = Router::normalize($url); $loginAction = Router::normalize($this->loginAction); $allowedActions = array_map('strtolower', $this->allowedActions); $isAllowed = ( $this->allowedActions == array('*') || in_array($action, $allowedActions) ); if ($loginAction != $url && $isAllowed) { return true; } if ($loginAction == $url) { $model =& $this->getModel(); if (empty($controller->data) || !isset($controller->data[$model->alias])) { if (!$this->Session->check('Auth.redirect') && !$this->loginRedirect && env('HTTP_REFERER')) { $this->Session->write('Auth.redirect', $controller->referer(null, true)); } return false; } $isValid = !empty($controller->data[$model->alias][$this->fields['username']]) && !empty($controller->data[$model->alias][$this->fields['password']]); if ($isValid) { $username = $controller->data[$model->alias][$this->fields['username']]; $password = $controller->data[$model->alias][$this->fields['password']]; $data = array( $model->alias . '.' . $this->fields['username'] => $username, $model->alias . '.' . $this->fields['password'] => $password ); if ($this->login($data)) { if ($this->autoRedirect) { $controller->redirect($this->redirect(), null, true); } return true; } } $this->Session->setFlash($this->loginError, $this->flashElement, array(), 'auth'); $controller->data[$model->alias][$this->fields['password']] = null; return false; } else { if (!$this->user()) { if (!$this->RequestHandler->isAjax()) { $this->Session->setFlash($this->authError, $this->flashElement, array(), 'auth'); if (!empty($controller->params['url']) && count($controller->params['url']) >= 2) { $query = $controller->params['url']; unset($query['url'], $query['ext']); $url .= Router::queryString($query, array()); } $this->Session->write('Auth.redirect', $url); $controller->redirect($loginAction); return false; } elseif (!empty($this->ajaxLogin)) { $controller->viewPath = 'elements'; echo $controller->render($this->ajaxLogin, $this->RequestHandler->ajaxLayout); $this->_stop(); return false; } else { $controller->redirect(null, 403); } } } if (!$this->authorize) { return true; } extract($this->__authType()); switch ($type) { case 'controller': $this->object =& $controller; break; case 'crud': case 'actions': if (isset($controller->Acl)) { $this->Acl =& $controller->Acl; } else { trigger_error(__('Could not find AclComponent. Please include Acl in Controller::$components.', true), E_USER_WARNING); } break; case 'model': if (!isset($object)) { $hasModel = ( isset($controller->{$controller->modelClass}) && is_object($controller->{$controller->modelClass}) ); $isUses = ( !empty($controller->uses) && isset($controller->{$controller->uses[0]}) && is_object($controller->{$controller->uses[0]}) ); if ($hasModel) { $object = $controller->modelClass; } elseif ($isUses) { $object = $controller->uses[0]; } } $type = array('model' => $object); break; } if ($this->isAuthorized($type)) { return true; } $this->Session->setFlash($this->authError, $this->flashElement, array(), 'auth'); $controller->redirect($controller->referer(), null, true); return false; } /** * Attempts to introspect the correct values for object properties including * $userModel and $sessionKey. * * @param object $controller A reference to the instantiating controller object * @return boolean * @access private */ function __setDefaults() { if (empty($this->userModel)) { trigger_error(__("Could not find \$userModel. Please set AuthComponent::\$userModel in beforeFilter().", true), E_USER_WARNING); return false; } list($plugin, $model) = pluginSplit($this->userModel); $defaults = array( 'loginAction' => array( 'controller' => Inflector::underscore(Inflector::pluralize($model)), 'action' => 'login', 'plugin' => Inflector::underscore($plugin), ), 'sessionKey' => 'Auth.' . $model, 'logoutRedirect' => $this->loginAction, 'loginError' => __('Login failed. Invalid username or password.', true), 'authError' => __('You are not authorized to access that location.', true) ); foreach ($defaults as $key => $value) { if (empty($this->{$key})) { $this->{$key} = $value; } } return true; } /** * Determines whether the given user is authorized to perform an action. The type of * authorization used is based on the value of AuthComponent::$authorize or the * passed $type param. * * Types: * 'controller' will validate against Controller::isAuthorized() if controller instance is * passed in $object * 'actions' will validate Controller::action against an AclComponent::check() * 'crud' will validate mapActions against an AclComponent::check() * array('model'=> 'name'); will validate mapActions against model * $name::isAuthorized(user, controller, mapAction) * 'object' will validate Controller::action against * object::isAuthorized(user, controller, action) * * @param string $type Type of authorization * @param mixed $object object, model object, or model name * @param mixed $user The user to check the authorization of * @return boolean True if $user is authorized, otherwise false * @access public */ function isAuthorized($type = null, $object = null, $user = null) { if (empty($user) && !$this->user()) { return false; } elseif (empty($user)) { $user = $this->user(); } extract($this->__authType($type)); if (!$object) { $object = $this->object; } $valid = false; switch ($type) { case 'controller': $valid = $object->isAuthorized(); break; case 'actions': $valid = $this->Acl->check($user, $this->action()); break; case 'crud': if (!isset($this->actionMap[$this->params['action']])) { trigger_error( sprintf(__('Auth::startup() - Attempted access of un-mapped action "%1$s" in controller "%2$s"', true), $this->params['action'], $this->params['controller']), E_USER_WARNING ); } else { $valid = $this->Acl->check( $user, $this->action(':controller'), $this->actionMap[$this->params['action']] ); } break; case 'model': $action = $this->params['action']; if (isset($this->actionMap[$action])) { $action = $this->actionMap[$action]; } if (is_string($object)) { $object = $this->getModel($object); } case 'object': if (!isset($action)) { $action = $this->action(':action'); } if (empty($object)) { trigger_error(sprintf(__('Could not find %s. Set AuthComponent::$object in beforeFilter() or pass a valid object', true), get_class($object)), E_USER_WARNING); return; } if (method_exists($object, 'isAuthorized')) { $valid = $object->isAuthorized($user, $this->action(':controller'), $action); } elseif ($object) { trigger_error(sprintf(__('%s::isAuthorized() is not defined.', true), get_class($object)), E_USER_WARNING); } break; case null: case false: return true; break; default: trigger_error(__('Auth::isAuthorized() - $authorize is set to an incorrect value. Allowed settings are: "actions", "crud", "model" or null.', true), E_USER_WARNING); break; } return $valid; } /** * Get authorization type * * @param string $auth Type of authorization * @return array Associative array with: type, object * @access private */ function __authType($auth = null) { if ($auth == null) { $auth = $this->authorize; } $object = null; if (is_array($auth)) { $type = key($auth); $object = $auth[$type]; } else { $type = $auth; return compact('type'); } return compact('type', 'object'); } /** * Takes a list of actions in the current controller for which authentication is not required, or * no parameters to allow all actions. * * @param mixed $action Controller action name or array of actions * @param string $action Controller action name * @param string ... etc. * @return void * @access public * @link http://book.cakephp.org/view/1257/allow */ function allow() { $args = func_get_args(); if (empty($args) || $args == array('*')) { $this->allowedActions = $this->_methods; } else { if (isset($args[0]) && is_array($args[0])) { $args = $args[0]; } $this->allowedActions = array_merge($this->allowedActions, array_map('strtolower', $args)); } } /** * Removes items from the list of allowed actions. * * @param mixed $action Controller action name or array of actions * @param string $action Controller action name * @param string ... etc. * @return void * @see AuthComponent::allow() * @access public * @link http://book.cakephp.org/view/1258/deny */ function deny() { $args = func_get_args(); if (isset($args[0]) && is_array($args[0])) { $args = $args[0]; } foreach ($args as $arg) { $i = array_search(strtolower($arg), $this->allowedActions); if (is_int($i)) { unset($this->allowedActions[$i]); } } $this->allowedActions = array_values($this->allowedActions); } /** * Maps action names to CRUD operations. Used for controller-based authentication. * * @param array $map Actions to map * @return void * @access public * @link http://book.cakephp.org/view/1260/mapActions */ function mapActions($map = array()) { $crud = array('create', 'read', 'update', 'delete'); foreach ($map as $action => $type) { if (in_array($action, $crud) && is_array($type)) { foreach ($type as $typedAction) { $this->actionMap[$typedAction] = $action; } } else { $this->actionMap[$action] = $type; } } } /** * Manually log-in a user with the given parameter data. The $data provided can be any data * structure used to identify a user in AuthComponent::identify(). If $data is empty or not * specified, POST data from Controller::$data will be used automatically. * * After (if) login is successful, the user record is written to the session key specified in * AuthComponent::$sessionKey. * * @param mixed $data User object * @return boolean True on login success, false on failure * @access public * @link http://book.cakephp.org/view/1261/login */ function login($data = null) { $this->__setDefaults(); $this->_loggedIn = false; if (empty($data)) { $data = $this->data; } if ($user = $this->identify($data)) { $this->Session->write($this->sessionKey, $user); $this->_loggedIn = true; } return $this->_loggedIn; } /** * Logs a user out, and returns the login action to redirect to. * * @param mixed $url Optional URL to redirect the user to after logout * @return string AuthComponent::$loginAction * @see AuthComponent::$loginAction * @access public * @link http://book.cakephp.org/view/1262/logout */ function logout() { $this->__setDefaults(); $this->Session->delete($this->sessionKey); $this->Session->delete('Auth.redirect'); $this->_loggedIn = false; return Router::normalize($this->logoutRedirect); } /** * Get the current user from the session. * * @param string $key field to retrive. Leave null to get entire User record * @return mixed User record. or null if no user is logged in. * @access public * @link http://book.cakephp.org/view/1264/user */ function user($key = null) { $this->__setDefaults(); if (!$this->Session->check($this->sessionKey)) { return null; } if ($key == null) { $model =& $this->getModel(); return array($model->alias => $this->Session->read($this->sessionKey)); } else { $user = $this->Session->read($this->sessionKey); if (isset($user[$key])) { return $user[$key]; } return null; } } /** * If no parameter is passed, gets the authentication redirect URL. * * @param mixed $url Optional URL to write as the login redirect URL. * @return string Redirect URL * @access public */ function redirect($url = null) { if (!is_null($url)) { $redir = $url; $this->Session->write('Auth.redirect', $redir); } elseif ($this->Session->check('Auth.redirect')) { $redir = $this->Session->read('Auth.redirect'); $this->Session->delete('Auth.redirect'); if (Router::normalize($redir) == Router::normalize($this->loginAction)) { $redir = $this->loginRedirect; } } else { $redir = $this->loginRedirect; } return Router::normalize($redir); } /** * Validates a user against an abstract object. * * @param mixed $object The object to validate the user against. * @param mixed $user Optional. The identity of the user to be validated. * Uses the current user session if none specified. For * valid forms of identifying users, see * AuthComponent::identify(). * @param string $action Optional. The action to validate against. * @see AuthComponent::identify() * @return boolean True if the user validates, false otherwise. * @access public */ function validate($object, $user = null, $action = null) { if (empty($user)) { $user = $this->user(); } if (empty($user)) { return false; } return $this->Acl->check($user, $object, $action); } /** * Returns the path to the ACO node bound to a controller/action. * * @param string $action Optional. The controller/action path to validate the * user against. The current request action is used if * none is specified. * @return boolean ACO node path * @access public * @link http://book.cakephp.org/view/1256/action */ function action($action = ':plugin/:controller/:action') { $plugin = empty($this->params['plugin']) ? null : Inflector::camelize($this->params['plugin']) . '/'; return str_replace( array(':controller', ':action', ':plugin/'), array(Inflector::camelize($this->params['controller']), $this->params['action'], $plugin), $this->actionPath . $action ); } /** * Returns a reference to the model object specified, and attempts * to load it if it is not found. * * @param string $name Model name (defaults to AuthComponent::$userModel) * @return object A reference to a model object * @access public */ function &getModel($name = null) { $model = null; if (!$name) { $name = $this->userModel; } if (PHP5) { $model = ClassRegistry::init($name); } else { $model =& ClassRegistry::init($name); } if (empty($model)) { trigger_error(__('Auth::getModel() - Model is not set or could not be found', true), E_USER_WARNING); return null; } return $model; } /** * Identifies a user based on specific criteria. * * @param mixed $user Optional. The identity of the user to be validated. * Uses the current user session if none specified. * @param array $conditions Optional. Additional conditions to a find. * @return array User record data, or null, if the user could not be identified. * @access public */ function identify($user = null, $conditions = null) { if ($conditions === false) { $conditions = null; } elseif (is_array($conditions)) { $conditions = array_merge((array)$this->userScope, $conditions); } else { $conditions = $this->userScope; } $model =& $this->getModel(); if (empty($user)) { $user = $this->user(); if (empty($user)) { return null; } } elseif (is_object($user) && is_a($user, 'Model')) { if (!$user->exists()) { return null; } $user = $user->read(); $user = $user[$model->alias]; } elseif (is_array($user) && isset($user[$model->alias])) { $user = $user[$model->alias]; } if (is_array($user) && (isset($user[$this->fields['username']]) || isset($user[$model->alias . '.' . $this->fields['username']]))) { if (isset($user[$this->fields['username']]) && !empty($user[$this->fields['username']]) && !empty($user[$this->fields['password']])) { if (trim($user[$this->fields['username']]) == '=' || trim($user[$this->fields['password']]) == '=') { return false; } $find = array( $model->alias.'.'.$this->fields['username'] => $user[$this->fields['username']], $model->alias.'.'.$this->fields['password'] => $user[$this->fields['password']] ); } elseif (isset($user[$model->alias . '.' . $this->fields['username']]) && !empty($user[$model->alias . '.' . $this->fields['username']])) { if (trim($user[$model->alias . '.' . $this->fields['username']]) == '=' || trim($user[$model->alias . '.' . $this->fields['password']]) == '=') { return false; } $find = array( $model->alias.'.'.$this->fields['username'] => $user[$model->alias . '.' . $this->fields['username']], $model->alias.'.'.$this->fields['password'] => $user[$model->alias . '.' . $this->fields['password']] ); } else { return false; } $data = $model->find('first', array( 'conditions' => array_merge($find, $conditions), 'recursive' => 0 )); if (empty($data) || empty($data[$model->alias])) { return null; } } elseif (!empty($user) && is_string($user)) { $data = $model->find('first', array( 'conditions' => array_merge(array($model->escapeField() => $user), $conditions), )); if (empty($data) || empty($data[$model->alias])) { return null; } } if (!empty($data)) { if (!empty($data[$model->alias][$this->fields['password']])) { unset($data[$model->alias][$this->fields['password']]); } return $data[$model->alias]; } return null; } /** * Hash any passwords found in $data using $userModel and $fields['password'] * * @param array $data Set of data to look for passwords * @return array Data with passwords hashed * @access public * @link http://book.cakephp.org/view/1259/hashPasswords */ function hashPasswords($data) { if (is_object($this->authenticate) && method_exists($this->authenticate, 'hashPasswords')) { return $this->authenticate->hashPasswords($data); } if (is_array($data)) { $model =& $this->getModel(); if(isset($data[$model->alias])) { if (isset($data[$model->alias][$this->fields['username']]) && isset($data[$model->alias][$this->fields['password']])) { $data[$model->alias][$this->fields['password']] = $this->password($data[$model->alias][$this->fields['password']]); } } } return $data; } /** * Hash a password with the application's salt value (as defined with Configure::write('Security.salt'); * * @param string $password Password to hash * @return string Hashed password * @access public * @link http://book.cakephp.org/view/1263/password */ function password($password) { return Security::hash($password, null, true); } /** * Component shutdown. If user is logged in, wipe out redirect. * * @param object $controller Instantiating controller * @access public */ function shutdown(&$controller) { if ($this->_loggedIn) { $this->Session->delete('Auth.redirect'); } } }