1	<?php
2
3	/**
4	* This program is free software; you can redistribute it and/or
5	* modify it under the terms of the GNU General Public License
6	* as published by the Free Software Foundation; under version 2
7	* of the License (non-upgradable).
8	*
9	* This program is distributed in the hope that it will be useful,
10	* but WITHOUT ANY WARRANTY; without even the implied warranty of
11	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12	* GNU General Public License for more details.
13	*
14	* You should have received a copy of the GNU General Public License
15	* along with this program; if not, write to the Free Software
16	* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
17	*
18	* Copyright (c) 2002-2008 (original work) Public Research Centre Henri Tudor & University of Luxembourg
19	*                         (under the project TAO & TAO2);
20	*               2008-2010 (update and modification) Deutsche Institut für Internationale Pädagogische Forschung
21	*                         (under the project TAO-TRANSFER);
22	*               2009-2012 (update and modification) Public Research Centre Henri Tudor
23	*                         (under the project TAO-SUSTAIN & TAO-DEV);
24	*               2013 (update and modification) Open Assessment Technologies SA (under the project TAO-PRODUCT);
25	*
26	*/
27
28	/**
29	* Oauth Services based on the TAO DataStore implementation
30	*
31	* @access public
32	* @author Joel Bout, <joel@taotesting.com>
33	* @package tao
34
35	*/
36	interface common_http_SignatureService
37	{
38	/**
39	* Returns the signed version of the request
40	*
41	* @access public
42	* @author Joel Bout, <joel@taotesting.com>
43	* @return common_http_Request
44	*/
45	public function sign(common_http_Request $request, common_http_Credentials $credentials);
46
47	/**
48	* Validates the signature of the current request
49	*
50	* @access protected
51	* @author Joel Bout, <joel@taotesting.com>
52	* @param  common_http_Request request
53	* @throws common_Exception exception thrown if validation fails
54	*/
55	public function validate(common_http_Request $request, common_http_Credentials $credentials = null);
56	}