Azure Sentinel integration (preview)
Applies to: Microsoft Cloud App Security
Threat protection product names from Microsoft are changing. Read more about this and other updates here. We'll be updating names in products and in the docs in the near future.
You can integrate Microsoft Cloud App Security with Azure Sentinel (a scalable, cloud-native SIEM and SOAR) to enable centralized monitoring of alerts and discovery data. Integrating with Azure Sentinel allows you to better protect your cloud applications while maintaining your usual security workflow, automating security procedures, and correlating between cloud-based and on-premises events.
Benefits of using Azure Sentinel include:
- Longer data retention provided by Log Analytics.
- Out-of-the-box visualizations.
- Use tools such as Microsoft Power BI or Azure Sentinel workbooks to create your own discovery data visualizations that fit your organizational needs.
Additional integration solutions include:
- Generic SIEMs - Integrate Cloud App Security with your generic SIEM server. For information in integrating with a Generic SIEM, see Generic SIEM integration.
- Microsoft security graph API - An intermediary service (or broker) that provides a single programmatic interface to connect multiple security providers. For more information, see Security solution integrations using the Microsoft Graph Security API.
How to integrate
Integrating with your SIEM is accomplished in two steps:
- Set it up in Cloud App Security.
- Set it up in Azure Sentinel.
The option to add Azure Sentinel is not available if you have previously performed the integration.
To integrate with Azure Sentinel:
- You must have a valid Azure Sentinel license
- You must be a Global Administrator or a Security Administrator in your tenant.
Integrating with Azure Sentinel
In the Cloud App Security portal, under the Settings cog, click Security extensions.
On the SIEM agents tab, click add (+), and then choose Azure Sentinel.
In the wizard, select the data types you want to forward to Azure Sentinel. You can configure the integration, as follows:
- Alerts: Alerts are automatically turned on once Azure Sentinel is enabled.
- Discovery logs: Use the slider to enable and disable them, by default, everything is selected, and then use the Apply to drop-down to filter which discovery logs are sent to Azure Sentinel.
Click Next, and continue to Azure Sentinel to finalize the integration. For information on configuring Azure Sentinel, see /azure/sentinel/connect-cloud-app-security.
New discovery logs will start forwarding to Azure Sentinel within 15 minutes of configuring them in the Cloud App Security portal.
Alerts and discovery logs in Azure Sentinel
Once the integration is completed, you can view Cloud App Security alerts and discovery logs in Azure Sentinel.
In Azure Sentinel, under Logs, under Security Insights, you can find the logs for the Cloud App Security data types, as follows:
The following table describes each field in the McasShadowItReporting schema:
|SourceSystem||String||Source system – static value||Azure|
|TimeGenerated [UTC]||DateTime||Date of discovery data||2019-07-23T11:00:35.858Z|
|StreamName||String||Name of the specific stream||Marketing Department|
|TotalEvents||Integer||Total number of events per session||122|
|BlockedEvents||Integer||Number of blocked events||0|
|UploadedBytes||Integer||Amount of uploaded data||1,514,874|
|TotalBytes||Integer||Total amount of data||4,067,785|
|DownloadedBytes||Integer||Amount of downloaded data||2,552,911|
|IpAddress||String||Source IP address||127.0.0.0|
|EnrichedUserName||String||Enriched user name with Azure AD username||
|AppName||String||Name of cloud app||Microsoft OneDrive for Business|
|AppId||Integer||Cloud app identifier||15600|
|AppCategory||String||Category of cloud app||Cloud storage|
|AppTags||String array||Built-in and custom tags defined for the app||["sanctioned"]|
|AppScore||Integer||The risk score of the app in a scale 0-10, 10 being a score for a non-risky app||10|
|Type||String||Type of logs – static value||McasShadowItReporting|
Use Power BI with Cloud App Security data in Azure Sentinel
Once the integration is completed, you can also use the Cloud App Security data stored in Azure Sentinel in other tools.
This section describes how you can use Microsoft Power BI (Power BI) to easily shape and combine data to build reports and dashboards that meet the needs of your organization.
You can get started quickly by using the following steps:
In Power BI, import queries from Azure Sentinel for Cloud App Security data. For more information, see Import Azure Monitor log data into Power BI.
Install the Cloud App Security Shadow IT Discovery app and connect it to your discovery log data to view the built-in Shadow IT Discovery dashboard.
Currently, the app is not published on Microsoft AppSource. Therefore, you may need to contact your Power BI admin for permissions to install the app.
Optionally, build custom dashboards in Power BI Desktop and tweak it to fit the visual analytics and reporting requirements of your organization.
Connect the Cloud App Security app
In Power BI, click Apps, and then click on the Shadow IT Discovery app.
On the Get started with your new app page, click Connect.
On the workspace ID page, enter your Azure Sentinel workspace ID as displayed in your log analytics overview page, and then click Next.
On the authentication page, specify the authentication method and privacy level, and then click Sign in.
After connecting your data, go to the workspace Datasets tab and click Refresh. This will update the report with your own data.
If you run into any problems, we're here to help. To get assistance or support for your product issue, please open a support ticket.