{"type":"doc","content":[{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"This feature requires V4.1 and later.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Namespace: ","type":"text","marks":[{"type":"strong"}]},{"text":"urn:mace:shibboleth:2.0:resolver","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Schema: ","type":"text","marks":[{"type":"strong"}]},{"text":"http://shibboleth.net/schema/idp/shibboleth-attribute-resolver.xsd","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/schema/idp/shibboleth-attribute-resolver.xsd"}}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"102881c1-0a80-4f65-8c36-b45d92eac9bc"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"cfdedc4f-5f6b-43b6-9129-2b54dbe2a6ef"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"StorageService","type":"text","marks":[{"type":"code"}]},{"text":" DataConnector generates results from a query against the IdP's ","type":"text"},{"text":"StorageService","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-opensaml.cgi/org.opensaml.storage.StorageService"}}]},{"text":" API (see also ","type":"text"},{"text":"StorageConfiguration","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631707"}}]},{"text":"). It's main value is in prototyping certain features that require persistent storage without the need for new code, and because the IdP includes an in-memory service by default, it's easy to use for testing with no extra configuration.","type":"text"}]},{"type":"paragraph","content":[{"text":"The interface to storage relies on lookup of a single record at a time, but the data connector also allows scriptable response handling that can parse the content of a storage record into multiple results, if the record is in a parseable form such as JSON.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"General Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"The connector marries three essential pieces of configuration to be supplied by the deployer:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a ","type":"text"},{"text":"StorageService","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-opensaml.cgi/org.opensaml.storage.StorageService"}}]},{"text":" bean","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the two-part record lookup criteria (known as \"context\" and \"key\" in the storage model)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"response processing","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The lookup criteria are produced by evaluation of a pair of Velocity templates supplied with the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" elements.","type":"text"}]},{"type":"paragraph","content":[{"text":"The two supplied response processing implementations consist of:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A simple mechanism that exposes the entire record content as a single attribute (configured with the ","type":"text"},{"text":"generatedAttributeID","type":"text","marks":[{"type":"code"}]},{"text":" setting to name the attribute).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A more complex approach using the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element to supply a script to produce attribute data from the record arbitrarily.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"At minimum, a ","type":"text"},{"text":"storageServiceRef","type":"text","marks":[{"type":"code"}]},{"text":" attribute must be supplied to provide the ","type":"text"},{"text":"StorageService","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-opensaml.cgi/org.opensaml.storage.StorageService"}}]},{"text":" to use.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Context/Key Template Contexts","type":"text"}]},{"type":"paragraph","content":[{"text":"Several variables are available in the two template contexts. In practice, ","type":"text"},{"text":"$resolutionContext.principal","type":"text","marks":[{"type":"code"}]},{"text":" and various named dependent attributes (if any) tend to be most useful.","type":"text"}]},{"type":"table","attrs":{"layout":"wide","localId":"0f1e190e-4d8c-40d5-a082-ffa52717db90"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[205.0]},"content":[{"type":"paragraph","content":[{"text":"Type","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[621.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.0]},"content":[{"type":"paragraph","content":[{"text":"resolutionContext","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[205.0]},"content":[{"type":"paragraph","content":[{"text":"AttributeResolutionContext","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.attribute.resolver.context.AttributeResolutionContext"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[621.0]},"content":[{"type":"paragraph","content":[{"text":"Commonly useful members include ","type":"text"},{"text":"$resolutionContext.principal","type":"text","marks":[{"type":"code"}]},{"text":" and","type":"text"},{"text":" $resolutionContext.attributeRecipientID","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.0]},"content":[{"type":"paragraph","content":[{"text":"custom","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[205.0]},"content":[{"type":"paragraph","content":[{"text":"Object","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[621.0]},"content":[{"type":"paragraph","content":[{"text":"Optional object injected via ","type":"text"},{"text":"customObjectRef","type":"text","marks":[{"type":"code"}]},{"text":" attribute","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.0]},"content":[{"type":"paragraph","content":[{"text":"foo, bar, etc.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[205.0]},"content":[{"type":"paragraph","content":[{"text":"List","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.util.List"}}]},{"text":"<","type":"text"},{"text":"IdPAttributeValue","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.attribute.IdPAttributeValue"}}]},{"text":">","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[621.0]},"content":[{"type":"paragraph","content":[{"text":"For each ","type":"text"},{"text":"IdPAttribute","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.attribute.IdPAttribute"}}]},{"text":" available from all the provided dependencies, the attributes' values are available as a collection under the attribute's name.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"Any examples here omit the Spring beans that define the ","type":"text"},{"text":"StorageService","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-opensaml.cgi/org.opensaml.storage.StorageService"}}]},{"text":" to use. This service may be one used for other purposes within the IdP, or may be defined specifically for this purpose.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n\torg.example\n\t$resolutionContext.principal\n\t\n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Reference","type":"text"}]},{"type":"expand","attrs":{"title":"Specific XML Attributes"},"content":[{"type":"paragraph","content":[{"text":"The only required attribute is ","type":"text"},{"text":"storageServiceRef","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"3c340ae1-58a5-469f-9b67-1db11168e519"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"Type","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"Default","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[519.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"storageServiceRef","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[519.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID of the ","type":"text"},{"text":"StorageService","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-opensaml.cgi/org.opensaml.storage.StorageService"}}]},{"text":" instance to use","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"generatedAttributeID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[519.0]},"content":[{"type":"paragraph","content":[{"text":"Name of attribute to populate with the entire storage record value. Mutually exclusive with the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"noResultIsError","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"Boolean","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"false","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[519.0]},"content":[{"type":"paragraph","content":[{"text":"When true, failure to find a matching record produces a resolution exception instead of no result","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"customObjectRef","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[519.0]},"content":[{"type":"paragraph","content":[{"text":"Injected into context and key template generation as $custom variable","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"mappingStrategyRef","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[519.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID of a ","type":"text"},{"text":"StorageMappingStrategy","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.attribute.resolver.dc.storage.StorageMappingStrategy"}}]},{"text":" to process the result set in a pluggable way","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"executableSearchBuilderRef","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[519.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID of an ","type":"text"},{"text":"ExecutableSearchBuilder","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.attribute.resolver.dc.impl.ExecutableSearchBuilder"}}]},{"text":"<","type":"text"},{"text":"StorageServiceSearch","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.attribute.resolver.dc.storage.StorageServiceSearch"}}]},{"text":"> to produce the request to execute","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"templateEngine","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[519.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID of a ","type":"text"},{"text":"org.apache.velocity.app.VelocityEngine","type":"text","marks":[{"type":"link","attrs":{"href":"https://velocity.apache.org/engine/releases/velocity-1.5/apidocs/org/apache/velocity/app/VelocityEngine.html"}}]},{"text":" to use for processing the URL template, generally unnecessary","type":"text"}]}]}]}]}]},{"type":"expand","attrs":{"title":"Specific XML Elements"},"content":[{"type":"table","attrs":{"layout":"full-width","localId":"31263e83-81b4-4882-99d1-f03b5ed78525"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[122.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[69.0]},"content":[{"type":"paragraph","content":[{"text":"Cardinality","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[566.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[122.0]},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[69.0]},"content":[{"type":"paragraph","content":[{"text":"0 or 1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[566.0]},"content":[{"type":"paragraph","content":[{"text":"Velocity template producing the storage context to query","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[122.0]},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[69.0]},"content":[{"type":"paragraph","content":[{"text":"0 or 1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[566.0]},"content":[{"type":"paragraph","content":[{"text":"Velocity template producing the storage key to query","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[122.0]},"content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"RecordMapping","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1294074565"}}]},{"text":">","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[69.0]},"content":[{"type":"paragraph","content":[{"text":"0 or 1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[566.0]},"content":[{"type":"paragraph","content":[{"text":"Inline or external script to execute to process the response body","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[122.0]},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631585"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":2,"colwidth":[69.0]},"content":[{"type":"paragraph"},{"type":"paragraph","content":[{"text":"0 or 1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[566.0]},"content":[{"type":"paragraph","content":[{"text":"Defines how results should be cached.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[122.0]},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[566.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID (in the element content) defining how results should be cached as an externally defined ","type":"text"},{"text":"com.google.common.cache.Cache","type":"text","marks":[{"type":"link","attrs":{"href":"http://docs.guava-libraries.googlecode.com/git/javadoc/com/google/common/cache/Cache.html"}}]},{"text":"<","type":"text"},{"text":"String","type":"text","marks":[{"type":"link","attrs":{"href":"http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true"}}]},{"text":",","type":"text"},{"text":"Map","type":"text","marks":[{"type":"link","attrs":{"href":"http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true"}}]},{"text":"<","type":"text"},{"text":"String","type":"text","marks":[{"type":"link","attrs":{"href":"http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true"}}]},{"text":",","type":"text"},{"text":"IdPAttribute","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net/shibboleth/idp/attribute/IdPAttribute"}}]},{"text":">> ","type":"text"}]}]}]}]}]},{"type":"expand","attrs":{"title":"Common XML Attributes"},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"include","parameters":{"macroParams":{"":{"value":"DataConnectorCommonAttributes"}},"macroMetadata":{"macroId":{"value":"2835e978-4151-4b85-86a4-d747f3a2f33d"},"schemaVersion":{"value":"1"},"title":"Include Page"}},"localId":"c59dfc3c-7a01-45b0-b796-73cd6a03694a"}}]},{"type":"expand","attrs":{"title":"Common XML Elements"},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"include","parameters":{"macroParams":{"":{"value":"DataConnectorCommonChildElements"}},"macroMetadata":{"macroId":{"value":"0bf02b92-220a-4ba0-9c4a-60a27228c0c4"},"schemaVersion":{"value":"1"},"title":"Include Page"}},"localId":"df9f32b2-4fc9-4b23-a3e1-342b300e6a7b"}}]},{"type":"expand","attrs":{"title":"Properties"},"marks":[{"type":"breakout","attrs":{"mode":"full-width"}}],"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"include","parameters":{"macroParams":{"":{"value":"VelocityTemplateProperties"}},"macroMetadata":{"macroId":{"value":"665ff6d3288b1fea2bc6f436494877d1"},"schemaVersion":{"value":"1"},"title":"Include Page"}},"localId":"5a03dba1-59a1-40d6-b287-c8a96b317fcf"}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Spring Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"If the ","type":"text"},{"text":"springResource","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"springResourceRef","type":"text","marks":[{"type":"code"}]},{"text":" attributes are specified, then the configuration of the DataConnector bean is partially delegated to the supplied resources. The system will create a factory for a ","type":"text"},{"text":"StorageServiceDataConnector","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net/shibboleth/idp/attribute/resolver/dc/storage/impl/StorageServiceDataConnector"}}]},{"text":" object, and look for beans in the Spring resource(s) supplied that match the types of properties supported by that type and its parent classes.","type":"text"}]},{"type":"paragraph","content":[{"text":"The connector may be supplied with beans of the following types:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ExecutableSearchBuilder","type":"text","marks":[{"type":"textColor","attrs":{"color":"#353833"}},{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.attribute.resolver.dc.impl.ExecutableSearchBuilder"}}]},{"text":"<","type":"text","marks":[{"type":"textColor","attrs":{"color":"#353833"}},{"type":"link","attrs":{"href":"/wiki/pages/resumedraft.action?draftId=1294074561"}}]},{"text":"StorageServiceSearch","type":"text","marks":[{"type":"textColor","attrs":{"color":"#353833"}},{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.attribute.resolver.dc.storage.StorageServiceSearch"}}]},{"text":">","type":"text","marks":[{"type":"textColor","attrs":{"color":"#353833"}},{"type":"link","attrs":{"href":"/wiki/pages/resumedraft.action?draftId=1294074561"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"com.google.common.cache.Cache","type":"text","marks":[{"type":"textColor","attrs":{"color":"#353833"}},{"type":"link","attrs":{"href":"http://docs.guava-libraries.googlecode.com/git/javadoc/com/google/common/cache/Cache.html"}}]},{"text":"<","type":"text","marks":[{"type":"textColor","attrs":{"color":"#353833"}}]},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#353833"}},{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.lang.String"}}]},{"text":",","type":"text","marks":[{"type":"textColor","attrs":{"color":"#353833"}}]},{"text":"Map","type":"text","marks":[{"type":"textColor","attrs":{"color":"#353833"}},{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.util.Map"}}]},{"text":"<","type":"text","marks":[{"type":"textColor","attrs":{"color":"#353833"}}]},{"text":"String","type":"text","marks":[{"type":"textColor","attrs":{"color":"#353833"}},{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.lang.String"}}]},{"text":",","type":"text","marks":[{"type":"textColor","attrs":{"color":"#353833"}}]},{"text":"IdPAttribute","type":"text","marks":[{"type":"textColor","attrs":{"color":"#353833"}},{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net/shibboleth/idp/attribute/IdPAttribute"}}]},{"text":">>","type":"text","marks":[{"type":"textColor","attrs":{"color":"#353833"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"StorageMappingStrategy","type":"text","marks":[{"type":"textColor","attrs":{"color":"#353833"}},{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.attribute.resolver.dc.storage.StorageMappingStrategy"}}]}]}]}]},{"type":"paragraph","content":[{"text":"In addition native bean IDs can be injected as follows:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#353833"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"StorageService","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-opensaml.cgi/org.opensaml.storage.StorageService"}}]},{"text":" instance is injected via the ","type":"text"},{"text":"storageServiceRef","type":"text","marks":[{"type":"code"}]},{"text":" attribute.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The builder for the query can be specified as an externally defined bean via the ","type":"text"},{"text":"executableSearchBuilderRef","type":"text","marks":[{"type":"code"}]},{"text":" attribute (as a replacement for the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element and related elements). This allows for complete generality of the query-building process.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The processing of the response can be specified with an externally defined bean via the ","type":"text"},{"text":"mappingStrategyRef","type":"text","marks":[{"type":"code"}]},{"text":" attribute (as a replacement for the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The caching of results can be specified as an externally defined bean via the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element (as a replacement for the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rarely, a non-default Velocity engine can be injected via the ","type":"text"},{"text":"templateEngine","type":"text","marks":[{"type":"code"}]},{"text":" attribute.","type":"text"}]}]}]},{"type":"paragraph"}],"version":1}