Onboard Microsoft Sentinel

In this quickstart, you'll enable Microsoft Sentinel and install a solution from the content hub. Then, you'll set up a data connector to start ingesting data into Microsoft Sentinel.

Microsoft Sentinel comes with many data connectors for Microsoft products such as the Microsoft Defender XDR service-to-service connector. You can also enable built-in connectors for non-Microsoft products such as Syslog or Common Event Format (CEF). For this quickstart, you'll use the Azure Activity data connector that's available in the Azure Activity solution for Microsoft Sentinel.

To onboard to Microsoft Sentinel by using the API, see the latest supported version of Sentinel Onboarding States.

Prerequisites

• Active Azure Subscription. If you don't have one, create a free account before you begin.

• Log Analytics workspace. Learn how to create a Log Analytics workspace. For more information about Log Analytics workspaces, see Designing your Azure Monitor Logs deployment.

  You may have a default of 30 days retention in the Log Analytics workspace used for Microsoft Sentinel. To make sure that you can use all Microsoft Sentinel functionality and features, raise the retention to 90 days. Configure data retention and archive policies in Azure Monitor Logs.

• Permissions:

  • To enable Microsoft Sentinel, you need contributor permissions to the subscription in which the Microsoft Sentinel workspace resides.

  • To use Microsoft Sentinel, you need either Microsoft Sentinel Contributor or Microsoft Sentinel Reader permissions on the resource group that the workspace belongs to.

  • To install or manage solutions in the content hub, you need the Microsoft Sentinel Contributor role on the resource group that the workspace belongs to.

  • If you are a new Microsoft Sentinel customer and have permissions of a subscription Owner or a User access administrator, your workspace is automatically onboarded to the Defender portal. Users of such workspaces use Microsoft Sentinel in the Defender portal only.

• Microsoft Sentinel is a paid service. Review the pricing options and the Microsoft Sentinel pricing page.

• Before deploying Microsoft Sentinel to a production environment, review the predeployment activities and prerequisites for deploying Microsoft Sentinel.

Enable Microsoft Sentinel

To get started, add Microsoft Sentinel to an existing workspace or create a new one.

1. Sign in to the Azure portal.

2. Search for and select Microsoft Sentinel.

   

3. Select Create.

4. Select the workspace you want to use or create a new one. You can run Microsoft Sentinel on more than one workspace, but data is isolated to a single workspace.

   

   • The default workspaces created by Microsoft Defender for Cloud aren't shown in the list. You can't install Microsoft Sentinel on these workspaces.
   • Once deployed on a workspace, Microsoft Sentinel doesn't support moving that workspace to another resource group or subscription.

5. Select Add.

Access Microsoft Sentinel in the Defender portal

This procedure is relevant if you're automatically onboarded to the Defender portal, or if you choose to onboard your workspace to the Defender portal after enabling Microsoft Sentinel.

To access Microsoft Sentinel in the Defender portal:

1. Sign into the Defender portal.

   The first time you access the Defender portal, it'll take some time to provision your tenant.

2. Once provisioned, you'll see Microsoft Sentinel available in the navigation pane, with Microsoft Sentinel nodes nested within. For example:

   

3. Scroll down in the navigation pane, and select Settings > Microsoft Sentinel > Workspaces to view the workspaces onboarded to the Defender portal and available to you.

The Defender portal supports multiple workspaces, with one workspace acting as the primary workspace per tenant. For more information, see Multiple Microsoft Sentinel workspaces in the Defender portal and Microsoft Defender multitenant management.

Install a solution from the content hub

The content hub in Microsoft Sentinel is the centralized location to discover and manage out-of-the-box content including data connectors. For this quickstart, install the solution for Azure Activity.

1. In Microsoft Sentinel, browse to the Content hub page, and find and select the Azure Activity solution.

   • Defender portal
   • Azure portal

   

1. On the solution details pane on the side, select Install.

Set up the data connector

Microsoft Sentinel ingests data from services and apps by connecting to the service and forwarding the events and logs to Microsoft Sentinel. For this quickstart, install the data connector to forward data for Azure Activity to Microsoft Sentinel.

1. In Microsoft Sentinel, select Configuration > Data connectors and search for and select the Azure Activity data connector.

2. In the connector details pane, select Open connector page. Use the instructions on the Azure Activity connector page to set up the data connector.

   1. Select Launch Azure Policy Assignment Wizard.

   2. On the Basics tab, set the Scope to the subscription and resource group that has activity to send to Microsoft Sentinel. For example, select the subscription that contains your Microsoft Sentinel instance.

   3. Select the Parameters tab, and set the Primary Log Analytics workspace. This should be the workspace where Microsoft Sentinel is installed.

   4. Select Review + create and Create.

Generate activity data

Let's generate some activity data by enabling a rule that was included in the Azure Activity solution for Microsoft Sentinel. This step also shows you how to manage content in the content hub.

1. In Microsoft Sentinel, select Content hub and search for and select Suspicious Resource deployment rule template in the Azure Activity solution.

2. In the details pane, select Create rule to create a new rule using the Analytics rule wizard.

3. In the Analytics rule wizard - Create a new Scheduled rule page, change the Status to Enabled.

   On this tab and all other tabs in the wizard, leave the default values as they are.

4. On the Review and create tab, select Create.

View data ingested into Microsoft Sentinel

Now that you've enabled the Azure Activity data connector and generated some activity data let's view the activity data added to the workspace.

1. In Microsoft Sentinel, select Configuration > Data connectors and search for and select the Azure Activity data connector.

2. In the connector details pane, select Open connector page.

3. Review the Status of the data connector. It should be Connected.

   

4. Select a tab to continue, depending on which portal you're using:

   • Defender portal
   • Azure portal

   1. Select Go to log analytics to open the Advanced hunting page.

   2. On the top of the pane, next to the New query tab, select the + to add a new query tab.

   3. Run the following query to view the activity date ingested into the workspace:

      AzureActivity
      

   For example:

   

Next steps

In this quickstart, you enabled Microsoft Sentinel and installed a solution from the content hub. Then, you set up a data connector to start ingesting data into Microsoft Sentinel. You also verified that data is being ingested by viewing the data in the workspace.

If you're a new customer who's been automatically onboarded to the Defender portal, your users will access Microsoft Sentinel in the Defender portal only. As you use the Microsoft Sentinel documentation, make sure to select the Defender portal version of the documentation.

• To visualize the data you've collected by using the dashboards and workbooks, see Visualize collected data.
• To detect threats by using analytics rules, see Tutorial: Detect threats by using analytics rules in Microsoft Sentinel.