{"type":"doc","content":[{"type":"paragraph","content":[{"text":"The HTTP resource and the related File Backed HTTP Resource allow configuration to be retrieved from an web server. In contrast to the Spring ","type":"text"},{"text":"UrlResource","type":"text","marks":[{"type":"link","attrs":{"href":"http://docs.spring.io/spring/docs/4.1.x/spring-framework-reference/html/resources.html#resources-implementations-urlresource"}}]},{"text":", significant ","type":"text"},{"text":"control","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"HttpClientConfiguration","versionAtSave":"12"},"href":"/wiki/spaces/IDP4/pages/1265631724"}}]},{"text":" of the underlying Apache HttpClient library is available, such as:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Connection timeouts and other connection-related configuration.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Proxy information","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In-memory or file backed caching. This caching is at the HTTP client level and allows a reduction of the HTTP traffic since data is only loaded when it has gone out of date. However, these caches do not survive the lifetime of the HttpClient, and so are not available across IdP restarts, so they are generally not of a lot of value.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"For details on some advanced usage, refer to the ","type":"text"},{"text":"HttpClientConfiguration","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"HttpClientConfiguration","versionAtSave":"12"},"href":"/wiki/spaces/IDP4/pages/1265631724"}}]},{"text":" topic.","type":"text"}]},{"type":"paragraph","content":[{"text":"Notably, this feature does not at present support the security features that are described in that topic. This may be corrected in a future version. For the time being this feature only supports unauthenticated access to resources.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configuring the HTTP Resource","type":"text"}]},{"type":"paragraph","content":[{"text":"The HTTP Resource is configured entirely via its ","type":"text"},{"text":"constructor","type":"text","marks":[{"type":"link","attrs":{"href":"https://build.shibboleth.net/jenkins/job/spring-extensions-nightly/javadoc/net/shibboleth/ext/spring/resource/HTTPResource.html#constructor_detail"}}]},{"text":". The two parameters are the URL and an Apache HttpClient. Some built-in beans are provided to simplify use of the HttpClient, configured via properties detailed in the ","type":"text"},{"text":"HttpClientConfiguration","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"HttpClientConfiguration","versionAtSave":"12"},"href":"/wiki/spaces/IDP4/pages/1265631724"}}]},{"text":" topic.","type":"text"}]},{"type":"paragraph","content":[{"text":"FileBackedHTTPResource","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/cgi-bin/spring-extensions.cgi/net/shibboleth/ext/spring/resource/FileBackedHTTPResource"}}]},{"text":" provides file backup for when the web server is unavailable, including across restarts. Note that this use case is orthogonal to the use of a file-backed HttpClient cache, which provides a local copy of valid cached data even when the web server ","type":"text"},{"text":"can","type":"text","marks":[{"type":"strong"}]},{"text":" be contacted.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"The first example is the simplest case, with a standard client and some timeout settings.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"The second example demonstrates a resource which will be supplied from an on disk backup if the source becomes unavailable.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Finally, a more complex example illustrates how to integrate the security features documented in the ","type":"text"},{"text":"HttpClientConfiguration","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"HttpClientConfiguration","versionAtSave":"12"},"href":"/wiki/spaces/IDP4/pages/1265631724"}}]},{"text":" topic with an HTTPResource. The example references a security object called \"CustomHttpSecurity\", which is not shown, but examples of creating an ","type":"text"},{"text":"HttpClientSecurityParameters","type":"text","marks":[{"type":"link","attrs":{"href":"http://org.opensaml.security.httpclient.HttpClientSecurityParameters@jos"}}]},{"text":" object are in that topic. The additional wiring is to inject the security object into the client at runtime from the resource object.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n\n\n\t\n\t\t\n\t\n\n","type":"text"}]}],"version":1}

Browser not supported