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) 2016 (original work) Open Assessment Technologies SA;
19	*
20	*/
21
22	namespace oat\taoDelivery\model\authorization;
23
24	use oat\oatbox\user\User;
25	use oat\taoDelivery\model\execution\DeliveryExecutionInterface;
26
27	/**
28	* Provides authorization capabilities.
29	* The provider needs to be contextualized, it answer based on it's current state.
30	*
31	* @author Bertrand Chevrier <bertrand@taotesting.com>
32	*/
33	interface AuthorizationProvider
34	{
35	/**
36	* Verify that a given delivery is allowed to be started
37	*
38	* @param string $deliveryId
39	* @throws \common_exception_Unauthorized
40	*/
41	public function verifyStartAuthorization($deliveryId, User $user);
42
43	/**
44	* Verify that a given delivery execution is allowed to be executed
45	*
46	* @param DeliveryExecutionInterface $deliveryExecution
47	* @param User $user
48	* @throws \common_exception_Unauthorized
49	*/
50	public function verifyResumeAuthorization(DeliveryExecutionInterface $deliveryExecution, User $user);
51	}