The response object

The Privileged Access Service creates a single response object for each user session for a user-password web application. The object is an instance of the WebSignInResponse class and is a read-write object.

The response object defines the HTML response that the Privileged Access Service creates to send to the web application. The object does not have any publicly accessible properties. The script defines HTML response fields using the object’s single public method, response.AddFormField().

Method Name

Description

response.AddFormField(
fieldname, fieldvalue)

This method defines an HTML response field to add to the HTML response for this user session. The method takes as its first argument a string that specifies the property to return. Its arguments are:

fieldname, a string that defines the name of the HTML response field.

fieldvalue, a string that defines the value presented in the HTML response field. It’s best to supply this string processed through the global method encode(), which ensures that the string is HTML-safe by properly encoding any special symbols such as @.

An example of setting an HTML response field:

response.AddFormField("username", encode(LoginUser.Username));

This example adds an HTML response field named “username” and sets its value to the current user name specified in the LoginUser object. The encode() method ensures that there are no non-HTML-compliant characters in the string returned by the attribute LoginUser.Username.