<?php
/* $Id$ */
namespace Mammut\Auth\HTTP;

(defined('MAMMUT') && (basename(__FILE__) != basename($_SERVER['SCRIPT_NAME']))) or die('ACCESS DENIED');

/**
 * A generic interface for HTTP auth methods
 *
 * @author Stefan Daurer <s.daurer@q-spot.org>
 * @package Mammut\Auth
 */
interface iAuthClient {

	/**
	 * Has to return true if the combination of username and secret are valid.
	 *
	 * @param string $user
	 *        	the username
	 * @return boolean true on success, false otherwise
	 */
	public function isUserSecretValid($user, $secret);

	/**
	 * Has to return the password of the user in plain text.
	 * Not needed by all auth types, but some (like digest).
	 *
	 * @param string $user
	 *        	the username
	 * @return string the password or NULL if user is not found
	 */
	public function getUserSecret($user);
}