Installation and configuration

Overview

The following steps broadly depict the flow of actions for the agent solution:

1. Operator logs in to SafeNet Trusted Access (STA), searches for Microsoft Outlook Web App (OWA) within applications, and adds it.

2. Operator configures Microsoft OWA within STA. For more information, see Pre-Installation.

3. Operator downloads the SafeNet Agent for Microsoft OWA installation and configuration files.

4. Local Administrator installs the SafeNet Agent for Microsoft OWA.

5. Local Administrator enables the SafeNet Agent for Microsoft OWA from the agent's administrator interface.

   

6. Microsoft OWA is successfully connected to STA.

Prerequisites

Before installing SafeNet Agent for Microsoft OWA, ensure the following prerequisites are met:

• Ensure that TCP port 80 or 443 is open on the Exchange Server, which acts as a gateway of communication between SafeNet Agent for Microsoft OWA and STA.

• Administrative rights to the Windows system are required during installation of SafeNet Agent for Microsoft OWA.

• The Exchange Server used should be synchronized with the Network Time Protocol (NTP) Server. If the Exchange Server is not synchronized with the NTP Server, authentication may fail.

Pre-installation

You must complete the pre-installation process to ensure that you have the required installation and configuration files for an initial installation.

1. Log in to STA as an Operator.

2. After successful login, the STA console displays the Dashboard of the account. On the Operator's dashboard, on the top right-hand side corner, click the drop-down and select the required virtual server account.

3. Click the Applications tab.

4. Click Add Application (if no applications have been added) or the + icon (displayed next to Applications) to add an application. The Add Application window is displayed with a list of available applications.

   

5. Select Outlook Web App (from the list of available applications) or search for Outlook Web App. Add a Display Name (any name can be used), and click Add.

   

6. Under Agent Setup, enter the OWA REDIRECT URL. The REDIRECT URL is the hostname address of the machine, followed by /owa (for example, https://domain.com/owa), where the Outlook Exchange Server or Client Access Server (CAS) is installed. Click Save And Continue.

   

   Note

   If you need to update the REDIRECT URL after this initial setup, a new Configuration file must be downloaded. For more information, see Updating REDIRECT URL.

7. Under Download and Deploy, click the Install Package button to download the installer and the configuration file. You can click HELP to view the agent's documentation.

   

   Note

   The following components will be downloaded:

   • Installation file
   • Configuration file

   Place all the components at the path where the Outlook Exchange is present.

   Note

   Once the agent is successfully downloaded, the application Status will change to active on the STA console. You need to refresh the console page to view any change in the setup Status.

8. Click the Assign tab. Under Assign to Users, select the type of users to whom you want to assign access to the application (as per your requirements).

   

9. Install the agent locally (at the client side) using the installation and configuration files.

Installing the agent

1. Locate and execute the following installation file:

   SafeNet Agent for Microsoft Outlook Web App.exe (64-bit)

2. On the Welcome to the InstallShield Wizard window, click Next.

   

3. On the License Agreement window, read the software license agreement and to proceed, select I accept the terms in the license agreement option, and click Next.

   

   The InstallShield Wizard searches for the agent configuration file (as downloaded from STA) in the background. If the file is available, it skips to step 4. If it is unavailable, it prompts for the following additional requirements:

   a. Authentication Server Pairing: Select the Authentication Server type, STA or SAS Cloud (integrated via Applications), and click Next.

   

   b. Click Change to select the agent configuration file (as downloaded from STA) to update settings. Click Next.

   

   Note

   Click Skip to proceed without selecting an agent configuration file. You can provide the same later, in Communications > Agent Configuration.

4. On the Customer Information window, enter User Name and Organization (any names can be used) and click Next.

   

   Note

   To determine who will have access to the application, select one of the following:

   • Anyone who uses this computer (all users)
   • Only for me (Windows User)

5. On the Destination Folder window, perform one of the following steps:

   • To change the installation folder, click Change and navigate to the required folder, and then click Next.
   • To accept the default installation folder as displayed, click Next.

   

   Note

   • Auto detected or selected Exchange Server version will be displayed at the installation path.
   • We strongly recommend installing the application in a system protected folder accessible only by an account with management (read) privileges. The default location is in the Program Files folder, which is not read protected. This means that the location must be changed to a protected location that cannot be read by non-administrative accounts.

6. On the Ready to Install the Program window, click Install.

   

7. Once the installation is completed, the InstallShield Wizard Completed window is displayed.

   

Agent interaction with Microsoft Exchange Server upgrades

During Microsoft Exchange Server upgrades (Cumulative Updates or Subscription Edition), configuration files may be overwritten; therefore, disable and then re-enable the SafeNet Agent for Microsoft OWA from the agent's administrator interface.

Uninstalling the agent

To uninstall the SafeNet Agent for Microsoft OWA, use the Windows Control Panel. To uninstall, perform the following steps:

1. Navigate to Start > Control Panel > Programs and Features.

2. Select the SafeNet Agent for Microsoft Outlook Web App program.

3. Click Uninstall.

All installed files will be removed except the log files.

The default location for the log files is C:\Program Files\Thales\Exchange\Log.

Upgrading the agent

SafeNet Agent for Microsoft OWA 3.0.0 supports upgrades from 2.1.2 (and later).

Versions of SafeNet Agent for Microsoft OWA prior to 2.1.2 can be migrated to the SafeNet Agent for Microsoft OWA 3.0.0 as described in Migrating the Agent.

Migrating SafeNet Agent for Microsoft OWA

In the existing setup of the agent, perform the following steps:

1. Open the SafeNet Agent for Microsoft Outlook Web App Manager and navigate to File > Export Current Configuration. A file of the settings (Backup.bsidConfig) is created.

   

2. Make a copy of the Backup.bsidConfig file, and save it to the new environment.

3. Edit the Backup.bsidConfig file in the new environment and replace all occurrences of “Gemalto” with “Thales”. This is required because the installation directory name has been changed from “Gemalto” to “Thales". Save the file after making these changes.

   Note

   This step applies only when migrating an existing SafeNet Agent for Microsoft OWA to version 3.0.0 or above.

4. Install the agent on the new environment.

5. Open the newly installed SafeNet Agent for Microsoft Outlook Web App Manager, and navigate to File > Load Saved Configuration.

6. Import the configuration file (as saved in step 2). Navigate to the saved file, Backup.bsidConfig, click Open and import the configuration into the agent.

7. Click Apply to apply the settings.