EL mailarchive Outlook App Deployment

EL mailarchive Outlook App Deployment

Requirements for using the Outlook app integration

- The new Outlook from the Microsoft 365 Apps for Enterprise package is required.
- The new Outlook must be linked to a Microsoft 365 account.
- The MailStore Outlook app must have been published by an administrator in the client’s Outlook App Store.
- Administrative access to the Microsoft 365 tenant.
- MailStore requires a trusted certificate. This can be obtained from Let’s Encrypt or another certificate authority.

 

To use the MailStore Outlook app with the new Outlook, a manifest tailored to your installation must be generated.

The manifest describes how your MailStore installation can be accessed from within Outlook.

This manifest can be uploaded to your Microsoft 365 tenant’s App Store. This makes the MailStore Outlook App available in the Outlook App Store, and it can either be centrally assigned to users by administrators via a policy, or users can add the app from the App Store within their Outlook installation.

 

Due to caching within the Microsoft 365 infrastructure, changes may not be visible immediately. These delays can occur in both the Microsoft Teams Admin Centre and the new Outlook.

Generating the manifest

In addition to the MailStore hostname, the manifest also contains a unique ID that identifies the app in the Outlook App Store. The ID is permanently stored by MailStore and remains constant for each installation, so that it is carried over when further manifests are generated and the app can continue to be identified by the same ID. This enables the existing app to be updated should the hostname under which MailStore is accessible change.

 

Manifests must therefore always be generated on the server to which the corresponding Outlook app is intended to connect.

One of the hostnames stored in the certificate must be used in the manifest so that Outlook allows a connection to MailStore.

 

- Open the Email Archive Client and connect to an instance as an administrator.

- Go to Administration > Miscellaneous > Deployment.

- Click Download and select the destination file to download the manifest.

Installation

- Log in to the Microsoft Teams Admin Centre.

- Go to Teams apps > Manage apps.

- Click Actions > Upload new app.

- Click Upload and select the manifest you generated earlier.

- Once the upload is complete, the app can be found by searching for ‘MailStore’ or the name you chose for your branding.

- Select the app and click on Users and Groups.

- Publish the app.

- End users can now find the app in the App Store within Outlook and add it to their Outlook.

- You can also assign the app to users via a policy; to do this, click on Deployment Policies.

- Add a new policy or edit an existing one.

- Configure the policy to suit your requirements.

Update

The manifest must be updated if the hostname under which MailStore is accessible has changed.

Create a new manifest as described in the ‘Installation’ section.

- Log in to the Microsoft Teams Admin Centre.

- Go to Teams Apps > Manage apps.

- Select the existing app from the list of apps.

- Click ‘Upload file’ on the overview tile and select the manifest you generated earlier.