Content Handler hotfix for expiring SSL certificate - FAQ (July 2023)

Why was I informed that I need to update Content Handler?

The notification was sent out because previous releases of the Locator 5.x Content Handler we publish have shipped with an SSL certificate that expires September 12th, 2023.

An updated version of Content Handler has been released with a new certificate that will last until July 29th, 2024.

What is the Content Handler?

Content Handler is a user-side extension (installed on end-user machines, i.e. workstations) that allows users of your Locator 4.x and newer installation to open documents in native applications on their workstation directly from the search results page if those documents came from one of the following supported data sources: Alfresco, Domino, EdocsDM, Exchange, Fileserver, LoboDMS, Worksite.

You can find out more about the Content Handler in the https://ayfie-dev.atlassian.net/wiki/spaces/SAGA/pages/2400714758 and Ayfie Locator Architectural Overview

What is the Document Handler?

Document Handler was an extension analogous to Content Handler, but used with Locator 2.x . The two extensions are not cross-compatible and should not be installed concurrently on the user’s system.

If I have received the notification, does it mean my users are affected?

No. The notification was sent to all active customers, as the Content Handler does not require a separate license and any customer could be using it - we have no way to determine this on our side.

Content Handler: How to determine if my users are affected?

• Are you using the ContentHandler in your organization?

  • If no, then your users are not affected

  • If yes, then your users are affected

Do I need to update Locator and/or Supervisor?

Maybe.

If you are still using Locator 4.x, you will first need to migrate to Locator 5.x according to the migration procedure documented in https://ayfie-dev.atlassian.net/wiki/spaces/SAGA/pages/2400714758.

If you are using Locator 5.x with the multi-user version of Content Handler and deploying it through group policy, updating Locator is not needed.

If you are using Locator 5.x with the single-user version of Content Handler and let the users install it themselves, they can only obtain it through a download link in the Locator 5.x UI. You will need to restart your Locator installation for it to update automatically (https://ayfie-dev.atlassian.net/wiki/spaces/SAGA/pages/2400714758 under “Starting and Stopping”) and serve the correct download.

Upgrade Instructions

Single-user version of Content Handler can be installed by the users themselves, provided you supply them with the correct installer.

Rollouts of the multi-user version of Content Handler should be handled by your IT.

Content Handler (Multi-User)

The download link and instructions to roll out the multi-user version of Content Handler are available under the “Content Handler” section of

What is the impact of an outdated Content Handler certificate?

• Locator search will continue to work

• Opening documents that are viewed through the web browser (e.g. Sharepoint Online) will continue to work

• Downloading documents will continue to work

• Document previews will continue to work

Content Handler

The Content Handler installation check (ran from the Locator 4.x/5.x Search UI) does not persists its' result.

• Content Handler will not work and Locator will behave as if it is not installed

How to override the installation check?

There is no option to override the installation check for Content Handler.

A note on upgrading the Content Handler

While installing the new version over an already installed previous one will work, certain Registry entries relating to the previous version of Content Handler will remain, causing both to appear in the Add/Remove Programs dialog. This can be avoided by uninstalling the old version before installing the new one.
This has been reviewed by the development team and determined to be a non-critical cosmetic issue that should not take priority over making the fixed Content Handler available to customers.