Centrally Configure New harmon.ie for All Users

This guide explains how administrators can centrally configure New harmon.ie for all users.

Configuration methods

New harmon.ie can be configured using two methods:

  1. Admin tab in harmon.ie – Modify settings directly within the harmon.ie app.
  2. Configuration file in SharePoint – Edit configuration file for custom settings.

When to use each configuration method

The two methods are linked. Each change you make in the Admin tab is reflected in the configuration file and vice versa.

The configuration file lets admins configure settings that are not available in the Admin tab, for example, configuring custom email header mapping.

What can be centrally configured

  • Custom email header mapping
  • Visibility of Microsoft 365 apps

How to set up the configuration for New harmon.ie

Steps:

  1. (Optional) Create a subsite called harmon.ie Admin.
  2. Create a document library called harmon.ie Files and set access permissions.
  3. (Optional) Create a configuration file and place it in the library.

Every harmon.ie user should have read access to harmon.ie Files while only designated administrators should have edit permission.

Where to create the harmon.ie files library

The harmon.ie Files library should be created in one of the following locations:

  • Under the Root Site – Recommended for a simple, centralized setup. Requires that all users can access the root site.
  • Under a “harmon.ie Admin” Subsite – Choose this option if root site access is restricted for some users.

1. (Optional) Create a “harmon.ie Admin” subsite:

If you don’t want or can’t create the harmon.ie Files library in the root site, you may create it under a subsite.

a. Create subsite:

  1. In the root site, go to Settings > Site contents > New > Subsite.
  2. Name the subsite harmon.ie Admin. The name could not be changed.

b. Set permissions:

  1. Create or use an existing SharePoint group to specify the harmon.ie Administrators.
  2. Use unique permissions for the subsite and remove all users except harmon.ie Administrators and site owners.

c. (Recommended) Hide the “harmon.ie Admin” subsite:

  1. Remove it from the navigation bar.
  2. Exclude it from search indexing:
    1. Go to Site settings > Search and Offline Availability.
    2. Set Allow this site to appear in search results? to No.

2. Create the “harmon.ie Files” document library

a. Create document library:

  1. Navigate to the root site or the subsite created above.
  2. Click Settings > Site contents.
  3. Click New > Document library.
  4. Name the library harmon.ie Files. The name could not be changed.
  5. Ensure the Show in navigation option is unchecked and click Create.

b. Set permissions:

  1. Remove existing permissions: Remove all existing user groups except for the Site owners group. This ensures that only the specified administrators have access to the library.
  2. Grant read-only access for all users: Add the group Everyone except external users with Read permissions.
  3. Grant edit access for harmon.ie administrators: Create or use an existing SharePoint group to specify the harmon.ie Administrators. Add this group with Edit permissions.

c. (Recommended) Hide the harmon.ie Files library:

  1. Hide from navigation:
    1. Go to Settings > Site settings > Navigation Elements.
    2. Uncheck Display the Quick Launch or manually remove the library link from the navigation bar.
  2. Exclude from search indexing:
    1. Go to Settings > Library settings.
    2. Under General Settings, click Advanced settings.
    3. Set Allow items from this document library to appear in search results? to No.

Based on the location where you created the “harmon.ie Files” document library, its URL should follow one of these formats:

  • https://<your-tenant-prefix>.sharepoint.com/harmonie%20Files
  • https://<your-tenant-prefix>.sharepoint.com/harmon.ie%20Admin/harmonie%20Files

3. (Optional) Create a configuration file for New harmon.ie

New harmon.ie’s configuration file is a .json file that holds the settings for all users.

harmon.ie automatically creates a default configuration file, which you can edit.

To edit the configuration file:

  1. Download new-harmonie-config.zip and extract it to a local folder.
  2. Edit the .json file:
  3. Add the file to New harmon.ie:
    • Upload it to the harmon.ie Files document library.
    • Or, import it via the Admin tab in harmon.ie settings.

Configuring New harmon.ie using the Admin tab

The Admin tab is available for users in the harmon.ie Administrators group.

Any change made in the Admin tab affect all New harmon.ie users.

Understanding the Admin tab in New harmon.ie settings:

You can perform the following tasks using harmon.ie’s Admin tab:

  • Hide OneDrive and/or Teams – Toggle the settings off.
  • Import a new configuration file – Click Import settings and select the .json file you want to import.
  • View the configuration file – Click View settings. This option is available after importing a configuration file.
  • Click Apply to update settings for all users, or Discard to exit without saving.

Admin tab of New harmon.ie settings

How to add an administrator for New harmon.ie

To define a person as a New harmon.ie administrator, add them to the harmon.ie Administrators group that has Edit permissions in the harmon.ie Files document library.

This will add the Admin tab to the New harmon.ie settings dialog for this person, where they can edit the options for all users.