Class FileAuthenticator

java.lang.Object

org.deltava.security.FileAuthenticator

All Implemented Interfaces:

Closeable, AutoCloseable, Authenticator

public class FileAuthenticator
extends Object
implements Authenticator

An authenticator to validate users against a file repository. This should typically be used for testing or backup purposes only.

Since:

1.0

Version:

11.1

Author:

Luke

Field Summary

Fields inherited from interface Authenticator

DEFAULT_PROPS_FILE

Constructor Summary

Constructors

Constructor	Description
FileAuthenticator()

Method Summary

Modifier and Type	Method	Description
boolean	accepts(Person usr)	Checks whether this Authenticator will accept a User.
void	add(Person usr, String pwd)	Adds a user to the Directory.
void	authenticate(Person usr, String pwd)	Authenticates the user by searching for the directory name and then comparing the existing password on file to the one specified.
boolean	contains(Person usr)	Checks if a particular name exists in the Directory.
void	disable(Person usr)	Disables a user's account.
void	init(String propsFile)	Create a new File Authenticator and populate its user list from a file.
void	remove(Person usr)	Removes a user from the Directory.
void	rename(Person usr, String newName)	Renames a user in the Directory.
void	updatePassword(Person usr, String pwd)	Updates a user's password.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface Authenticator

close

Constructor Details

FileAuthenticator

public FileAuthenticator()

Method Details

init

public void init(String propsFile)
          throws SecurityException

Create a new File Authenticator and populate its user list from a file. User entries are stored internally in an unsorted Map. This file is comma-delimited with the fields in the following order: FIRSTNAME, LASTNAME, PILOT ID, PASSWORD

Specified by:

init in interface Authenticator

Parameters:

propsFile - the properties file to use

Throws:

SecurityException - if an error occurs

authenticate

public void authenticate(Person usr,
 String pwd)
                  throws SecurityException

Authenticates the user by searching for the directory name and then comparing the existing password on file to the one specified. The DN search is case-insensitive.

Specified by:

authenticate in interface Authenticator

Parameters:

usr - the User bean

pwd - the user's password

Throws:

SecurityException - if authentication fails

See Also:

• Authenticator.authenticate(Person, String)

accepts

public boolean accepts(Person usr)

Checks whether this Authenticator will accept a User. The User must have a non-empty Directory name.

Specified by:

accepts in interface Authenticator

Parameters:

usr - the user bean

Returns:

TRUE if the Directory name is populated, otherwise FALSE

contains

public boolean contains(Person usr)

Checks if a particular name exists in the Directory.

Specified by:

contains in interface Authenticator

Parameters:

usr - the User bean

Returns:

TRUE if the user exists, otherwise FALSE

updatePassword

public void updatePassword(Person usr,
 String pwd)
                    throws SecurityException

Updates a user's password.

Specified by:

updatePassword in interface Authenticator

Parameters:

usr - the User bean

pwd - the user's password

Throws:

SecurityException - if an error occurs

add

public void add(Person usr,
 String pwd)
         throws SecurityException

Adds a user to the Directory.

Specified by:

add in interface Authenticator

Parameters:

usr - the User bean

pwd - the user's password

Throws:

SecurityException - if an error occurs

remove

public void remove(Person usr)
            throws SecurityException

Removes a user from the Directory.

Specified by:

remove in interface Authenticator

Parameters:

usr - the User bean

Throws:

SecurityException - if an error occurs

disable

public void disable(Person usr)
             throws SecurityException

Disables a user's account.

Specified by:

disable in interface Authenticator

Parameters:

usr - the user bean

Throws:

SecurityException - if an error occurs

rename

public void rename(Person usr,
 String newName)
            throws SecurityException

Renames a user in the Directory. NOT IMPLEMENTED

Specified by:

rename in interface Authenticator

Parameters:

usr - the User bean

newName - the new fullly-qualified Directory name

Throws:

UnsupportedOperationException - always

SecurityException - if an error occurs