{"type":"doc","content":[{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Using this plugin requires that the ","type":"text"},{"text":"plugins.so","type":"text","marks":[{"type":"strong"}]},{"text":" extension library be loaded via the ","type":"text"},{"text":"<","type":"text","marks":[{"type":"code"}]},{"text":"Extensions","type":"text","marks":[{"type":"code"},{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Extensions","versionAtSave":"6"},"href":"/wiki/spaces/SP3/pages/2065334388"}}]},{"text":">","type":"text","marks":[{"type":"code"}]},{"text":" element in the ","type":"text"},{"text":"<","type":"text","marks":[{"type":"code"}]},{"text":"OutOfProcess","type":"text","marks":[{"type":"code"},{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"OutOfProcess","versionAtSave":"7"},"href":"/wiki/spaces/SP3/pages/2065334599"}}]},{"text":">","type":"text","marks":[{"type":"code"}]},{"text":" element.","type":"text"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"e911c165-cbce-4d77-852d-c0a9e4fe697d"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"b7d544d5-ff74-4972-a60c-3d4e6437c05e"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"Identified by ","type":"text"},{"text":"type=\"GSSAPI\"","type":"text","marks":[{"type":"code"}]},{"text":", this ","type":"text"},{"text":"AttributeExtractor","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"AttributeExtractor","versionAtSave":"10"},"href":"/wiki/spaces/SP3/pages/2065334409"}}]},{"text":" implements an XML-based rule syntax for designating GSS-API naming extensions to decode into internal attributes.","type":"text"}]},{"type":"paragraph","content":[{"text":"GSS-API names or contexts can be processed by encoding the exported data in base64, and wrapping in an ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element respectively, to meet the constraints of the API, which are based around XML as input.","type":"text"}]},{"type":"paragraph","content":[{"text":"This extractor's configuration is implemented as a ","type":"text"},{"text":"reloadable XML resource","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"ReloadableConfiguration","versionAtSave":"16"},"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 (but see the warning below). The root of the XML in any of those cases ","type":"text"},{"text":"MUST","type":"text","marks":[{"type":"strong"}]},{"text":" be an ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element, either as a child element in an existing file or the root of a different file.","type":"text"}]},{"type":"paragraph","content":[{"text":"Each ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" child element installs a rule for extracting a particular GSS naming extension attribute into an internal SP attribute. The source of the attribute is identified with the ","type":"text"},{"text":"name","type":"text","marks":[{"type":"code"}]},{"text":" XML attributes and internally tagged by the ","type":"text"},{"text":"id.","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Multiple ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" rules can share the same ","type":"text"},{"text":"id","type":"text","marks":[{"type":"code"}]},{"text":"; the implication is that a given internal name may be mapped from multiple externally-named sources to consolidate multiple sources down into one representation.","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":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"ReloadableConfiguration","versionAtSave":"16"},"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":"b067021321cf0f20badf9c80799c5f47"},"schemaVersion":{"value":"1"},"title":"Include Page"}},"localId":"e5354ddf-32be-486f-b292-b96c142161ae"}},{"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, 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":"wide","localId":"a0d733f3-177c-41d9-bf49-ca3d7782f847"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[278.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[185.0]},"content":[{"type":"paragraph","content":[{"text":"Cardinality","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[497.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[278.0]},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[185.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[497.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":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"ReloadableConfiguration","versionAtSave":"16"},"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":"822ba8f7dac7a090f66c6f009a829076"},"schemaVersion":{"value":"1"},"title":"Include Page"}},"localId":"c6742802-9aab-4515-b8c9-12537991320d"}},{"type":"heading","attrs":{"level":3},"content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" Element Reference","type":"text"}]},{"type":"paragraph","content":[{"text":"This is the root element of the mapping configuration.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Child Elements","type":"text"}]},{"type":"paragraph","content":[{"text":"The following child element content is supported:","type":"text"}]},{"type":"table","attrs":{"layout":"wide","localId":"4b540a72-1f76-4443-9488-a0595615a938"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[179.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":2,"rowspan":1,"colwidth":[162.0,48.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Cardinality","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[571.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[179.0]},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[162.0,48.0]},"content":[{"type":"paragraph","content":[{"text":"1 or more","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[571.0]},"content":[{"type":"paragraph","content":[{"text":"An extraction rule","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" Element Reference","type":"text"}]},{"type":"paragraph","content":[{"text":"Each ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element describes an extraction rule, the core of this plugin's behavior.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Attributes","type":"text"}]},{"type":"paragraph","content":[{"text":"An extraction rule supports the following XML attributes:","type":"text"}]},{"type":"table","attrs":{"layout":"wide","localId":"136df637-41e1-43ea-873f-a4bbd05d0789"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"Type","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[62.0]},"content":[{"type":"paragraph","content":[{"text":"Req?","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[61.0]},"content":[{"type":"paragraph","content":[{"text":"Default","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[665.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph","content":[{"text":"id","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[62.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Y","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[61.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[665.0]},"content":[{"type":"paragraph","content":[{"text":"Name of the attribute to create","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph","content":[{"text":"name","type":"text"},{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[62.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Y","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[61.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[665.0]},"content":[{"type":"paragraph","content":[{"text":"GSS-API naming extension attribute to extract from","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph","content":[{"text":"authenticated","type":"text"},{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"boolean","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[62.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[61.0]},"content":[{"type":"paragraph","content":[{"text":"true","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[665.0]},"content":[{"type":"paragraph","content":[{"text":"If true, only authenticated GSS-API naming attributes are processed","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph","content":[{"text":"scopeDelimeter","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"character","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[62.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[61.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[665.0]},"content":[{"type":"paragraph","content":[{"text":"If set, all values of the naming attribute must contain the character, and it is used to split the value into a two-part construct expressed as a scoped attribute","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph","content":[{"text":"binary","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[48.0]},"content":[{"type":"paragraph","content":[{"text":"boolean","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[62.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[61.0]},"content":[{"type":"paragraph","content":[{"text":"false","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[665.0]},"content":[{"type":"paragraph","content":[{"text":"If set, this overrides the ","type":"text"},{"text":"scopeDelimiter","type":"text","marks":[{"type":"code"}]},{"text":" option, and causes the attribute's value to be base64-encoded and handled as a binary attribute. The unencoded value can be accessed natively in C++ code, but the serialized values are left encoded.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"A typical non-inline configuration of this plugin is:","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Specifying a GSSAPI Extractor in another file","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"A simple example configuration:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"text":"\n \n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported