{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"0c34e7c1-58cb-4526-bcb6-fa9471332bff"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"3f9f6cdb-848a-4a30-a2c6-2275f160a347"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element is the root of the ","type":"text"},{"text":"XML","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2065335025"}}]},{"text":"-based ","type":"text"},{"text":"RequestMapper","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2065334391"}}]},{"text":" configuration (see the general documentation on this plugin for context). The root element is a globally applicable container that can apply settings to all requests.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"A special requirement of this root element is that it ","type":"text"},{"text":"MUST","type":"text","marks":[{"type":"strong"}]},{"text":" contain an ","type":"text"},{"text":"applicationId","type":"text","marks":[{"type":"code"}]},{"text":" attribute with a value of \"default\", which in turn matches the required ","type":"text"},{"text":"id","type":"text","marks":[{"type":"code"}]},{"text":" attribute of the outer-most ","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2063695997"}}]},{"text":" element in the ","type":"text"},{"text":"shibboleth2.xml","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2063695926"}}]},{"text":" file.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Apart from establishing default settings, its purpose is to act as a container for the rules you specify regarding virtual host, path, and/or query string matching to apply settings. The tree structure of the XML essentially maps to the tree structure of the URL space of your web server.","type":"text"}]},{"type":"paragraph","content":[{"text":"For a broader picture of how this all works, see the ","type":"text"},{"text":"request mapper HOWTO","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2065335006"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Reference","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Attributes","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Content Specifiers","type":"text"}]},{"type":"paragraph","content":[{"text":"The root element applies to all requests, so it has no special attributes that govern matching behavior in contrast to the various child elements that are used to match specific requests.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Content Settings","type":"text"}]},{"type":"paragraph","content":[{"text":"The element supports a large number of XML attributes corresponding to the content settings supported by the SP:","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"include","parameters":{"macroParams":{"":{"value":"ContentSettings"}},"macroMetadata":{"macroId":{"value":"e5d5762f-1ed2-4675-ab48-199387f1c2a6"},"schemaVersion":{"value":"1"},"title":"Include Page"}},"localId":"d79d4712-b1e4-4b16-9255-d9be9c694d1a"}},{"type":"heading","attrs":{"level":3},"content":[{"text":"Child Elements","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Access Control Elements","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"include","parameters":{"macroParams":{"":{"value":"AccessControl"}},"macroMetadata":{"macroId":{"value":"6f67fa5c-0bb0-4aa6-97f5-ef578603d728"},"schemaVersion":{"value":"1"},"title":"Include Page"}},"localId":"7e85baff-17b0-4fa0-838f-f2a79a467d80"}},{"type":"heading","attrs":{"level":4},"content":[{"text":"Nested Content Specifiers","type":"text"}]},{"type":"paragraph","content":[{"text":"The following elements are supported to narrow the matching process:","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"330e3a23-4f7c-425f-b358-3d12f9002b9e"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[154.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[115.0]},"content":[{"type":"paragraph","content":[{"text":"Cardinality","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1015.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[154.0]},"content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"Host","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2065335405"}}]},{"text":">","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[115.0]},"content":[{"type":"paragraph","content":[{"text":"0 or more","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1015.0]},"content":[{"type":"paragraph","content":[{"text":"Matches requests via the exact hostname (and optionally port and scheme).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[154.0]},"content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"HostRegex","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2065335407"}}]},{"text":">","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[115.0]},"content":[{"type":"paragraph","content":[{"text":"0 or more","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1015.0]},"content":[{"type":"paragraph","content":[{"text":"Matches requests with a URL prefix matching a regular expression. The prefix contains everyting up until the slash following the hostname or port.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The matching process is peformed by examining <","type":"text"},{"text":"Host","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2065335405"}}]},{"text":"> elements in order, and then checking any <","type":"text"},{"text":"HostRegex","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2065335407"}}]},{"text":"> elements in order, in separate passes (see the ","type":"text"},{"text":"HowTo","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2065335006"}}]},{"text":").","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"A somewhat non-trivial example shows a pair of virtual hosts with one bound to an <","type":"text"},{"text":"ApplicationOverride","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2063696335"}}]},{"text":"> called ","type":"text"},{"text":"admin","type":"text","marks":[{"type":"code"}]},{"text":". The path \"/secure\" on the primary host is protected automatically, while the entire admin host is protected along with access control rule embedded in the configuration.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n faculty@osu.edu student@osu.edu\n \n \n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported