Mimecast Awareness Training (using Azure Functions) connector for Microsoft Sentinel
The data connector for Mimecast Awareness Training provides customers with the visibility into security events related to the Targeted Threat Protection inspection technologies within Microsoft Sentinel. The data connector provides pre-created dashboards to allow analysts to view insight into email based threats, aid in incident correlation and reduce investigation response times coupled with custom alert capabilities.
The Mimecast products included within the connector are:
- Performance Details
- Safe Score Details
- User Data
- Watchlist Details
This is autogenerated content. For changes, contact the solution provider.
Connector attributes
| Connector attribute | Description |
|---|---|
| Log Analytics table(s) | Awareness_Performance_Details_CL Awareness_SafeScore_Details_CL Awareness_User_Data_CL Awareness_Watchlist_Details_CL |
| Data collection rules support | Not currently supported |
| Supported by | Mimecast |
Query samples
Awareness_Performance_Details_CL
Awareness_Performance_Details_CL
| sort by TimeGenerated desc
Awareness_SafeScore_Details_CL
Awareness_SafeScore_Details_CL
| sort by TimeGenerated desc
Awareness_User_Data_CL
Awareness_User_Data_CL
| sort by TimeGenerated desc
Awareness_Watchlist_Details_CL
Awareness_User_Data_CL
| sort by TimeGenerated desc
Prerequisites
To integrate with Mimecast Awareness Training (using Azure Functions) make sure you have:
- Azure Subscription: Azure Subscription with owner role is required to register an application in Microsoft Entra ID and assign role of contributor to app in resource group.
- Microsoft.Web/sites permissions: Read and write permissions to Azure Functions to create a Function App is required. See the documentation to learn more about Azure Functions.
- REST API Credentials/permissions: See the documentation to learn more about API on the Rest API reference
Vendor installation instructions
Resource group
You need to have a resource group created with a subscription you are going to use.
Functions app
You need to have an Azure App registered for this connector to use
- Application Id
- Tenant Id
- Client Id
- Client Secret
Note
This connector uses Azure Functions to connect to a Mimecast API to pull its logs into Microsoft Sentinel. This might result in additional data ingestion costs. Check the Azure Functions pricing page for details.
(Optional Step) Securely store workspace and API authorization key(s) or token(s) in Azure Key Vault. Azure Key Vault provides a secure mechanism to store and retrieve key values. Follow these instructions to use Azure Key Vault with an Azure Function App.
Configuration:
STEP 1 - Configuration steps for the Mimecast API
Go to Azure portal ---> App registrations ---> [your_app] ---> Certificates & secrets ---> New client secret and create a new secret (save the Value somewhere safe right away because you will not be able to preview it later)
STEP 2 - Deploy Mimecast API Connector
IMPORTANT: Before deploying the Mimecast API connector, have the Workspace ID and Workspace Primary Key (can be copied from the following), as well as the Mimecast API authorization key(s) or Token, readily available.
Azure Resource Manager (ARM) Template
Use this method for automated deployment of the Mimecast Awareness Training Data connector.
Click the Deploy to Azure button below.
Select the preferred Subscription, Resource Group and Region.
Enter the below information : Workspace ID Workspace Key Base URL (Default: https://api.services.mimecast.com) Mimecast Client ID Mimecast Client Secret Log Level (Default: INFO) Schedule (0 0 */1 * * *) App Insights Workspace Resource ID
Mark the checkbox labeled I agree to the terms and conditions stated above.
Click Purchase to deploy.
Next steps
For more information, go to the related solution in the Azure Marketplace.