Post-Installation Tasks
4.2.5
4.3
A piece of code must be inserted into the page to include a hidden field used by the IIS 6 Module . The code required can be found below or taken directly from the Change Password page added to the <install directory>\change_password\CWI_<Citrix version> directory during installation.
Citrix Web Interface 4.x
<!-- Digipass Authentication for Citrix Web Interface modifications : START -->
<!-- The following hidden field is required to learn password changes. -->
<input type='hidden' name='dp_user' value='<%=Session["dp_user"]%>'>
<!-- Digipass Authentication for Citrix Web Interface modifications : END -->
Modify Server Include File
The login.cs (4.0) or login.aspxf (4.5 and 4.6) file for a site may have been modified from the default Citrix file by other programs. If so, it is recommended that you modify it with the required extra code rather than replacing it with the file included with the IIS 6 Module. This is required for Citrix Web Interface 4.x only.
The code should be inserted in the loginAuthenticateExplicit function, underneath the following text:
if (credentials != null && !bIsError()) {
Code
System.Collections.Hashtable parameters = new System.Collections.Hashtable();
parameters["AccessToken"] = credentials;
parameters["ExplicitAuth"] = expAuth;
// Digipass Authentication for Citrix Web Interface modifications : START
// The following session variable is required to learn password changes.
Session["dp_user"] = (string)credentials.getUserIdentity();
//
Digipass Authentication for Citrix Web Interface modifications : END
Display Login Failure Reason
The IIS 6 Module may be configured to pass information to Citrix when it fails an authentication request. This information may be used to provide Users with an explanation of why their login failed, and steps that they may be able to take to rectify the problem. The IIS 6 Module will pass the error or status code and message text for the
Authentication Server to Citrix, which – depending on settings in the messagecenter.inc and login.js files - may then display the message verbatim or interpret the code to provide the User with a clear explanation or set of instructions.
Digipass Authentication for Citrix Web Interface Guide 61
