de.aristaflow.adept2.base.security.callbacks

Class UserSessionIDCallback

java.lang.Object

de.aristaflow.adept2.base.security.callbacks.UserSessionIDCallback

All Implemented Interfaces:

java.io.Serializable, javax.security.auth.callback.Callback

public class UserSessionIDCallback
extends java.lang.Object
implements javax.security.auth.callback.Callback, java.io.Serializable

A callback to retrieve user session IDs when using the combined authentication instead of the normal 2-part authentication. The user session ID is optional, therefore callback handler may ignore this callback or even throw an UnsupportedCallbackException.
Note that this callback may be used together with an OrgPositionChoiceCallback and therefore does not reflect the selection of the organisational position(s). It is not necessary to set a user session ID for all agents of this callback.

Author:

Ulrich Kreher

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.List<QualifiedAgent>	agents The agents for which to retrieve user session IDs.
protected java.util.HashMap<QualifiedAgent,java.lang.String>	sessionIDs The session IDs indexed by the corresponding agent.

Constructor Summary

Constructors

Constructor and Description
UserSessionIDCallback(java.util.List<QualifiedAgent> agents) Creates a new callback for retrieving user session IDs for session tokens for the designated agents.

Method Summary

Modifier and Type	Method and Description
java.util.List<QualifiedAgent>	getAgents() Gets the QualifiedAgents for which to retrieve user session IDs.
java.lang.String	getUserSessionID(QualifiedAgent agent) Gets the user session ID for the designated agent or null if this callback does not provide a user session ID for the agent.
void	setUserSessionID(QualifiedAgent agent, java.lang.String userSessionID) Sets the designated user session ID for the designated agent.

Methods inherited from class java.lang.Object

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

Field Detail

agents

protected final java.util.List<QualifiedAgent> agents

The agents for which to retrieve user session IDs.

sessionIDs

protected final java.util.HashMap<QualifiedAgent,java.lang.String> sessionIDs

The session IDs indexed by the corresponding agent.

Constructor Detail

UserSessionIDCallback

public UserSessionIDCallback(java.util.List<QualifiedAgent> agents)

Creates a new callback for retrieving user session IDs for session tokens for the designated agents.

Parameters:

agents - The agents for which to retrieve user session IDs.

Method Detail

getAgents

public java.util.List<QualifiedAgent> getAgents()

Gets the QualifiedAgents for which to retrieve user session IDs. There need not be a user session ID for all of these agents, especially since this list does not reflect a previous selection of the organisational position(s).

Returns:

The agents for which to retrieve user session IDs.

setUserSessionID

public void setUserSessionID(QualifiedAgent agent,
                             java.lang.String userSessionID)

Sets the designated user session ID for the designated agent. The agent has to be one for which to retrieve a user session ID at all!

Parameters:

agent - The agent for which to set a user session ID.

userSessionID - The user session ID for session tokens for the designated agent.

Throws:

java.lang.IllegalArgumentException - If the designated agent is not one for which this callback tries to retrieve user session IDs, an IllegalArgumentException will be thrown.

getUserSessionID

public java.lang.String getUserSessionID(QualifiedAgent agent)

Gets the user session ID for the designated agent or null if this callback does not provide a user session ID for the agent.

Parameters:

agent - The agent for which to retrieve a user session ID.

Returns:

The user session ID for the designated agent or null if this callback does not provide a user session ID for the agent.