Mimecast Audit and Authentication

Mimecast is a leading cybersecurity company transforming the way businesses manage and mitigate human risk. For detailed information, please refer to the Mimecast official documentation. 

Integration Method: API

Tables: Authentication (3002), User Inventory (5003), Account Change (3001), Group Management (3006)

This integration supports the following events.

This integration supports the following versions.

Note:

Mimecast is a continuously updated cloud service. As for this document preparation, the latest release was on February 17, 2025. For more information, refer here.

Prerequisites

• The user should have access to the Mimecast portal with an account that has the Administrator privileges. 

• The user should have access to the DataBee console.

Configuration Overview

1. Generate the API token with the required scopes

2. Add the Mimecast Audit and Authentication data feed in the DataBee console with the below parameters.

   DataBee Parameter	Mimecast Parameter
   Client Key	Client Id
   Client Secret	Client Secret

Mimecast Audit and Authentication Configuration

1. Login to the Mimecast portal and click on Administration Console.

   
   

2. In the “Administration Console” page, click on Services and then click on API and Platform Integrations.
    
   

3. In the “API and Platform Integrations” page, under Available Integrations, click on Generate Keys below the Mimecast API 2.0.
    
   

4. Review and acknowledge the “Disclaimers” page.

   
   
   

5. In the “Details” page, fill in the details for application name and in the ‘Category’ drop down, click on Other.
    
   

6. In the ‘Products’ drop down, select User and Group Management and Audit Events and click APPLY.
    

7. In the ‘Application Role’ drop down, select Basic Administrator.
    

8. Write a ‘Description’ for the key and then click on Next.
    

9. In the “Notification Settings” page, enter the required details for ‘Technical Point of Contact’ and ‘Email’ and click Next.
    
   

10. In the “Summary” page, review the details and click Add and Generate Keys.
     

11. Copy the Client Id and Client Secret and click Close.
     

    Note:

    The Client Secret cannot be retrieved after this, so make sure you have copied this to a secure place.

DataBee Configuration

1. Login to the DataBee UI, navigate to Data > Data Feeds and click the Add New Data Feed button.
    
   

2. Search for the Mimecast Audit and Authentication and click it as shown below.
    

3. Click on the API Ingest option for collection method.
    
   

4. Enter feed contact information and click Next.
    

5. In the configuration page, confirm the following:

   • Authorization Method: OAuth2

   • API Base URL: this is the base URL that DataBee will interact with.

   • Client Key: paste the Client Key which was copied earlier.

   • Client Secret: paste the Client Secret which was copied earlier.

   • Token URL: this is the token URL that DataBee will interact with.

   • Event Types: preselected for all the event types that integration pulls.  

   

6. Click Submit.

Troubleshooting Tips

• Ensure the client key and secret is pasted correctly. Since you cannot view the secrets after the 1^st time, re-create the secrets, paste it on a text editor to ensure no spaces or unexpected characters are included and reconfigure the DataBee feed.

• Ensure the Mimecast scopes/permissions are correct.