org.apache.sling.commons.auth.spi

Class AuthenticationInfo

java.lang.Object

java.util.AbstractMap<K,V>

java.util.HashMap<java.lang.String,java.lang.Object>

org.apache.sling.commons.auth.spi.AuthenticationInfo

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.util.Map<java.lang.String,java.lang.Object>

public class AuthenticationInfo
extends java.util.HashMap<java.lang.String,java.lang.Object>

The AuthenticationInfo conveys any authentication credentials and/or details extracted by the AuthenticationHandler.extractCredentials(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse) method from the request.

AuthenticationHandler implementations must return instances of this class which may be constructed through any of the provided public constructors.

Internally all values are stored in the map where some property names have special semantics and the data type of the properties are ensured by the put(String, Object) method implementation.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.util.AbstractMap

java.util.AbstractMap.SimpleEntry<K,V>, java.util.AbstractMap.SimpleImmutableEntry<K,V>

Nested classes/interfaces inherited from interface java.util.Map

java.util.Map.Entry<K,V>

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	AUTH_TYPE The name of the special property providing the authentication type provided by the AuthenticationHandler.
static java.lang.String	CREDENTIALS The name of the property providing the JCR credentials.
static AuthenticationInfo	DOING_AUTH A special instance of this class which may be returned from the AuthenticationHandler.extractCredentials(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse) method to inform the caller, that a response has been sent to the client to request for credentials.
static AuthenticationInfo	FAIL_AUTH A special instance of this class which may be returned from the AuthenticationHandler.extractCredentials(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse) method to inform the caller that credential extraction failed for some reason.
static java.lang.String	PASSWORD The name of the property providing the password of the user on whose behalf the request is being handled.
static java.lang.String	USER The name of the property providing the name of the user on whose behalf the request is being handled.

Constructor Summary

Constructors

Constructor and Description
AuthenticationInfo(java.lang.String authType) Creates an instance of this class with just the authentication type.
AuthenticationInfo(java.lang.String authType, java.lang.String userId) Creates an instance of this class authenticating with the given type and userid.
AuthenticationInfo(java.lang.String authType, java.lang.String userId, char[] password) Creates an instance of this class authenticating with the given type and userid/password connecting.

Method Summary

Modifier and Type	Method and Description
void	clear() Clears all properties from the map with the exception of the AUTH_TYPE property.
java.lang.String	getAuthType() Returns the authentication type stored as the AUTH_TYPE property in this map.
char[]	getPassword() Returns the password stored as the PASSWORD property or null if the password is not set in this map.
java.lang.String	getUser() Returns the user name stored as the USER property or null if the user is not set in this map.
java.lang.Object	put(java.lang.String key, java.lang.Object value) Sets or resets a property with the given key to a new value.
java.lang.Object	remove(java.lang.Object key) Removes the entry with the given key and returns its former value (if existing).
void	setAuthType(java.lang.String authType)
void	setPassword(char[] password)
void	setUser(java.lang.String user)

Methods inherited from class java.util.HashMap

clone, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, forEach, get, getOrDefault, isEmpty, keySet, merge, putAll, putIfAbsent, remove, replace, replace, replaceAll, size, values

Methods inherited from class java.util.AbstractMap

equals, hashCode, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map

equals, hashCode

Field Detail

DOING_AUTH

public static final AuthenticationInfo DOING_AUTH

A special instance of this class which may be returned from the AuthenticationHandler.extractCredentials(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse) method to inform the caller, that a response has been sent to the client to request for credentials.

If this value is returned, the request should be considered finished and no further actions should be taken on this request.

FAIL_AUTH

public static final AuthenticationInfo FAIL_AUTH

A special instance of this class which may be returned from the AuthenticationHandler.extractCredentials(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse) method to inform the caller that credential extraction failed for some reason.

If this value is returned, the handler signals that credentials would be present in the request but the credentials are not valid for use (for example OpenID identify failed to validate or some authentication cookie expired).

AUTH_TYPE

public static final java.lang.String AUTH_TYPE

The name of the special property providing the authentication type provided by the AuthenticationHandler. This value must be supplied to one of the constructors and is ultimately used as the value of the HttpServletRequest.getAuthType method.

This property is always present (and cannot be removed) in this map and is of String type.

See Also:

Constant Field Values

USER

public static final java.lang.String USER

The name of the property providing the name of the user on whose behalf the request is being handled. This property is set by the AuthenticationInfo(String, String, char[]) constructor and may be null if this instance is created by either the AuthenticationInfo(String, String) or AuthenticationInfo(String, String, char[]) constructors.

The type of this property, if present, is String.

See Also:

Constant Field Values

PASSWORD

public static final java.lang.String PASSWORD

The name of the property providing the password of the user on whose behalf the request is being handled. This property is set by the AuthenticationInfo(String, String, char[]) constructor and may be null if this instance is created by either the AuthenticationInfo(String, String) or AuthenticationInfo(String, String, char[]) constructors.

The type of this property, if present, is char[].

See Also:

Constant Field Values

CREDENTIALS

public static final java.lang.String CREDENTIALS

The name of the property providing the JCR credentials. These credentials are preset to the credentials given to the AuthenticationInfo(String, String) or AuthenticationInfo(String, String, char[]) constructors. is used the credentials property is set to a JCR SimpleCredentials instance containing the user id and password passed to the constructor.

See Also:

Constant Field Values

Constructor Detail

AuthenticationInfo

public AuthenticationInfo(java.lang.String authType)

Creates an instance of this class with just the authentication type. To effectively use this instance the user Id with optional password and/or the credentials should be set.

Parameters:

authType - The authentication type, must not be null.

AuthenticationInfo

public AuthenticationInfo(java.lang.String authType,
                          java.lang.String userId)

Creates an instance of this class authenticating with the given type and userid.

Parameters:

authType - The authentication type, must not be null.

userId - The name of the user to authenticate as. This may be null for the constructor and later be set.

Throws:

java.lang.NullPointerException - if authType is null.

AuthenticationInfo

public AuthenticationInfo(java.lang.String authType,
                          java.lang.String userId,
                          char[] password)

Creates an instance of this class authenticating with the given type and userid/password connecting.

Parameters:

authType - The authentication type, must not be null.

userId - The name of the user to authenticate as. This may be null for the constructor and later be set.

password - The password to authenticate with or null if no password can be supplied.

Throws:

java.lang.NullPointerException - if authType is null.

Method Detail

setAuthType

public final void setAuthType(java.lang.String authType)

Parameters:

authType - The authentication type to set. If this is null the current authentication type is not replaced.

getAuthType

public final java.lang.String getAuthType()

Returns the authentication type stored as the AUTH_TYPE property in this map. This value is expected to never be null.

If authentication is taking place through one of the standard ways, such as Basic or Digest, the return value is one of the predefined constants of the HttpServletRequest interface. Otherwise the value may be specific to the AuthenticationHandler implementation.

setUser

public final void setUser(java.lang.String user)

Parameters:

user - The name of the user to authenticate as. If this is null the current user name is not replaced.

getUser

public final java.lang.String getUser()

Returns the user name stored as the USER property or null if the user is not set in this map.

setPassword

public final void setPassword(char[] password)

Parameters:

password - The password to authenticate with. If this is null the current password is not replaced.

getPassword

public final char[] getPassword()

Returns the password stored as the PASSWORD property or null if the password is not set in this map.

put

public java.lang.Object put(java.lang.String key,
                            java.lang.Object value)

Sets or resets a property with the given key to a new value. Some keys have special meanings and their values are required to have predefined as listed in the following table:

AUTH_TYPE	String
USER	String
PASSWORD	char[]
CREDENTIALS	javax.jcr.Credentials

If the value for the special key does not match the required type an IllegalArgumentException is thrown.

Specified by:

put in interface java.util.Map<java.lang.String,java.lang.Object>

Overrides:

put in class java.util.HashMap<java.lang.String,java.lang.Object>

Parameters:

key - The name of the property to set

value - The value of the property which must be of a special type if the key designates one of the predefined properties.

Returns:

The value previously set for the given key.

Throws:

java.lang.IllegalArgumentException - if key designates one of the special properties and the value does not have the correct type for the respective key.

remove

public java.lang.Object remove(java.lang.Object key)

Removes the entry with the given key and returns its former value (if existing). If the key is AUTH_TYPE the value is not actually removed and null is always returned.

Specified by:

remove in interface java.util.Map<java.lang.String,java.lang.Object>

Overrides:

remove in class java.util.HashMap<java.lang.String,java.lang.Object>

Parameters:

key - Removes the value associated with this key.

Returns:

The former value associated with the key.

clear

public void clear()

Clears all properties from the map with the exception of the AUTH_TYPE property.

Specified by:

clear in interface java.util.Map<java.lang.String,java.lang.Object>

Overrides:

clear in class java.util.HashMap<java.lang.String,java.lang.Object>