The argument stanza

Understand how we can use the argument stanza and the variables contained within the stanza.

The custom argument stanza contains one or more entries in the following form:

name = method:value

name The value of the name variable is set to equal the value of the "name" attribute of the HTML "input" tag. For example:

<input name=uid type=text>Username</input>

This variable can also use the value of the name attribute of the HTML select or textarea tags.

method:value

This combination retrieves the authentication data required by the form. The authentication data can include:

• Literal string data

  string:text

  The input used is the text string.

• GSO user name and password

  gso:username
  gso:password

  The input is the current user's GSO user name and password (from the target specified in the custom login page stanza).

• Value of an attribute in the user's credential

  cred:cred-ext-attr-name

  By default, the credential includes information such as the user's Security Verify Access user name and DN. To use the user's Security Verify Access user name as the input value, specify the value as:

  cred:azn_cred_principal_name

  The user's DN can be accessed as:

  cred:azn_cred_authzn_id

  Custom credential attributes (added through the tag-value mechanism) can also be used.

  It is not necessary to specify hidden input fields in this stanza. These fields are automatically retrieved from the HTML form and submitted with the authentication request.

  For example:

  [form1-data]
  uid = string:brian

  Parent topic: Creation of the configuration file for forms single signon