Mimecast

InsightConnect features a plugin for the Mimecast software, a cloud cybersecurity email service, that allows you to permit or block senders, manage URLs, and manage group members. Deploying this plugin involves the following steps:

  1. Setting up a Mimecast API application
  2. Creating an API key and a Secret key
  3. Configuring the connection in InsightConnect

For more information on the functionality of the Mimecast plugin, see the Extension Library listing.

Create an API Key in Mimecast

Begin by logging in to Mimecast’s admin portal. Go to Administration > Services API > Applications.

Main Page

From here, create a new API Application.

App Page

In step 1, give your application a name. This name can be anything according to your preference, but we recommend InsightConnect. Set Category to Process Automation and make sure the Service Application box is checked. Finally, give your application a suitable description.

App Setup Part One

In step 2, add a developer name and email address. These should correspond to the name and email address of the person who is responsible for your InsightConnect application.

App Setup Part Two

In step 3, review everything you have entered so far.

App Setup Part Three

At this point you will be given your Application ID and your Application Key. You will need both of these for the InsightConnect connection.

App Keys

As shown in step 3 of creating the application, you will have to wait 30 minutes before creating an API access and secret key.

After this 30 minute period, you can create the API access and secret key. Click the 3 dots next to your application and select Create keys.

Create Keys

In step 1, enter the email address of the logged-in administrator.

Create Keys Setup Part One

In step 2, authenticate this administrator.

Create Keys Setup Part Two

In step 3, copy the access and secret keys. Note that once you leave this page you will not be able to access these keys again.

Create Keys Setup Part Three

Mimecast is now configured to allow API access.

Configure the Mimecast Connection in InsightConnect

Pivoting over to InsightConnect, open the connection configuration for the Mimecast plugin. You can do this when selecting the Mimecast plugin during a workflow building session or by creating the connection independently by choosing Plugins & Tools from the Settings menu on the left menu. On the Plugins & Tools page, select the Connections tab and then click Add Connection in the top right corner.

Plugins and Tools

Now it's time to configure the connection for the Mimecast plugin. Give a unique and identifiable name to the Connection, select the orchestrator the plugin should run on, and choose the Mimecast plugin from the list. If it’s not available, then import the plugin from the Installed Plugins tab. At this point, it’s time to configure your Mimecast credentials and server information. These configurations are necessary for InsightConnect to automate your processes with Mimecast. Enter your access and secret keys into their corresponding fields. Set the URL as the API access URL for your Mimecast instance. This will normally be https://api.mimecast.com.

Configure ConnectionConfigure Connection Two

Upon saving the connection, the connection test will attempt to authenticate to the Mimecast server. A circle on the Connection tile indicates that the Connection test is in progress.

Success

If the test succeeds, your Connection tile will appear in this clean state. You’re ready to begin orchestrating your processes with Mimecast.

If the test fails, your Connection tile will display a small red circle. If this occurs, double-check your connection details including the server URL and credentials. You can check the logs for more details which may further indicate the problem by clicking View, selecting Test Status, and choosing the dropdown on the error status.

Failure

Test Status