{"type":"doc","content":[{"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":"paragraph","content":[{"text":"The ","type":"text"},{"text":"HTTP","type":"text","marks":[{"type":"code"}]},{"text":" data connector generates multiple attributes resulting from calling a web service. The connector itself is primarily just a framework for constructing a request to issue using the Apache ","type":"text"},{"text":"HttpClient","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631724"}}]},{"text":" library and processing a response. There is no attempt to standardize a web service interface, but the design is geared towards making simple, templated GET requests and processing XML or JSON result sets using a script. More advanced use cases can be supported by means of pluggable Java interfaces or more advanced scripting.","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"5d71f513-c344-45ec-8ad4-12bf915e5519"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"98cfc80a-2b39-4cab-9150-11dca57ca345"}},{"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":"an ","type":"text"},{"text":"HttpClient","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631724"}}]},{"text":" bean and various security and networking parameters necessary to invoke the web service safely","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"request creation","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"response processing","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Two options for request creation exist, one for simple GET requests and one for more complex POST requests with a body. Both rely on a <","type":"text"},{"text":"URLTemplate","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631571"}}]},{"text":"> element to produce the URL, which can be populated with dependency data much like an LDAP search filter or database query. The POST option also supports a <","type":"text"},{"text":"BodyTemplate","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631568"}}]},{"text":"> element that can similarly generate a request body based on dependency data, typically JSON or XML. With POST, you also can control caching of results (if a results cache is used) by generating a cache entry key using a <","type":"text"},{"text":"CacheKeyTemplate","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631569"}}]},{"text":"> element.","type":"text"}]},{"type":"paragraph","content":[{"text":"The only supplied implementation for response processing is script-based, using the <","type":"text"},{"text":"ResponseMapping","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631570"}}]},{"text":"> element to supply a script to produce attribute data from the response body. For efficiency, the implementation assumes that the response processing script can consume the results in real time, and leaves any buffering of the data to the script, should that be necessary. Support is built-in for limiting the size of the data, allowed content types, and HTTP status codes accepted, to address the most common sanity checks.","type":"text"}]},{"type":"paragraph","content":[{"text":"At minimum, an ","type":"text"},{"text":"httpClientRef","type":"text","marks":[{"type":"code"}]},{"text":" attribute must be supplied to provide the client runtime bean to use. This will usually if not always be accompanied by an ","type":"text"},{"text":"httpClientSecurityParametersRef","type":"text","marks":[{"type":"code"}]},{"text":" attribute to supply security settings, although a few shortcut settings are available for certificate authentication use cases. A complete summary and examples can be found on the ","type":"text"},{"text":"HttpClientConfiguration","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631724"}}]},{"text":" page.","type":"text"}]},{"type":"paragraph","content":[{"text":"Spring beans may be defined either in additionally loaded Spring resources configured into the Attribute Resolver ","type":"text"},{"text":"service","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631674"}}]},{"text":"'s resource collection, or in a central location such as ","type":"text"},{"text":"global.xml","type":"text","marks":[{"type":"em"}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Caching Behavior","type":"text"}]},{"type":"paragraph","content":[{"text":"The built-in caching support (if enabled) keys the cached data for a GET request by the fully populated template URL generated, typically including information about the subject in the URL. For POST requests, you may provide a template for producing an appropriate cache key, or omit it to disable caching.","type":"text"}]},{"type":"paragraph","content":[{"text":"Customized implementations of the ","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":"HTTPSearch","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.attribute.resolver.dc.http.impl.HTTPSearch"}}]},{"text":"> interface MUST implement appropriate cache key semantics, particularly if they inherit from that base class.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"Any examples here omit the Spring beans that define the HTTP client and security parameters to use. Examples of these can be found in the ","type":"text"},{"text":"HttpClientConfiguration","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631724"}}]},{"text":" topic.","type":"text"}]},{"type":"expand","attrs":{"title":"HTTP connector for a JSON-based web service"},"content":[{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n\t\n\t\t\n\t\n\n\t\n\t\t\n\t\n\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 following attributes may be specified (the only required attribute is ","type":"text"},{"text":"httpClientRef","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"85a6cd5e-95ee-41b8-82d8-e08e58567d3a"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[371.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[276.0]},"content":[{"type":"paragraph","content":[{"text":"Type","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph","content":[{"text":"Default","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1027.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[371.0]},"content":[{"type":"paragraph","content":[{"text":"httpClientRef","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[276.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1027.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID of the ","type":"text"},{"text":"HttpClient","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631724"}}]},{"text":" instance to use","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[371.0]},"content":[{"type":"paragraph","content":[{"text":"httpClientSecurityParametersRef","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[276.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1027.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID of the ","type":"text"},{"text":"HttpClientSecurityParameters","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-opensaml.cgi/org.opensaml.security.httpclient.HttpClientSecurityParameters"}}]},{"text":" instance to use, ignored if one of the security shortcut settings are used","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[371.0]},"content":[{"type":"paragraph","content":[{"text":"serverCertificate","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[276.0]},"content":[{"type":"paragraph","content":[{"text":"Resource path","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1027.0]},"content":[{"type":"paragraph","content":[{"text":"Path of resource containing a server certificate whose public key must match the server's. If set, ","type":"text"},{"text":"httpClientSecurityParametersRef","type":"text","marks":[{"type":"code"}]},{"text":" is ignored.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[371.0]},"content":[{"type":"paragraph","content":[{"text":"certificateAuthority","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[276.0]},"content":[{"type":"paragraph","content":[{"text":"Resource path","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1027.0]},"content":[{"type":"paragraph","content":[{"text":"Path of resource containing a certificate authority used to validate the server's certificate. If set, ","type":"text"},{"text":"httpClientSecurityParametersRef","type":"text","marks":[{"type":"code"}]},{"text":" is ignored.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[371.0]},"content":[{"type":"paragraph","content":[{"text":"clientPrivateKey","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[276.0]},"content":[{"type":"paragraph","content":[{"text":"Resource path","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1027.0]},"content":[{"type":"paragraph","content":[{"text":"Path of resource containing a private key used to authenticate the client to the server via TLS. If set, ","type":"text"},{"text":"httpClientSecurityParametersRef","type":"text","marks":[{"type":"code"}]},{"text":" is ignored.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[371.0]},"content":[{"type":"paragraph","content":[{"text":"clientCertificate","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[276.0]},"content":[{"type":"paragraph","content":[{"text":"Resource path","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1027.0]},"content":[{"type":"paragraph","content":[{"text":"Path of resource containing a certificate used to authenticate the client to the server via TLS. If set, ","type":"text"},{"text":"httpClientSecurityParametersRef","type":"text","marks":[{"type":"code"}]},{"text":" is ignored.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[371.0]},"content":[{"type":"paragraph","content":[{"text":"maxLength","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[276.0]},"content":[{"type":"paragraph","content":[{"text":"Long","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.lang.Long"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph","content":[{"text":"0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1027.0]},"content":[{"type":"paragraph","content":[{"text":"Limits size of response body to accept, or 0 for no limit. When used, only non-chunked responses that include a content length will be accepted.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[371.0]},"content":[{"type":"paragraph","content":[{"text":"acceptStatuses","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[276.0]},"content":[{"type":"paragraph","content":[{"text":"Collection","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.util.Collection"}}]},{"text":"<","type":"text"},{"text":"Integer","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.lang.Integer"}}]},{"text":">","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph","content":[{"text":"200","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1027.0]},"content":[{"type":"paragraph","content":[{"text":"Acceptable HTTP status codes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[371.0]},"content":[{"type":"paragraph","content":[{"text":"acceptTypes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[276.0]},"content":[{"type":"paragraph","content":[{"text":"Collection","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.util.Collection"}}]},{"text":"<","type":"text"},{"text":"String","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.lang.String"}}]},{"text":">","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1027.0]},"content":[{"type":"paragraph","content":[{"text":"Acceptable MIME content types","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[371.0]},"content":[{"type":"paragraph","content":[{"text":"headerMapRef","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[276.0]},"content":[{"type":"paragraph","content":[{"text":"Map","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.util.Map"}}]},{"text":"<","type":"text"},{"text":"String","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.lang.String"}}]},{"text":",","type":"text"},{"text":"String","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.lang.String"}}]},{"text":">","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1027.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID of a map of custom header names and values to set in the HTTP request","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[371.0]},"content":[{"type":"paragraph","content":[{"text":"mappingStrategyRef","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[276.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1027.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID of a ","type":"text"},{"text":"HTTPResponseMappingStrategy","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.attribute.resolver.dc.http.impl.HTTPResponseMappingStrategy"}}]},{"text":" to process the result set in a pluggable way","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[371.0]},"content":[{"type":"paragraph","content":[{"text":"validatorRef","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[276.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1027.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID of a ","type":"text"},{"text":"Validator","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net/shibboleth/idp/attribute/resolver/dc/Validator"}}]},{"text":" to control what constitutes an initialization failure (the default does no validation)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[371.0]},"content":[{"type":"paragraph","content":[{"text":"executableSearchBuilderRef","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[276.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1027.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":"HTTPSearch","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.attribute.resolver.dc.http.impl.HTTPSearch"}}]},{"text":"> to produce the request to execute","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[371.0]},"content":[{"type":"paragraph","content":[{"text":"templateEngine","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[276.0]},"content":[{"type":"paragraph","content":[{"text":"Bean ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1027.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/2.3/apidocs/org/apache/velocity/app/VelocityEngine.html"}}]},{"text":" to use for processing the URL template, generally unnecessary","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[371.0]},"content":[{"type":"paragraph","content":[{"text":"failFast","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[276.0]},"content":[{"type":"paragraph","content":[{"text":"Boolean","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph","content":[{"text":"false","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1027.0]},"content":[{"type":"paragraph","content":[{"text":"Whether a failure when verifying the connection during startup is fatal (stops the Attribute filter service from starting). ","type":"text"}]}]}]}]}]},{"type":"expand","attrs":{"title":"Specific XML Elements"},"content":[{"type":"table","attrs":{"layout":"full-width","localId":"137c7eac-15f9-47a9-a7e8-71e0233f6bd6"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[303.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[165.0]},"content":[{"type":"paragraph","content":[{"text":"Cardinality","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1330.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[303.0]},"content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"URLTemplate","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631571"}}]},{"text":">","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[165.0]},"content":[{"type":"paragraph","content":[{"text":"0 or 1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1330.0]},"content":[{"type":"paragraph","content":[{"text":"Template of a URL to execute via HTTP GET or POST","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[303.0]},"content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"BodyTemplate","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631568"}}]},{"text":">","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[165.0]},"content":[{"type":"paragraph","content":[{"text":"0 or 1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1330.0]},"content":[{"type":"paragraph","content":[{"text":"Template for a request body to submit via HTTP POST, requires use of ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[303.0]},"content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"CacheKeyTemplate","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631569"}}]},{"text":">","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[165.0]},"content":[{"type":"paragraph","content":[{"text":"0 or 1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1330.0]},"content":[{"type":"paragraph","content":[{"text":"Template to produce a cache key to associate with the result of an HTTP POST, requires use of ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[303.0]},"content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"ResponseMapping","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631570"}}]},{"text":">","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[165.0]},"content":[{"type":"paragraph","content":[{"text":"0 or 1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1330.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":[303.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":[165.0]},"content":[{"type":"paragraph"},{"type":"paragraph","content":[{"text":"0 or 1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1330.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":[303.0]},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1330.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://shibboleth.net/cgi-bin/guava.cgi/com.google.common.cache.Cache"}}]},{"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":"71e6d090-b856-4d62-968b-ab5b9848a27f"}}]},{"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":"d33bdc43-97c6-47be-bb72-4d2fe5ed425f"}}]},{"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":"b0382a249e49bee658968ed2c052db41"},"schemaVersion":{"value":"1"},"title":"Include Page"}},"localId":"8365674e-86eb-4eed-a943-aaf7725000c0"}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Spring Configuration","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"springResource","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"springResourceRef","type":"text","marks":[{"type":"code"}]},{"text":" attributes are ","type":"text"},{"text":"DEPRECATED in V4.3 and will not work in V5","type":"text","marks":[{"type":"em"}]}]}]},{"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 data connector bean is delegated to the supplied resources. The system will create a factory for an ","type":"text"},{"text":"HTTPDataConnector","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net/shibboleth/idp/attribute/resolver/dc/http/impl/HTTPDataConnector"}}]},{"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. Note that since these are not public, but implementation classes, they are subject to change, which creates some risk during non-patch upgrades, so you must take additional precautions to use this feature.","type":"text"}]},{"type":"paragraph","content":[{"text":"In practice, the HTTP Data 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":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.attribute.resolver.dc.impl.ExecutableSearchBuilder"}}]},{"text":"<","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/pages/resumedraft.action?draftId=1265631567"}}]},{"text":"HTTPSearch","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.attribute.resolver.dc.http.impl.HTTPSearch"}}]},{"text":">","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/pages/resumedraft.action?draftId=1265631567"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Note that there are no classes available which implement this interface","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"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://shibboleth.net/cgi-bin/java-jdk.cgi/java.lang.String"}}]},{"text":",","type":"text"},{"text":"Map","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.util.Map"}}]},{"text":"<","type":"text"},{"text":"String","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-jdk.cgi/java.lang.String"}}]},{"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":"listItem","content":[{"type":"paragraph","content":[{"text":"Validator","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net/shibboleth/idp/attribute/resolver/dc/impl/Validator"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The only available class which implements this Interface is ","type":"text"},{"text":"NonFailFastValidator","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.attribute.resolver.dc.NonFailFastValidator"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HTTPResponseMappingStrategy","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.attribute.resolver.dc.http.HTTPResponseMappingStrategy"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Note that there are no classes available which implement this interface","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"In addition native bean IDs can be injected as follows:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The HttpClient instance and its security settings are injected via the ","type":"text"},{"text":"httpClientRef","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"httpClientSecurityParametersRef","type":"text","marks":[{"type":"code"}]},{"text":" attributes.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The builder for the request 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 request-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":"A Validator can be specifier as as an externally defined bean via the ","type":"text"},{"text":"validatorRef","type":"text","marks":[{"type":"code"}]},{"text":" attribute. The only available class which implements this Interface is ","type":"text"},{"text":"NonFailFastValidator","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/java-idp.cgi/net.shibboleth.idp.attribute.resolver.dc.NonFailFastValidator"}}]}]}]},{"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}