Skip to main content

Mimecast

Visualize Mimecast accounts, domains, users, map Mimecast users to employees, and monitor changes through queries and alerts.

Installation​

The Mimecast integration ingests account details, internal domains, users, and awareness-training campaigns using the Mimecast API 1.0. Before configuring the integration in JupiterOne, you must create a registered API Application in the Mimecast Administration Console.

Prerequisites​

  • A Mimecast account with admin access — you must have a Mimecast Administrator role to register API applications and generate credentials.
  • Access to JupiterOne with permission to configure integrations.

Creating credentials in Mimecast​

  1. Log in to the Mimecast Administration Console as an administrator.
  2. Navigate to Administration > Services > API and Platform Integrations.
  3. Select the Your Application Integrations category.
  4. Click Add API Application, or open an existing enabled application.
  5. Note the Application ID and Application Key shown on the application page.
  6. If you have not already generated access keys, click Create Keys to generate an Access Key and a Secret Key. Save both values — they are shown only once.

Configuration in JupiterOne​

To install the Mimecast integration in JupiterOne, navigate to the Integrations tab in JupiterOne and select Mimecast. Click New Instance to begin configuring your integration.

Creating an instance requires the following:

  • The Account Name used to identify the Mimecast account in JupiterOne. Ingested entities will have this value stored in tag.AccountName when the AccountName toggle is enabled.

  • Description to assist in identifying the integration instance, if desired.

  • Polling Interval that you feel is sufficient for your monitoring needs. You may leave this as DISABLED and manually execute the integration.

  • Mimecast Access Key — the Access Key generated in the Create Keys step above. This value is used to sign API requests.

  • Mimecast Secret Key — the Secret Key generated in the Create Keys step above. Used together with the Access Key to authenticate requests.

  • Mimecast Application Key — the Application Key for your registered API Application.

  • Mimecast Application ID — the Application ID for your registered API Application.

Click Create once all values are provided to finalize the integration.

Next steps​

Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.