The Shibboleth IdP V4 software has reached its End of Life and is no longer supported. This documentation is available for historical purposes only. See the IDP5 wiki space for current documentation on the supported version.

ScriptedBiPredicate

The predicate bean named shibboleth.BiConditions.Scripted executes a JSR-223 scriptlet against 2 arbitrary inputs to produce a true/false result.

Configuration

A Scripted BiPredicate is instantiated using one of two static factory methods (rather than created directly by invoking a Java constructor), so they have a different syntax in Spring. You can refer to the javadoc for complete details.

If provided with one parameter, this is the script to be executed. If two parameters are the provided, then the first is the name of the (installed) JSR-223 lanuage and the second is the script.

<bean id="MyCondition" parent="shibboleth.BiConditions.Scripted" factory-method="inlineScript" p:customObject-ref="MyCustomObject" p:hideExceptions="true"> <constructor-arg> <value> <![CDATA[ // Your script here true; ]]> </value> </constructor-arg> </bean>

If provided with one parameter this is the location (usually the file name) of the resource (file) containing the script. If two parameters are provided, the the first is the name of the (installed) JSR-223 lanuage and the second is the location.

<bean id="MyCondition" parent="shibboleth.BiConditions.Scripted" factory-method="resourceScript" c:_0="javascript" c:_1="%{idp.home}/conf/script.js"/>

Reference

The following additional bean properties are available:

Name

Type

Default

Description

Name

Type

Default

Description

customObject

Bean/Reference



An object to make available to the script via a variable named custom

inputTypes

Pair<Class<?>,Class<?>>



Allows type checking of the inputs

returnOnError

boolean

false

What to return if the script fails

hideExceptions

boolean

false

If true, then the returnOnError value is returned if the script raises an exception, otherwise the exception is passed out

The script environment will have these variables populated:

  • input1 - the first input

  • input2 - the second input

  • custom - the object set via the customObject property, if any

Â