Display the Logon Failure Reason

This step is mandatory for all installations where Return failure reason has been enabled.

You can configure the Digipass Authentication Module to pass information to OWA upon a failed authentication request. You can, for example, provide users with an explanation of why their logon failed, and with instructions to fix the problem. The authentication server will pass the error or status code and message text for the authentication server to OWA, which can then display the message verbatim or interpret the code to provide the user with a clear explanation or set of instructions.

Configure the logon page

You can replace the default OWA logon page with the one provided with the Digipass Authentication Module. This will allow OWA to display an authentication server error or status code and message on the user’s screen.

To display the logon failure reason

1. Back up owa_directory\auth\logon.aspx to a suitable place.

2. Copy the modified logon page from %PROGRAMFILES%\OneSpan\Digipass Authentication for OWA Forms\Templates\OWAF VERSION\logon.aspx (or other location if using a custom logon page) to %windir%\web\owa_directory\auth\logon.aspx.

3. In the Digipass Authentication for OWA Forms Configuration Center, select Return failure reason and specify the URL of the failed logon page.

Modify the custom logon page

If you have a custom logon.aspx page in use, you may need to modify it rather than replace it with the logon.aspx page provided with the Digipass Authentication Module.

The logon.aspx page will also be set up for 1-step Challenge/Response. However, these portions of the page will be ignored by the Digipass Authentication Module unless 1-step Challenge/Response is enabled in the configuration.

To modify the custom logon page for displaying the logon failure reason

1. Back up owa_installation_folder\auth\logon.aspx to a suitable place.

2. Open logon.aspx, which is located in %PROGRAMFILES%\OneSpan\Digipass Authentication for OWA Forms\Templates\OWAF version\.

3. Modify the existing page with OneSpan code.

   Copy the following code snippet to the appropriate location in your custom logon file:

   Make sure you insert the OneSpan code in the correct location in the file. Refer to the example logon file delivered with the Digipass Authentication Module to find out where the OneSpan code needs to go in your custom logon page.

   <!-- DIGIPASS Authentication for OWA Forms modifications : START -->
   <!--The following is required to display DIGIPASS failure reason -->
   <%
   System.String VascoFailCode = System.Web.HttpUtility.UrlDecode(Request.QueryString["failcode"]);
   System.String VascoFailMessage = System.Web.HttpUtility.UrlDecode(Request.QueryString["failmessage"]);
   if (!System.String.IsNullOrEmpty(VascoFailCode))          VascoFailMessage = "(" + VascoFailCode + ") " + VascoFailMessage;
   if (String.IsNullOrEmpty (VascoFaileMessageState))
   {
   %>
   <!-- DIGIPASS Authentication for OWA Forms modifications : END -->

   <!-- DIGIPASS Authentication for OWA Forms modifications : START -->
   <!--The following is required to display DIGIPASS failure reason -->
   <%
   }
   else
   {
   %>
       <td>DIGIPASS error:&nbsp;<%=VascoFailMessage%></td>
   <%
   }
   %>
   <!-- DIGIPASS Authentication for OWA Forms modifications : END -->

4. Save and close the custom logon file.