{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"1bb16080-ebb8-425a-8dce-140910582d5b"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"e04b9757-c606-46d5-8a5c-65a9583c97dc"}},{"type":"heading","attrs":{"level":2},"content":[{"type":"hardBreak"},{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"Identified by ","type":"text"},{"text":"type=\"XML\"","type":"text","marks":[{"type":"code"}]},{"text":", this ","type":"text"},{"text":"RequestMapper","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2065334391"}}]},{"text":" provides a portable XML syntax for configuring settings based on URL host, path, and query string information. It does not permit settings to be defined in the web server's configuration and will not honor them if they're present.","type":"text"}]},{"type":"paragraph","content":[{"text":"Generally this type isn't used directly, but rather the ","type":"text"},{"text":"Native","type":"text","marks":[{"type":"code"},{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2065335023"}}]},{"text":" type is used instead, because it layers itself on top of this one, and allows the \"right\" thing to happen on any given web server. When using IIS, they are functionally equivalent.","type":"text"}]},{"type":"paragraph","content":[{"text":"When using Apache, the only reason for using this plugin type in favor of the ","type":"text"},{"text":"Native","type":"text","marks":[{"type":"code"},{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2065335023"}}]},{"text":" type would be to prevent developers with access to content from using ","type":"text"},{"text":".htaccess","type":"text","marks":[{"type":"code"}]},{"text":" commands. Since Apache itself can prevent this already, it's largely superfluous, but there could be very small efficiency gains from using it in such cases.","type":"text"}]},{"type":"paragraph","content":[{"text":"This request mapper's configuration is implemented as a ","type":"text"},{"text":"reloadable XML resource","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2063695928"}}]},{"text":", which means that the XML content can be supplied inline, in a local file, or a remote file, and can be monitored for changes and reloaded on the fly. The root of the XML in any of those cases ","type":"text"},{"text":"MUST","type":"text","marks":[{"type":"strong"}]},{"text":" be a ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"},{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2065334885"}}]},{"text":" element, either as a child element in an existing file or the root of a different file.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that the actual settings that the RequestMapper supports aren't documented here because they don't show up in this element, but rather the ","type":"text"},{"text":"<","type":"text","marks":[{"type":"code"}]},{"text":"RequestMap","type":"text","marks":[{"type":"code"},{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2065334885"}}]},{"text":">","type":"text","marks":[{"type":"code"}]},{"text":" element and its various children.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Reference","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Attributes","type":"text"}]},{"type":"paragraph","content":[{"text":"Aside from the ","type":"text"},{"text":"type=\"XML\"","type":"text","marks":[{"type":"code"}]},{"text":" attribute itself, there is no other attribute content specific to this plugin type.","type":"text"}]},{"type":"paragraph","content":[{"text":"It supports all of the attributes common to all ","type":"text"},{"text":"reloadable","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2063695928"}}]},{"text":" configuration resources:","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"include","parameters":{"macroParams":{"":{"value":"ReloadableConfigurationAttributes"}},"macroMetadata":{"macroId":{"value":"c84e2502-6aa1-4d36-9aad-9308cdf049ef"},"schemaVersion":{"value":"1"},"title":"Include Page"}},"localId":"2fd8a43d-36c5-45f4-aabb-6603604663a6"}},{"type":"heading","attrs":{"level":3},"content":[{"text":"Child Elements","type":"text"}]},{"type":"paragraph","content":[{"text":"The following child element ","type":"text"},{"text":"must","type":"text","marks":[{"type":"em"}]},{"text":" be provided, either inline (the most common way), or as the root element of a local or remote XML resource to load from, which would be specified via the attribute(s) above.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"5fbf123b-bbf6-4911-93d2-934bbb347f2d"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[83.0]},"content":[{"type":"paragraph","content":[{"text":"Cardinality","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[541.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"RequestMap","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2065334885"}}]},{"text":">","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[83.0]},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[541.0]},"content":[{"type":"paragraph","content":[{"text":"Root element of configuration","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"When a non-inline configuration is used, it supports the following child elements common to all ","type":"text"},{"text":"reloadable","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2063695928"}}]},{"text":" configuration resources.","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"include","parameters":{"macroParams":{"":{"value":"ReloadableConfigurationElements"}},"macroMetadata":{"macroId":{"value":"bee089ed-1bdd-4f82-8416-f55d42e50e62"},"schemaVersion":{"value":"1"},"title":"Include Page"}},"localId":"beeab15c-e9f9-4868-ba2e-8c62dbc27c48"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"The most common observed pattern is the \"inline\" case, and the Windows-installed defaults includes something similar to this example (but it specifies the type as ","type":"text"},{"text":"Native","type":"text","marks":[{"type":"code"}]},{"text":" instead, as noted above, simply to allow for a Windows install to be easily plugged into Apache. As you can see, there are no bits of content in the root element apart from the ","type":"text"},{"text":"type","type":"text","marks":[{"type":"code"}]},{"text":", and the rest is devolved to the required root element, the ","type":"text"},{"text":"<","type":"text","marks":[{"type":"code"}]},{"text":"RequestMap","type":"text","marks":[{"type":"code"},{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2065334885"}}]},{"text":">","type":"text","marks":[{"type":"code"}]},{"text":", which is documented separately.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Inline Example","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Alternatively, here's an example of moving the RequestMapper configuration into a separate file, and it is equivalent to the XML above in terms of the RequestMapper behavior.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Pointer to External FIle in shibboleth2.xml","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"request-mapper.xml","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that you can essentially transplant the content from the inline case directly, but you do need to take care of the XML namespace declaration to do so.","type":"text"}]}],"version":1}

Browser not supported