Teams integration setup

harmon.ie for Outlook Knowledge Base

The integration of harmon.ie with Teams channels allows users to capture and share emails and attachments in Teams channels. This feature can be enabled when working with Microsoft 365.

This article explains how to configure harmon.ie with Teams for new and existing harmon.ie users.

Setup for new and existing users:

  1. Log into the download area and click the Outlook Edition + Teams button.
  2. To download this package, login as an Microsoft 365 global administrator and Accept the requested permissions. This step is done once for all harmon.ie users.
  3. After accepting the requested permissions, harmon.ie is automatically downloaded.
  4. Follow the installation instructions in the administration guide.
  5. Instruct your users to launch harmon.ie, click the Let's Begin button, and select their favorite teams and channels.

What are the requested permissions and why are they required?

harmon.ie uses Azure Active Directory v1.0 endpoint's permissions and consent.

Here are the requested permissions, and why they are required:

  • Read all files that user can access ‐ get all files the signed-in user can access.
  • Read all groups ‐ get the list of the Teams and Groups the singed-in user is a member of.
  • Read and write all groups ‐ get the list of the Teams and Groups the singed-in user is a member of.
  • Read items in all site collections ‐ get the documents of all Teams, Groups and site collections the signed-in user can access.
  • Sign in and read user profile ‐ get the details of the current user's profile.
  • Access mailboxes as the signed-in user via Exchange Web Services ‐ save and retrieve emails from the Team mailbox.
  • Access the directory as the signed-in user ‐ authenticate the user.

Security note: harmon.ie only asks for delegated permissions, and not for application permissions. The effective permissions are the least privileged intersection of the delegated permissions harmon.ie has been granted (through consent) and the privileges of the currently signed-in user. harmon.ie cannot have more privileges than the signed-in user. As a result, harmon.ie users can never access SharePoint content they are not authorized to view. For more information, read Permissions and consent in the Azure Active Directory v1.0 endpoint.

To verify that harmon.ie consent is properly configured:

To verify that harmon.ie's requested permissions are probably configured:

  1. Open Azure Active Directory > Enterprise applications.
  2. Search for the harmon.ie Application ID: 10301466-86cc-4cb9-9007-a23f1a4c5ac8.
  3. Click the harmon.ie app and select Permissions.
  4. Verify that all permissions are marked as granted.

Known issues:

  • Emails formatted as RTF cannot be saved to a channel.
  • Archived Teams are not marked as such. As a result, users may try to save emails to archived Teams and fail.
  • If the Team was created from an existing team, the channel's corresponding SharePoint folder is not created immediately. As a result, upload to newly created teams may fail. To fix this, manually access the channel's Files tab. This action creates the channel's folder. Then, try again.

Manually enable Teams integration:

If you downloaded the harmon.ie Enterprise package that doesn't include the enabled Teams integration, you can still enable Teams integration manually:

  1. An Microsoft 365 global administrator should click the Consent link for integrating with Teams channels. See list of requested permissions above.
  2. Add the SupportTeamChannels String Value to the Office365GroupsInfo provisioning key, and set its value to True for all users. You may use this sample registry file for assistance.