Configuration Guides › Policy Server Configuration Guide › Authentication Schemes › XML Document Credential Collector Authentication › Configure the XML DCC Authentication Scheme › Configure the Required "user" Mapping

Configure the Required "user" Mapping

When you create an XML DCC authentication scheme, a required "user" mapping, which is used to map the user name field in the user store, is created for you. Before you configure any further mappings, you must map this value to a field in the XML document.

Two methods for creating mappings are as follows:

• Open a schema and select elements from it that you want to map to the user store. This method is easier because SOA Security Manager builds the XPath query for you as you select fields for mappings.
• Use the Advanced XPath query option to build more complex XPath queries manually.

To configure XML DCC field mappings

1. Locate the Scheme Setup group box on the Create Authentication Scheme pane and click the Edit button beside the "user" field mapping entry.

   Field mapping settings open.

2. Do one of the following:
   • Type an XPATH query defining the mapping for "user" in the XPath field.
   • Load a schema (.xsd) file and select the element to map to "user" by browsing using the following procedure:
     1. Unset the Advance XPath query option.
     2. If the schema file you require is remote (for instance, if it is typically accessed over HTTP using its URL), download it to a local drive.
     3. Click Browse and navigate to a schema file in the File Upload dialog that appears.
     4. Click Upload XSD File.

        The schema is uploaded.

     5. Select the schema element that you want to map to the 'user" field name in the Select a node group box.

        The Select a node group box displays the selected schema using a standard tree-style hierarchical view. Click the plus sign (+) next to an element to expand it. Click the minus sign (-) beside an expanded element to contract it. Elements marked with an asterisk (*) are repeatable within the XML document (that is, incoming XML documents may contain multiple instances of that element).

3. (Optional) Specify the XPath function (count, div, index, mod, sum) that you want to apply to the mapping by choosing it from the Function drop-down list.

   The Function option lets you create more complex mappings by processing functions that further evaluate the XML document. For more information about these functions, navigate to the XPath specification at http://www.w3.org.

4. Specify whether the mapped information is located relative to the message body or message header by selecting the Message Body or Message Header option button.

   This defines the root of the XML document and tells XPath where to search for the relevant information. If the document has multiple headers, XPath uses the value of the first header that resolves.

5. Click OK to save your changes and return to the Create Authentication Scheme pane.