net.shibboleth.idp.authn.context

Class SubjectContext

java.lang.Object

org.opensaml.messaging.context.BaseContext

net.shibboleth.idp.authn.context.SubjectContext

All Implemented Interfaces:

Iterable<BaseContext>

public class SubjectContext
extends BaseContext

A context that holds information about the subject of a request.

The subject may or may not be authenticated, such as in a back-channel profile, but profiles that operate on subjects can treat the information as "trusted" for their purposes. This context must not be used to carry speculative or unverified subject information.

This is the ultimate product of a successful authentication process.

Parent:

ProfileRequestContext

Added:

After the subject of a request is determined

Nested Class Summary

Nested classes/interfaces inherited from class org.opensaml.messaging.context.BaseContext

BaseContext.ContextSetNoRemoveIteratorDecorator

Field Summary

Fields

Modifier and Type	Field and Description
private Map<String,AuthenticationResult>	authenticationResults The active authentication results for the subject.
private String	principalName Canonical principal name of subject.

Constructor Summary

Constructors

Constructor and Description
SubjectContext() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
Map<String,AuthenticationResult>	getAuthenticationResults() Get a mutable map of authentication flow IDs to authentication results.
String	getPrincipalName() Get the canonical principal name of the subject.
List<Subject>	getSubjects() Get an immutable list of Subjects extracted from every AuthenticationResult associated with the context.
SubjectContext	setPrincipalName(String name) Set the canonical principal name of the subject.

Methods inherited from class org.opensaml.messaging.context.BaseContext

addSubcontext, addSubcontext, clearSubcontexts, containsSubcontext, createSubcontext, getParent, getSubcontext, getSubcontext, getSubcontext, getSubcontext, isAutoCreateSubcontexts, iterator, removeSubcontext, removeSubcontext, setAutoCreateSubcontexts, setParent

Methods inherited from class java.lang.Object

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

Field Detail

principalName

@Nullable
private String principalName

Canonical principal name of subject.

authenticationResults

@Nonnull
@NonnullElements
private final Map<String,AuthenticationResult> authenticationResults

The active authentication results for the subject.

Constructor Detail

SubjectContext

public SubjectContext()

Constructor.

Method Detail

getPrincipalName

@Nullable
public String getPrincipalName()

Get the canonical principal name of the subject.

Returns:

the canonical principal name

setPrincipalName

@Nonnull
public SubjectContext setPrincipalName(@Nullable
                                      String name)

Set the canonical principal name of the subject.

Parameters:

name - the canonical principal name

Returns:

this context

getAuthenticationResults

@Nonnull
@NonnullElements
@Live
public Map<String,AuthenticationResult> getAuthenticationResults()

Get a mutable map of authentication flow IDs to authentication results.

Returns:

mutable map of authentication flow IDs to authentication results

getSubjects

@Nonnull
@NonnullElements
@Unmodifiable
@NotLive
public List<Subject> getSubjects()

Get an immutable list of Subjects extracted from every AuthenticationResult associated with the context.

Returns:

immutable list of Subjects