mirror of
https://codeberg.org/streams/streams.git
synced 2024-09-22 21:15:16 +00:00
70 lines
2.1 KiB
PHP
70 lines
2.1 KiB
PHP
<?php
|
|
|
|
namespace Sabre\DAV\Auth\Backend;
|
|
|
|
use Sabre\HTTP\RequestInterface;
|
|
use Sabre\HTTP\ResponseInterface;
|
|
|
|
/**
|
|
* This is the base class for any authentication object.
|
|
*
|
|
* @copyright Copyright (C) fruux GmbH (https://fruux.com/)
|
|
* @author Evert Pot (http://evertpot.com/)
|
|
* @license http://sabre.io/license/ Modified BSD License
|
|
*/
|
|
interface BackendInterface {
|
|
|
|
/**
|
|
* When this method is called, the backend must check if authentication was
|
|
* successful.
|
|
*
|
|
* The returned value must be one of the following
|
|
*
|
|
* [true, "principals/username"]
|
|
* [false, "reason for failure"]
|
|
*
|
|
* If authentication was successful, it's expected that the authentication
|
|
* backend returns a so-called principal url.
|
|
*
|
|
* Examples of a principal url:
|
|
*
|
|
* principals/admin
|
|
* principals/user1
|
|
* principals/users/joe
|
|
* principals/uid/123457
|
|
*
|
|
* If you don't use WebDAV ACL (RFC3744) we recommend that you simply
|
|
* return a string such as:
|
|
*
|
|
* principals/users/[username]
|
|
*
|
|
* @param RequestInterface $request
|
|
* @param ResponseInterface $response
|
|
* @return array
|
|
*/
|
|
function check(RequestInterface $request, ResponseInterface $response);
|
|
|
|
/**
|
|
* This method is called when a user could not be authenticated, and
|
|
* authentication was required for the current request.
|
|
*
|
|
* This gives you the opportunity to set authentication headers. The 401
|
|
* status code will already be set.
|
|
*
|
|
* In this case of Basic Auth, this would for example mean that the
|
|
* following header needs to be set:
|
|
*
|
|
* $response->addHeader('WWW-Authenticate', 'Basic realm=SabreDAV');
|
|
*
|
|
* Keep in mind that in the case of multiple authentication backends, other
|
|
* WWW-Authenticate headers may already have been set, and you'll want to
|
|
* append your own WWW-Authenticate header instead of overwriting the
|
|
* existing one.
|
|
*
|
|
* @param RequestInterface $request
|
|
* @param ResponseInterface $response
|
|
* @return void
|
|
*/
|
|
function challenge(RequestInterface $request, ResponseInterface $response);
|
|
|
|
}
|