Overview

This article describes how to enable Forms-Based Authentication in Archiver. Forms-based authentication is typically used when users connect to Archiver outside of your local domain, such as the Internet.

Environment

The Authentication Tool is only available from MailArchiver 2013 or newer.

Process

By default, Archiver uses windows based authentication when authenticating users. Archiver also supports forms-based authentication. Use the following procedure to switch from windows based authentication to forms based authentication:

Authentication Tool (recommended)

1. Run the tool: ..\InstallationFolder\Tools\ChangeAuthentication\GFIChangeAuthenticationTool.exe
2. It will show the currently configured mode and allow to switch to the other.

Manual Procedure

Note: This procedure requires to edit files manually. If edited incorrectly it can leave the server in a non-operational state. Please keep backups of any file which is edited throughout this article before saving any changes to them.

1. Open the following file in Notepad: ..\InstallationFolder\ASPNET\UI\web.config
2. Change <add key="AuthenticationMode" value="Windows"/> to <add key="AuthenticationMode" value="Forms"/> 
3. Change <authentication mode="Windows"/> to <authentication mode="Forms"/>
4. Save the file.
5. You might need to close/reopen or clear the cookies your browser after switching the authentication mode.

Note: When upgrading to a newer version of GFI Archiver, installation files mentioned in this procedure will be overwritten with default versions making the changes void and ineffective. It is therefore suggested to keep a record of this procedure and follow it once again directly after upgrading to keep this functionality intact.