net.shibboleth.idp.attribute.resolver.dc.impl

Class ScriptedDataConnector

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<Map<String,IdPAttribute>>

net.shibboleth.idp.attribute.resolver.AbstractDataConnector

net.shibboleth.idp.attribute.resolver.dc.impl.ScriptedDataConnector

All Implemented Interfaces:

DataConnector, DataConnectorEx, ResolverPlugin<Map<String,IdPAttribute>>, Component, DestructableComponent, IdentifiableComponent, IdentifiedComponent, InitializableComponent, UnmodifiableComponent, org.springframework.beans.factory.DisposableBean

public class ScriptedDataConnector
extends AbstractDataConnector

A Data Connector which populates a series of attributes from a provided ProfileRequestContext.

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.
static String	RESULTS_STRING The id of the object where the results go.
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
ScriptedDataConnector() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
private Map<String,IdPAttribute>	buildResult(ScriptContext context) Given the Script context we extract the attribute list and then (very carefully) construct the results map.
private void	checkValues(IdPAttribute attribute) Ensure that all the values in the attribute are of the correct type.
protected Map<String,IdPAttribute>	doDataConnectorResolve(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.AbstractDataConnector

doResolve, getFailoverDataConnectorId, getLastFail, getLogPrefix, getNoRetryDelay, setFailoverDataConnectorId, setLastFail, setNoRetryDelay

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

RESULTS_STRING

@Nonnull
public static final String RESULTS_STRING

The id of the object where the results go.

See Also:

Constant Field Values

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

ScriptedDataConnector

public ScriptedDataConnector()

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 AbstractDataConnector

Throws:

ComponentInitializationException

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

checkValues

private void checkValues(IdPAttribute attribute)

Ensure that all the values in the attribute are of the correct type.

Parameters:

attribute - the attribute to look at

buildResult

private Map<String,IdPAttribute> buildResult(ScriptContext context)
                                      throws ResolutionException

Given the Script context we extract the attribute list and then (very carefully) construct the results map.

Parameters:

context - the Scripting context. We know that there is a variable inside called RESULTS_STRING.

Returns:

the map of attributesids to attributes.

Throws:

ResolutionException - if the output was "wrong".

doDataConnectorResolve

@Nullable
protected Map<String,IdPAttribute> doDataConnectorResolve(@Nonnull
                                                       AttributeResolutionContext resolutionContext,
                                                       @Nonnull
                                                       AttributeResolverWorkContext workContext)
                                                   throws ResolutionException

Specified by:

doDataConnectorResolve in class AbstractDataConnector

Throws:

ResolutionException