Overview of Post-Installation Tasks

You can configure Digipass Authentication for Remote Desktop Web Access to utilize Remote Desktop Access web single sign-on (SSO). Without this feature, users are prompted to type their static passwords each time they launch a remote application, even after successful authentication to Remote Desktop Web Access. With SSO, users need to authenticate only once, with their OTP, and can start remote applications without having to re-authenticate.

For more information about how SSO works with Digipass Authentication for Remote Desktop Web Access, see Single sign-on for Remote Desktop Web Access.

The post-installation tasks are similar for environments with and without single sign-on: you need to set up the logon page by replacing the existing logon page (login.aspx) with the template file delivered with Digipass Authentication for Remote Desktop Web Access, or by adapting the existing file with custom code. Digipass Authentication for Remote Desktop Web Access contains common templates for the website configuration (Common\Challenge_template.html). In addition, templates for Remote Desktop Web Access matching the server you are using, are delivered. These templates are located in the respective sub-folder for the supported versions of Windows Server, with each containing a template for regular logon, i.e. login.aspx.

For single sign-on, you additionally need to modify the Default.aspx file and copy a number of other SSO-specific files to their appropriate locations. The templates for Remote Desktop Web Access with SSO are available in the respective SSO sub-folder.

Digipass Authentication for Remote Desktop Web Access without single sign-on

The logon page template (login.aspx) is located in %PROGRAMFILES%\OneSpan\Digipass Authentication for Remote Desktop Web Access\Templates\RDWeb (Windows Server version)\.

Post-installation tasks without single sign-on:

• Setting up the Remote Desktop Web Access logon page, i.e. login.aspx (see Set up the Response-Only logon page, Set up the 1-step Challenge/Response logon page, and Display the logon failure reason).

No further post-installation tasks are necessary.

Digipass Authentication for Remote Desktop Web Access with single sign-on

Page templates and other files for single sign-on are located in %PROGRAMFILES%\OneSpan\Digipass Authentication for Remote Desktop Web Access\Templates\RDWeb (Windows Server version)\SSO\:

• Default.aspx. This is the Remote Desktop Web Access page from which you open remote applications.

• login.aspx. This is the Remote Desktop Web Access logon page.

• DIGIPASS_MsRdpWebAccessXMT32.dll and DIGIPASS_MsRdpWebAccessXMT64.dll. These are ActiveX objects for single sign-on.

• renderscripts.js. This is the JavaScript file for single sign-on.

• webscripts-domain.js. This is the JavaScript file for single sign-on used on Windows Server platforms.

Post-installation tasks with single sign-on:

1. Setting up the Remote Desktop Web Access logon page, i.e. login.aspx (see Set up the Response-Only logon page, Set up the 1-step Challenge/Response logon page, and Display the logon failure reason).

2. Setting up Default.aspx (see Set up Default.aspx).

3. Copying the following files from %PROGRAMFILES%\OneSpan\Digipass Authentication for Remote Desktop Web Access\Templates\RDWeb (Windows Server version\SSO\ to %WINDIR%\web\RDWeb\Pages\en-US\:

   • DIGIPASS_MsRdpWebAccessXMT32.dll

   • DIGIPASS_MsRdpWebAccessXMT64.dll

4. Copying renderscripts.js to %WINDIR%\web\RDWeb\Pages\.

5. Copying webscripts-domain.js to %WINDIR%\web\RDWeb\Pages\.