Mimecast Awareness Training

Mimecast cyber awareness training is based on learning science that suggests lasting, meaningful behavioral change requires learning that is engaging, persistent and nonintrusive. This helps employees become more aware of the risks of phishing and other targeted attacks. For detailed information, please refer to the Mimecast official documentation.

Integration Method: API

Tables: Training Inventory (99405002)

This integration supports the following events.

This integration supports the following versions.

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 client credentials with the required scopes to access API.

2. Add the Mimecast Awareness Training data feed in the DataBee console with the below parameters.

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

Mimecast Awareness Training 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. In the “Disclaimers” page, acknowledge the terms after reviewing.

   
   

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 Awareness Training and click APPLY.
     

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

8. Fill in the ‘Description’ field and then click on Next.
    
   

9. In the “Notifications” page, write the required details and click Next. 
    

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

     
     

11. Copy both the Client Id and Client Secret by clicking the respective copy icon and store somewhere safe as it will be required later. Click Close after copying. 
     

    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 Awareness Training 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 Id 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 token is pasted correctly. Since you cannot view the token after the 1^st time, re-create the token by following configuration steps, paste it on a text editor to ensure no spaces or unexpected characters are included and reconfigure the DataBee feed.

• Ensure the scopes/permissions are correct.