net.shibboleth.idp.session

Interface SessionManager

All Superinterfaces:

net.shibboleth.utilities.java.support.component.Component, net.shibboleth.utilities.java.support.component.DestructableComponent, net.shibboleth.utilities.java.support.component.IdentifiedComponent, net.shibboleth.utilities.java.support.component.InitializableComponent

@ThreadSafe
public interface SessionManager
extends net.shibboleth.utilities.java.support.component.InitializableComponent, net.shibboleth.utilities.java.support.component.DestructableComponent, net.shibboleth.utilities.java.support.component.IdentifiedComponent

Component that manages sessions between the IdP and client devices.

Method Summary

Methods

Modifier and Type	Method and Description
IdPSession	createSession(String principalName) Create and return a new IdPSession object for a subject.
void	destroySession(String sessionId) Invalidates or otherwise removes a session from persistent storage and/or unbinds it from a client.

Methods inherited from interface net.shibboleth.utilities.java.support.component.InitializableComponent

initialize, isInitialized

Methods inherited from interface net.shibboleth.utilities.java.support.component.DestructableComponent

destroy, isDestroyed

Methods inherited from interface net.shibboleth.utilities.java.support.component.IdentifiedComponent

getId

Method Detail

createSession

@Nonnull
IdPSession createSession(@Nonnull@NotEmpty
                               String principalName)
                         throws SessionException

Create and return a new IdPSession object for a subject.

Implementations may perform additional work to persist or associate the session with the client.

Parameters:

principalName - canonical name of the subject of the session

Returns:

the newly created session

Throws:

SessionException - if the session cannot be created

destroySession

void destroySession(@Nonnull@NotEmpty
                  String sessionId)
                    throws SessionException

Invalidates or otherwise removes a session from persistent storage and/or unbinds it from a client.

Parameters:

sessionId - the unique ID of the session to destroy

Throws:

SessionException - if the session cannot be destroyed