net.shibboleth.idp.attribute.resolver.ad.impl

Class ScriptedAttributeDefinition

java.lang.Object

net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

net.shibboleth.utilities.java.support.component.AbstractIdentifiedInitializableComponent

net.shibboleth.utilities.java.support.component.AbstractIdentifiableInitializableComponent

net.shibboleth.idp.attribute.resolver.AbstractResolverPlugin<IdPAttribute>

net.shibboleth.idp.attribute.resolver.AbstractAttributeDefinition

net.shibboleth.idp.attribute.resolver.ad.impl.ScriptedAttributeDefinition

All Implemented Interfaces:

AttributeDefinition, ResolverPlugin<IdPAttribute>, Component, DestructableComponent, IdentifiableComponent, IdentifiedComponent, InitializableComponent, UnmodifiableComponent, org.springframework.beans.factory.DisposableBean

@ThreadSafe
public class ScriptedAttributeDefinition
extends AbstractAttributeDefinition

An AttributeDefinition that executes a script in order to populate the values of the generated attribute.

The evaluated script has access to the following information:

• A script attribute whose name is the ID of this attribute definition and whose value is a newly constructed IdPAttribute.
• A script attribute whose name is context and whose value is the current AttributeResolutionContext
• A script attribute for every attribute produced by the dependencies of this attribute definition. The name of the script attribute is the ID of the IdPAttribute and its value is the List of IdPAttributeValue for the attribute.

The evaluated script should populate the values of the newly constructed IdPAttribute mentioned above. No other information from the script will be taken in to account.

Field Summary

Fields

Modifier and Type	Field and Description
private Object	customObject The custom object we inject into all scripts.
private org.slf4j.Logger	log Class logger.
private Function<AttributeResolutionContext,org.opensaml.profile.context.ProfileRequestContext>	prcLookupStrategy Strategy used to locate the ProfileRequestContext to use.
private Function<org.opensaml.profile.context.ProfileRequestContext,SubjectContext>	scLookupStrategy Strategy used to locate the SubjectContext to use.
private EvaluableScript	script Script to be evaluated.

Constructor Summary

Constructors

Constructor and Description
ScriptedAttributeDefinition() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected IdPAttribute	doAttributeDefinitionResolve(AttributeResolutionContext resolutionContext, AttributeResolverWorkContext workContext)
protected void	doInitialize()
Object	getCustomObject() Return the custom (externally provided) object.
EvaluableScript	getScript() Gets the script to be evaluated.
private ScriptContext	getScriptContext(AttributeResolutionContext resolutionContext, AttributeResolverWorkContext workContext) Constructs the ScriptContext used when evaluating the script.
void	setCustomObject(Object object) Set the custom (externally provided) object.
void	setProfileRequestContextLookupStrategy(Function<AttributeResolutionContext,org.opensaml.profile.context.ProfileRequestContext> strategy) Set the strategy used to locate the ProfileRequestContext associated with a given AttributeResolutionContext.
void	setScript(EvaluableScript definitionScript) Sets the script to be evaluated.
void	setSubjectContextLookupStrategy(Function<org.opensaml.profile.context.ProfileRequestContext,SubjectContext> strategy) Set the strategy used to locate the SubjectContext associated with a given AttributeResolutionContext.

Methods inherited from class net.shibboleth.idp.attribute.resolver.AbstractAttributeDefinition

doResolve, getAttributeEncoders, getDisplayDescriptions, getDisplayNames, getLogPrefix, getSourceAttributeId, isDependencyOnly, setAttributeEncoders, setDependencyOnly, setDisplayDescriptions, setDisplayNames, setSourceAttributeId

Methods inherited from class net.shibboleth.idp.attribute.resolver.AbstractResolverPlugin

doDestroy, equals, getActivationCondition, getDependencies, getProfileContextStrategy, hashCode, isPropagateResolutionExceptions, resolve, setActivationCondition, setDependencies, setProfileContextStrategy, setPropagateResolutionExceptions

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractIdentifiableInitializableComponent

setId

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractIdentifiedInitializableComponent

getId

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

destroy, initialize, isDestroyed, isInitialized

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.shibboleth.idp.attribute.resolver.ResolverPlugin

getActivationCondition, getDependencies, isPropagateResolutionExceptions, resolve

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

Methods inherited from interface org.springframework.beans.factory.DisposableBean

destroy

Field Detail

log

@Nonnull
private final org.slf4j.Logger log

Class logger.

script

@NonnullAfterInit
private EvaluableScript script

Script to be evaluated.

prcLookupStrategy

@Nonnull
private Function<AttributeResolutionContext,org.opensaml.profile.context.ProfileRequestContext> prcLookupStrategy

Strategy used to locate the ProfileRequestContext to use.

scLookupStrategy

@Nonnull
private Function<org.opensaml.profile.context.ProfileRequestContext,SubjectContext> scLookupStrategy

Strategy used to locate the SubjectContext to use.

customObject

@Nullable
private Object customObject

The custom object we inject into all scripts.

Constructor Detail

ScriptedAttributeDefinition

public ScriptedAttributeDefinition()

Constructor.

Method Detail

getCustomObject

@Nullable
public Object getCustomObject()

Return the custom (externally provided) object.

Returns:

the custom object

setCustomObject

@Nullable
public void setCustomObject(Object object)

Set the custom (externally provided) object.

Parameters:

object - the custom object

getScript

@NonnullAfterInit
public EvaluableScript getScript()

Gets the script to be evaluated.

Returns:

the script to be evaluated

setScript

public void setScript(@Nonnull
             EvaluableScript definitionScript)

Sets the script to be evaluated.

Parameters:

definitionScript - the script to be evaluated

setProfileRequestContextLookupStrategy

public void setProfileRequestContextLookupStrategy(@Nonnull
                                          Function<AttributeResolutionContext,org.opensaml.profile.context.ProfileRequestContext> strategy)

Set the strategy used to locate the ProfileRequestContext associated with a given AttributeResolutionContext.

Parameters:

strategy - strategy used to locate the ProfileRequestContext associated with a given AttributeResolutionContext

setSubjectContextLookupStrategy

public void setSubjectContextLookupStrategy(@Nonnull
                                   Function<org.opensaml.profile.context.ProfileRequestContext,SubjectContext> strategy)

Set the strategy used to locate the SubjectContext associated with a given AttributeResolutionContext.

Parameters:

strategy - strategy used to locate the SubjectContext associated with a given AttributeResolutionContext

doInitialize

protected void doInitialize()
                     throws ComponentInitializationException

Overrides:

doInitialize in class AbstractAttributeDefinition

Throws:

ComponentInitializationException

doAttributeDefinitionResolve

@Nullable
protected IdPAttribute doAttributeDefinitionResolve(@Nonnull
                                                 AttributeResolutionContext resolutionContext,
                                                 @Nonnull
                                                 AttributeResolverWorkContext workContext)
                                             throws ResolutionException

Specified by:

doAttributeDefinitionResolve in class AbstractAttributeDefinition

Throws:

ResolutionException

getScriptContext

@Nonnull
private ScriptContext getScriptContext(@Nonnull
                                     AttributeResolutionContext resolutionContext,
                                     @Nonnull
                                     AttributeResolverWorkContext workContext)
                                throws ResolutionException

Constructs the ScriptContext used when evaluating the script.

Parameters:

resolutionContext - current resolution context

workContext - current work context

Returns:

constructed script context

Throws:

ResolutionException - thrown if dependent data connectors or attribute definitions can not be resolved