getSecureChallenge SOAP Request Structure

A getSecureChallenge SOAP request typically uses the following format:

<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:aut="http://www.vasco.com/IdentikeyServer/IdentikeyTypes/Authentication">
  <soapenv:Header/>
  <soapenv:Body>
    <aut:getSecureChallenge>
      <credentialAttributeSet>
        <attributes>
          <value xsi:type="xsd:unsignedInt">0</value>
          <attributeID>CREDFLD_PASSWORD_FORMAT</attributeID>
        </attributes>
        <attributes>
          <value xsi:type="xsd:string">user1</value>
          <attributeID>CREDFLD_USERID</attributeID>
        </attributes>
        <attributes>
          <value xsi:type="xsd:string">VDS0000001-1</value>
          <attributeID>CREDFLD_SERIAL_NO</attributeID>
        </attributes>
        <attributes>
          <value xsi:type="xsd:string">test message</value>
          <attributeID>CREDFLD_CHALLENGE_MESSAGE</attributeID>
        </attributes>
        <attributes>
          <value xsi:type="xsd:string">Authentication with Secure Channel Sample Client</value>
          <attributeID>CREDFLD_COMPONENT_TYPE</attributeID>
        </attributes>
      </credentialAttributeSet>
    </aut:getSecureChallenge>
  </soapenv:Body>
</soapenv:Envelope>

The SOAP body element must only contain a single getSecureChallenge element (line 8). This element is defined in the namespace aut. Therefore, the aut namespace needs to be declared in the Envelope element as an attribute.

A valid getSecureChallenge request must follow these additional rules:

• The getSecureChallenge element must contain one attributeSet.
• The attributeSet element must contain the minimum number of required attribute elements.
• Either a CREDFLD_REQUEST_BODY element or a CREDFLD_CHALLENGE_MESSAGE element with an optional CREDFLD_TRANSACTION_TITLE element must exist.