Classifier Mail and Office Add-in Website

VERSION 3.13.1

RELEASE NOTE

Boldon James

April 2022

RN567007

CONTENTS

INTRODUCTION

SYSTEM REQUIREMENTS

INSTALLATION INSTRUCTIONS

FURTHER INFORMATION

DOCUMENTATION

COMPARISON WITH PREVIOUS RELEASES

CONTACT US

1.   INTRODUCTION

Classifier Mail and Office Add-ins provides Classifier functionality in Outlook Web App and Office Online.

The Classifier Mail and Office Add-in Website provides the website that is used by the Classifier Mail and Office Add-ins to provide the Classifier functionality in Outlook Web App and Office Online. The Classifier Mail and Office Add-in manifests require updating with the location of your Classifier Mail and Office Add-in Website installation.

Note: Please ensure Classifier Mail and Office Add-in Website and Manifest file versions are kept in step.  When upgrading the Website the corresponding manifest file must also be upgraded.

Back to contents

2.   SYSTEM REQUIREMENTS

2.1 Software - Server

• Note: 64 bit Versions Only
• Microsoft Windows Server 2016 or Windows Server 2019
• Microsoft .Net Framework 4.7.2
• Web Server (IIS) configured with features detailed in the Installation Instructions section

2.2 Server Sizing and Fault Tolerance

Contact Boldon James for information on the server sizing required to support your Classifier Mail and Office Add-in user numbers.

Multiple servers running the Classifier Mail and Office Add-in Website can be used behind load balancing technology. This is a recommended configuration but is not required. Please note that these multiple servers must be running the same Classifier configuration and policy.

Separate installations of the Classifier Mail and Office Add-in Website can be used for the Classifier Mail and Office Add-ins to allow different Classifier policies to be used for the Classifier Mail and Office Add-ins.

Back to contents

3.   INSTALLATION INSTRUCTIONS

The Classifier Mail and Office Add-in Website is a IIS hosted web application which is installed into an existing IIS website.

Windows Server Component Pre-requisites and Recommendations

Before installing the Classifier Mail and Office Add-in Website the following pre-requisites must be installed on Windows Server 2016 or Windows Server 2019:

• .Net Framework 4.7.2
• .Net Framework feature ASP.NET 4.5
• Web Server (IIS) role configured with the following additional features: Static Content, HTTP Errors, Static Compression, Dynamic Compression, IIS Management Console

The .Net Framework and Web Server (IIS) Roles can be installed using the instructions below:

1. Open Windows PowerShell
2. Run the following command
   Install-WindowsFeature NET-Framework-Core, NET-Framework-45-Core, NET-Framework-45-ASPNET, Web-Static-Content, Web-Http-Errors, Web-Stat-Compression, Web-Dyn-Compression, Web-Mgmt-Console -restart

IIS Website Pre-requisites and Recommendations

Classifier Mail and Office Add-in Website is installed into an existing IIS Website. The IIS Website to be used for the Classifier Mail and Office Add-in Website must have the following pre-requisites:

• Dedicated 64 bit IIS Website configured with a https binding using a SSL certificate.
• The SSL certificate needs to be trusted by the browsers which will be used to access Outlook Web App and Office Online.
• The Website needs to be accessible from the browsers which will be used to access Outlook Web App and Office Online.

It is recommended that the Classifier Mail and Office Add-in Website does not share an IIS Website or Application Pool with any other product and that a dedicated 64 bit IIS Website is created for this product prior to installation.

When the product is installed an IIS Application Pool called "Classifier Mail and Office Add-in Website Application Pool" is created. This IIS Application Pool uses the identity "Network Service".

This App Pool identity must have permissions to allow:

• Read from the location where the Classifer label configuration is published.
• Write to the Event Log to allow the creation of audit and diagnostic information.

Installation

After fulfilling the Windows Server and IIS Website pre-requisites the Classifier Mail and Office Add-in Website can be installed.

Run setup.exe from the installation media. Select the dedicated website created for the Classifier Mail and Office Add-in Website from the list of IIS websites shown during the installation.

The Classifier Mail and Office Add-in Website installer does not support command line or silent installation.

Note: Please ensure Classifier Mail and Office Add-in Website and Manifest file versions are kept in step.  When upgrading the Website the corresponding manifest file must also be upgraded.

Post Installation

Configure the registry keys for the Classifier Label Configuration as detailed by the "Configuration Deployment" section in the "Administration Guide" documentation. The "Administration Guide" is supplied with the Classifier Administration Console

Proxy Server Support

The following registry values can be used to configure proxy server support. Please note that these registry values are only required when a proxy server will be used to access the Exchange Server or Office 365.

HKEY_LOCAL_MACHINE\SOFTWARE\Boldon James\OWA Classifier Service\UseProxyServer

HKEY_LOCAL_MACHINE\SOFTWARE\Boldon James\OWA Classifier Service\UseProxyServerAuthentication

HKEY_LOCAL_MACHINE\SOFTWARE\Boldon James\OWA Classifier Service\ProxyServerURL

UseProxyServer is a DWord registry value. A value data of 1 enables proxy server support. If the registry value is not present or has value data other than 1 then proxy server support is not enabled.

UseProxyServerAuthentication is a DWord registry value. A value data of 1 enables proxy server authentication. If the registry value is not present or has value data other than 1 then proxy server authentication is not enabled. The IIS Application Pool "Classifier Mail and Office Add-in Website Application Pool" identity is used for the proxy server authentication.

ProxyServerURL is a String registry value. The value data is the URL for the proxy server to use. E.g. https://proxy.server:8080/

These registry values are not created by the installer and default configuration is not to use a proxy server.

Closed Network Support

The following registry values can be used to configure closed network support. Please note that these registry values are only required when a closed network is used to access the Exchange Server and clients have no external internet access.

HKEY_LOCAL_MACHINE\SOFTWARE\Boldon James\OWA Classifier Service\ClosedNetwork

ClosedNetwork is a DWord registry value. A value data of 1 enables closed network support. If the registry value is not present or has value data other than 1 then closed network support is not enabled.

Uninstallation

Using Windows "Programs and Features" under Control Panel, select "Boldon James Classifier Mail and Office Add-in Website" and click "Uninstall"

Back to contents

4.   FURTHER INFORMATION

• Modifications to Labelling Policies
  
  Changes to labelling policy do not take effect until after a restart or recycle of the IIS Website where Classifier Mail and Office Add-in Website is installed or the "Classifier Mail and Office Add-in Website Application Pool" IIS Application Pool. This is done through Internet Information Services Manager or on the command line through the Microsoft provided tool.
• Per user label configuration policies are not supported. One label configuration policy applies per machine with the Classifier Mail and Office Add-in Website installed.
• The Classifier Mail and Office Add-in Website uses Exchange Web Services to obtain the information required for the Classifier Mail Add-in to process messages. The Classifier Mail and Office Add-in Website uses a EWS URL obtained from the Mail Add-in. The Classifier Mail and Office Add-in Website requires access to this EWS URL. On Exchange systems this EWS URL needs to use a https connection with a fully trusted SSL certificate.

Back to contents

5.   DOCUMENTATION

The main product suite documentation is installed with the Classifier Administration Console.

Back to contents

6.   COMPARISON WITH PREVIOUS RELEASES

6.1      Classifier Mail and Office Add-in Website version 3.13.1

• Added support for new "Message Body Length" condition type. See the Classifier Administration Server User Guide for more details.

6.2      Classifier Mail and Office Add-in Website version 3.13.0

• Closed Network support
• Rule conditions (Originator email address only)
• Clearance Masking based on Dynamic Clearances (Originator email address only)

6.3      Classifier Mail and Office Add-in Website version 3.12.0

• Added Portion Marking feature
• Support for Windows Server 2019

6.4      Classifier Mail and Office Add-in Website version 3.10.2

• CSD00010472 - Allow Classifier Add-in for OWA to work via Proxy connection.

6.5      Classifier Mail and Office Add-in Website version 3.10.1

• CSD00008275 - Mail Add-ins cannot expand distribution lists. This has been raised to Microsoft as issue 937 for OfficeDev office-js. It is recommended that the Classifier Application Setting "Always use distribution list clearances" is set to Enabled for Outlook Web Access while this Microsoft issue has not been fixed.

6.6      Classifier Mail and Office Add-in Website version 3.10.0

• Support for Windows Server 2016.
• Only messages are supported. Other item types, including meetings and appointments, are not supported.
• Classifier rules checking when a message is sent.
• Classification selection uses a dialog.

6.7      Classifier Mail Add-in Website version 3.8.2

• Updated to use the latest Office JavaScript API from the Microsoft "appsforoffice" Content Delivery Network (000410)
• All clients accessing the Classifier Mail Add-in require an Internet connection to access the Microsoft "appsforoffice" Content Delivery Network.

6.8      Classifier Mail Add-in Website version 3.8.1

• First release.

Back to contents

7.   CONTACT US

All contact with Boldon James regarding this product should be directed to:

Electronic mail	Phone/Fax	Postal address
support@boldonjames.com (support desk) info@boldonjames.com (general enquiries) sales@boldonjames.com (sales team)	Support: +44(0) 1270 507810 Fax.: +44(0) 1270 507801 Tel.: +44(0) 1270 507800 (general and sales enquiries)	Boldon James Ltd, 1 Westmere Court, Westmere Drive, Crewe, Cheshire, England CW1 6ZE

The support services available are as defined in the current support agreement.

Back to contents