cakephp2-php8/lib/Cake/Controller/Component/Auth/BasicAuthenticate.php

111 lines
3.5 KiB
PHP
Raw Normal View History

2011-01-21 23:10:45 +00:00
<?php
/**
*
2011-01-21 23:10:45 +00:00
*
* CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
* Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
2011-01-21 23:10:45 +00:00
*
* Licensed under The MIT License
* For full copyright and license information, please see the LICENSE.txt
2011-01-21 23:10:45 +00:00
* Redistributions of files must retain the above copyright notice.
*
* @copyright Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
2011-01-21 23:10:45 +00:00
* @link http://cakephp.org CakePHP(tm) Project
* @license http://www.opensource.org/licenses/mit-license.php MIT License
2011-01-21 23:10:45 +00:00
*/
2011-03-06 00:07:56 +00:00
App::uses('BaseAuthenticate', 'Controller/Component/Auth');
2011-01-21 23:10:45 +00:00
2011-01-22 21:27:07 +00:00
/**
* Basic Authentication adapter for AuthComponent.
*
2012-12-22 22:48:15 +00:00
* Provides Basic HTTP authentication support for AuthComponent. Basic Auth will authenticate users
* against the configured userModel and verify the username and passwords match. Clients using Basic Authentication
* must support cookies. Since AuthComponent identifies users based on Session contents, clients using Basic
2011-01-22 21:27:07 +00:00
* Auth must support cookies.
*
* ### Using Basic auth
2011-08-16 03:55:08 +00:00
*
2011-01-22 21:27:07 +00:00
* In your controller's components array, add auth + the required settings.
* {{{
* public $components = array(
2011-01-22 21:27:07 +00:00
* 'Auth' => array(
* 'authenticate' => array('Basic')
* )
* );
* }}}
*
2012-12-22 22:48:15 +00:00
* In your login function just call `$this->Auth->login()` without any checks for POST data. This
2011-01-22 21:27:07 +00:00
* will send the authentication headers, and trigger the login dialog in the browser/client.
*
* @package Cake.Controller.Component.Auth
2011-01-22 21:27:07 +00:00
* @since 2.0
*/
2011-01-21 23:10:45 +00:00
class BasicAuthenticate extends BaseAuthenticate {
/**
* Constructor, completes configuration for basic authentication.
*
* @param ComponentCollection $collection The Component collection used on this request.
2011-01-22 21:27:07 +00:00
* @param array $settings An array of settings.
*/
public function __construct(ComponentCollection $collection, $settings) {
parent::__construct($collection, $settings);
if (empty($this->settings['realm'])) {
$this->settings['realm'] = env('SERVER_NAME');
}
}
2011-01-22 21:27:07 +00:00
2011-01-21 23:10:45 +00:00
/**
2013-03-03 20:42:52 +00:00
* Authenticate a user using HTTP auth. Will use the configured User model and attempt a
* login using HTTP auth.
2011-01-21 23:10:45 +00:00
*
* @param CakeRequest $request The request to authenticate with.
* @param CakeResponse $response The response to add headers to.
2011-01-21 23:10:45 +00:00
* @return mixed Either false on failure, or an array of user data on success.
*/
public function authenticate(CakeRequest $request, CakeResponse $response) {
2013-03-03 20:42:52 +00:00
return $this->getUser($request);
}
/**
2012-12-22 22:48:15 +00:00
* Get a user based on information in the request. Used by cookie-less auth for stateless clients.
*
* @param CakeRequest $request Request object.
* @return mixed Either false or an array of user information
*/
2013-02-09 12:39:11 +00:00
public function getUser(CakeRequest $request) {
$username = env('PHP_AUTH_USER');
$pass = env('PHP_AUTH_PW');
2011-08-16 03:55:08 +00:00
if (empty($username) || empty($pass)) {
return false;
}
return $this->_findUser($username, $pass);
}
2013-03-03 20:42:52 +00:00
/**
* Handles an unauthenticated access attempt by sending appropriate login headers
*
* @param CakeRequest $request A request object.
* @param CakeResponse $response A response object.
2013-03-18 14:58:12 +00:00
* @return void
* @throws UnauthorizedException
2013-03-03 20:42:52 +00:00
*/
public function unauthenticated(CakeRequest $request, CakeResponse $response) {
$Exception = new UnauthorizedException();
2013-03-18 14:58:12 +00:00
$Exception->responseHeader(array($this->loginHeaders()));
throw $Exception;
2013-03-03 20:42:52 +00:00
}
/**
* Generate the login headers
*
* @return string Headers for logging in.
*/
public function loginHeaders() {
return sprintf('WWW-Authenticate: Basic realm="%s"', $this->settings['realm']);
2011-01-21 23:10:45 +00:00
}
}