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) 2020 (original work) (update and modification) Open Assessment Technologies SA
19	*                    (under the project TAO-PRODUCT)
20	*/
21
22	declare(strict_types=1);
23
24	namespace oat\tao\model\oauth\lockout;
25
26	/**
27	* Checks if the OAuth Session should be locked or not
28	*
29	* @package oat\tao\model\oauth\lockout
30	*/
31	interface LockoutInterface
32	{
33	/**
34	* Store the data about current session and failed attempts
35	* to get possibility to analyze and make decision about locking
36	* based on stored data
37	*
38	* @return void
39	*/
40	public function logFailedAttempt(): void;
41
42	/**
43	* Checks if current session is allowed based on previous failed attempts
44	*
45	* @return bool
46	*/
47	public function isAllowed(): bool;
48	}