{"type":"doc","content":[{"type":"paragraph","content":[{"text":"The predicate bean named ","type":"text"},{"text":"shibboleth.Conditions.Scripted","type":"text","marks":[{"type":"strong"}]},{"text":" executes a JSR-223 scriptlet against a ","type":"text"},{"text":"ProfileRequestContext","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-opensaml.cgi/org.opensaml.profile.context.ProfileRequestContext"}}]},{"text":" to produce a true/false result.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"A Scripted Predicate 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 ","type":"text"},{"text":"javadoc","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-profile.cgi/net.shibboleth.profile.context.logic.ScriptedPredicate"}}]},{"text":" for complete details.","type":"text"}]},{"type":"expand","attrs":{"title":"inlineScript"},"content":[{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n \n \n \n","type":"text"}]}]},{"type":"expand","attrs":{"title":"resourceScript"},"content":[{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Alternative Input Types","type":"text"}]},{"type":"paragraph","content":[{"text":"Most of the conditions used in the IdP configuration tend to be of the signature ","type":"text"},{"text":"Predicate","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.net/cgi-bin/java-jdk.cgi/java/util/function/Predicate"}}]},{"text":"<","type":"text"},{"text":"ProfileRequestContext","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-opensaml.cgi/org.opensaml.profile.context.ProfileRequestContext"}}]},{"text":">, which this bean provides. In some unusual cases, a different input type is used. In such cases, this bean can’t be used, but a Java class that is higher up in the class hierarchy can be substituted instead, ","type":"text"},{"text":"net.shibboleth.shared.logic.ScriptedPredicate","type":"text","marks":[{"type":"link","attrs":{"href":"https://shibboleth.net/cgi-bin/java-shared.cgi/net.shibboleth.shared.logic.ScriptedPredicate"}}]}]},{"type":"paragraph","content":[{"text":"Using this class is essentially the same as using the parent bean except that the bean declaration contains this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"instead of:","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"In addition, adding the property named “inputType” and setting it to a specific class type expected as input will constrain the class and raise an error if an unexpected type is passed into the script.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Reference","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"expand","attrs":{"title":"Bean Properties"},"content":[{"type":"paragraph","content":[{"text":"The following additional bean properties are available:","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"da0b63cf-579c-4fc8-a275-4eae9f270095"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[84.0]},"content":[{"type":"paragraph","content":[{"text":"Type","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[50.0]},"content":[{"type":"paragraph","content":[{"text":"Default","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[507.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"customObject","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[84.0]},"content":[{"type":"paragraph","content":[{"text":"Bean/Reference","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[50.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[507.0]},"content":[{"type":"paragraph","content":[{"text":"An object to make available to the script via a variable named ","type":"text"},{"text":"custom","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"returnOnError","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[84.0]},"content":[{"type":"paragraph","content":[{"text":"boolean","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[50.0]},"content":[{"type":"paragraph","content":[{"text":"false","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[507.0]},"content":[{"type":"paragraph","content":[{"text":"What to return if the script fails","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"hideExceptions","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[84.0]},"content":[{"type":"paragraph","content":[{"text":"boolean","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[50.0]},"content":[{"type":"paragraph","content":[{"text":"false","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[507.0]},"content":[{"type":"paragraph","content":[{"text":"If true, then the ","type":"text"},{"text":"returnOnError","type":"text","marks":[{"type":"code"}]},{"text":" value is returned if the script raises an exception, otherwise the exception is passed out","type":"text"}]}]}]}]}]},{"type":"expand","attrs":{"title":"Script Context"},"content":[{"type":"paragraph","content":[{"text":"The script environment will have two variables populated:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"input","type":"text","marks":[{"type":"code"}]},{"text":" - the ","type":"text"},{"text":"ProfileRequestContext","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-opensaml.cgi/org.opensaml.profile.context.ProfileRequestContext"}}]},{"text":" being evaluated","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"custom","type":"text","marks":[{"type":"code"}]},{"text":" - the object set via the ","type":"text"},{"text":"customObject","type":"text","marks":[{"type":"code"}]},{"text":" property, if any","type":"text"}]}]}]}]},{"type":"paragraph"}],"version":1}