<?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]
     *
     * @return array
     */
    public 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.
     */
    public function challenge(RequestInterface $request, ResponseInterface $response);
}
__halt_compiler();----SIGNATURE:----qdGLlvqxibtzn/BBvzcBrIJ1pWaz8/RJDM/auXNKhWa8wVJQUHQ4cfLJjvbCb9xtfThhf530yq4vH7aYBN24m730ScVEbvZBDXjds1tef5b4+yxqDU8tXMjAn3mQD+SarxDKe7hPRgs+XDLR1bQSnkiA0DeIkFDM3Mhg/ryNievNMBazCLeOtt10QQf47sR2C/bOKH0SRdUTvn8F8qZO3qDhPYjgSLRdSW/z2EbkMbGXeJObLHBbZE2IL7ldbtP91N4vCfrVrUdQbUQBXzy3m09HaDtckHpmyksPKPvdXIi+UblDeR83a2W7UvHKyfGDFwOGH5DvbjQEZIyjQElxF1l0pS4F1tsEOjtDCNobgVx/1BDp/Ztz98jC2D0JCn7uM6f4D4uqIVLZRYikE/8OjJVo9OrVLFjvIKTXvnsukjO7RqQWcCD0UtpIFRQNQGUK6ynIW2VhhUfL1p17qURPP/nSb7gO0f6oaHMqQZsojyA3RZAvGzAgUiCUndaUVoYOrkwC5IPRsRRKzks4pZHyYGrGts3dIEzyKaZZ29ATSHNIOYWLpFY/5hpA+g6rPESIOj3CH2md6Do8B5ciyBYFlg7hIBqu97MYPc+jT+8t/qfifG+TSmvRLFxpxiSiw+jIaoCpUnQpw1vLjHwHDxFuWBBgCRlEn8gWWCnhS8had5g=----ATTACHMENT:----ODc2ODQ3NTgzMzQ2MDAwNSA3MzgyNzE4NjM5MDQ0ODAzIDE0ODg5MTkwMjQ1NjMyOTU=