1 /* 2 * Copyright (c) 2002-2021, City of Paris 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * 9 * 1. Redistributions of source code must retain the above copyright notice 10 * and the following disclaimer. 11 * 12 * 2. Redistributions in binary form must reproduce the above copyright notice 13 * and the following disclaimer in the documentation and/or other materials 14 * provided with the distribution. 15 * 16 * 3. Neither the name of 'Mairie de Paris' nor 'Lutece' nor the names of its 17 * contributors may be used to endorse or promote products derived from 18 * this software without specific prior written permission. 19 * 20 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 21 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 22 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 23 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE 24 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 25 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 26 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 27 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 28 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 29 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 30 * POSSIBILITY OF SUCH DAMAGE. 31 * 32 * License 1.0 33 */ 34 package fr.paris.lutece.plugins.mylutece.authentication.logs; 35 36 import fr.paris.lutece.portal.service.plugin.Plugin; 37 38 import java.sql.Timestamp; 39 40 /** 41 * 42 * @author lenaini 43 */ 44 public interface IConnectionLogDAO 45 { 46 /** 47 * Insert a new record in the table of connections 48 * 49 * @param connectionLog 50 * the ConnectionLog Object 51 * @param plugin 52 * The plugin 53 */ 54 void insertLog( ConnectionLog connectionLog, Plugin plugin ); 55 56 /** 57 * Calculate the number of connections with a given ip_address by a determinate time 58 * 59 * @param connectionLog 60 * The Log of connection 61 * @param nIntervalMinutes 62 * The number of minutes since the last connection 63 * @param plugin 64 * The plugin 65 * @return int The number of loggin error during the last <i>nIntervalMinutes</i> minutes 66 */ 67 int selectLoginErrors( ConnectionLog connectionLog, int nIntervalMinutes, Plugin plugin ); 68 69 /** 70 * Update connection logs of an IP to allow the user to login. 71 * 72 * @param strIp 73 * Ip to clean 74 * @param dateLogin 75 * Date of the last login. Anly logs between this date plus or minus the minute interval will be cleared. 76 * @param nIntervalMinutes 77 * Minutes interval 78 * @param plugin 79 * The plugin 80 */ 81 void resetConnectionLogs( String strIp, Timestamp dateLogin, int nIntervalMinutes, Plugin plugin ); 82 }