{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"5a57c3c0-da43-49f8-9b3f-847d51ae1cf9"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"3bb09ca2-4534-4811-a677-5192f00dad23"}},{"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 used to apply content settings to requests containing specific query string parameters.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Query string matching can be ill-advised, because the client totally dictates the information, and case matters. It should be used only when the case of the parameter name is significant to the application consuming it, because then the client can bypass your rule, but not actually get the application to run.","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":"table","attrs":{"layout":"full-width","localId":"0572a12b-6e5e-4bf0-85e7-06c4f4432097"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[115.0]},"content":[{"type":"paragraph","content":[{"text":"Names","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[115.0]},"content":[{"type":"paragraph","content":[{"text":"Type","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[115.0]},"content":[{"type":"paragraph","content":[{"text":"Req?","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1287.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[115.0]},"content":[{"type":"paragraph","content":[{"text":"name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[115.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[115.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Y","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1287.0]},"content":[{"type":"paragraph","content":[{"text":"Required, the name of the parameter that must be present to match. Parameter names are case-sensitive.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[115.0]},"content":[{"type":"paragraph","content":[{"text":"regex ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[115.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[115.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1287.0]},"content":[{"type":"paragraph","content":[{"text":"Optional, specifies a regular expression that must match one of the parameter's values. If omitted, the mere presence of a value for the named parameter is sufficient for a match.","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":"e5af31b7-861b-4e53-a893-c9dd1cefd247"},"schemaVersion":{"value":"1"},"title":"Include Page"}},"localId":"c58577cd-6c7c-4328-a7db-2a540ea70f84"}},{"type":"heading","attrs":{"level":3},"content":[{"text":"Child Elements","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Access Control ","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"include","parameters":{"macroParams":{"":{"value":"AccessControl"}},"macroMetadata":{"macroId":{"value":"aa41f56e-d264-449e-9ae9-c451fa71eebb"},"schemaVersion":{"value":"1"},"title":"Include Page"}},"localId":"1f5a7370-448f-4047-8cb9-ee4f58a77436"}},{"type":"heading","attrs":{"level":4},"content":[{"text":"Nested Content Specifiers","type":"text"}]},{"type":"table","attrs":{"layout":"wide","localId":"432d0843-8ca5-446c-8901-0bcf22a39810"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[187.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[100.0]},"content":[{"type":"paragraph","content":[{"text":"Cardinality","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[671.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[187.0]},"content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"Query","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"self"},"href":"/wiki/spaces/SP3/pages/2065335443"}}]},{"text":">","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[100.0]},"content":[{"type":"paragraph","content":[{"text":"0 or more","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[671.0]},"content":[{"type":"paragraph","content":[{"text":"Matches requests containing a query string parameter satisfying the element.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Unlike paths, query strings aren't nested, but nesting the element allows for a conjunction (AND) between the parent element and the child. Sibling elements, meanwhile, form a disjunction (OR).","type":"text"}]},{"type":"paragraph","content":[{"text":"For more details on how the request mapping process works, see the ","type":"text"},{"text":"HowTo","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"HowToRequestMap","versionAtSave":"7"},"href":"/wiki/spaces/SP3/pages/2065335006"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a real-life example for a ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element that is used to protect specific pages in a Dokuwiki instance. This example enforces a Shibboleth session on ","type":"text"},{"text":"https://www.example.org/doku.php","type":"text","marks":[{"type":"code"}]},{"text":" and only users with the given affiliation will be able to access URLs like ","type":"text"},{"text":"https://www.example.org/doku.php?id=internal ","type":"text","marks":[{"type":"code"}]},{"text":"or ","type":"text"},{"text":"https://www.example.org/doku.php?id=internal:subdirectory","type":"text","marks":[{"type":"code"}]},{"text":". Note that the ","type":"text"},{"text":"AccessControl","type":"text","marks":[{"type":"code"}]},{"text":" rule only is enforced for a URL that starts with /doku.php","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n faculty@osu.edu student@osu.edu\n \n \n \n \n","type":"text"}]}],"version":1}

Browser not supported