You can use your Mimecast account alongside HighGround to retrieve your Email Filtering data. This data can then be used to drive your Cyber KPI's. In order to synchronise this data to your HighGround account, you will need to connect to Mimecast's API by first generating API credentials, and then integrating the tool via the Integrations module.

The following process is reasonably technical, so please have a member of your IT team complete this if you do not have any prior experience with API's.

Please follow the steps below to generate API credentials for Mimecast first, before moving onto our guide on How to Integrate a tool with your HighGround account.

​

Login to your Mimecast account.

Click on the Administration tab at the top of the page, then select Directories, and Internal Directories:

You should now see a list of your domains.

The next step will involve creating a new email address to be used for the API connection. Click on the domain that you would like to add this email address to.

To create the new email address to be used for the API connection, click the New Address option from the row at the top:

This will open a new window for you to add the details of the new address.

When you've entered those details, click Save and Exit to continue.

Now you've created the new user, click on Administration again, then go to Directories and Profile Groups.

Once in Profile Groups, look to the folder tree at the left of the window. You want to create two new folders underneath the Root folder.

To do so, click the little orange + located at the bottom-right of the folder icon:

There should now be a New Folder located as a sub-folder underneath Root:

At the top of the folder tree, you will see an area titled Edit Group that looks like below:

Change this text from 'New Folder' to 'Admin' and hit the Enter key.

Repeat this process again, this time creating another New Folder named API Account.
​
​

You will now need to add the email address of the apiuser account you created in step 1 to the API Account folder.

To do so, click on the API Account folder, then click Build and Add Email Addresses:

This will open another window containing a box for you to enter the email address:

In the details box below this, you may also want to add a note describing 'Used for HighGround Integration'.

Once you have added those details, click Save and Exit to continue.

To the Admin folder that you made, add all of your users that are assigned to the roles Super Administrator or Full Administrator.

You now need to assign the apiuser you made to a Basic Administrator role.

To do so, go to the Roles page located under Account:

From the list of administrative roles you should now see, click on Basic Administrator:

Next, click on the Add User to Role button located at the top-left of the window:

Use the search bar to find the apiuser account.

Once you've located the apiuser account, tick the box next to the account, and then click the Add Selected Users button located near the top-left of the window:

The account will now be assigned to the Basic Administrator role.

You now need to create a new authentication profile.

To do so, go to Services, then Applications:

From the top row of tabs, select Authentication Profiles:

Next, in the new window, select the tab New Authentication Profile:

Give the authentication profile a description of 'API Profile' and ensure the Authentication TTL setting is set to 'Never Expires' (the rest of the settings can remain as default):

You can now chick Save and Exit, and you will see your new authentication profile displayed in the list.

Go back to Applications, then right-click on Default Application Settings, and select Clone Configuration.

You will now see various settings which you can configure:

You can leave the rest of the settings as default.

Click Save and Exit to continue.

You can now move on to setting up the API Integration. To do so, you will first need to login to Mimecast again using the apiuser account your created in step 2.

You will see a pop-up window notifying you of the below, click Got It:

In the tabs near the top of API and Platform Integrations, select Your Application Integrations:

Once in your application integrations, click the Add API Application button:

You will now see the first window where can add the details of the API Application.

For these details;

After adding those details, click the Next button to continue:

In the second window you should;

Click the Next button again to continue, and you should see the final Summary window:

​

Check that all the details are correct, then click Add to finish adding the API application.

After clicking Add, you will see a window resembling the one below:

First, click the copy icons located next to the Application ID and Application Key. Paste these to keep as a note somewhere on your PC. You will need these again later on.

Second, click the Create Keys button to begin the process of generating the API keys you will need for the integration.

You should now see a window resembling the screenshot below. This is where you create the account that will be used to authenticate the API connection.

Click Next to continue:

In the second window;

Mimecast will now use those credentials to verify the account. If the email and password are valid, you should now see a window like the one below:

Copy the Access Key and Secret Key, and paste these to keep as a note somewhere on your PC. You will need these in the next step.

You can now use the API Keys retrieved in the previous steps to integrate the tool to your HighGround account.

To do so, you will need to go to the Integrations area of your HighGround account, and find the Mimecast tool under the Email Filtering technology. Clicking on 'Connect Tool' will open a window for you to enter your API credentials:

For the first field - URL - you will need to enter one of the URL's from the table below (selecting the correct option for your region):

For the remaining field, enter the Keys and ID that you retrieved in the two previous steps of this guide.

After, continue in the integration window pictured above to complete the process of connecting your Mimecast account.

If you are unsure of how to complete the integration, you can look at our guide on How to Integrate a tool with your HighGround account.

​