Microsoft Defender XDR
Hunting and detection

Update workbooks to use Advanced Hunting data - Microsoft Defender XDR | Microsoft Learn

In brief

The documentation now explains that workbooks can use Advanced Hunting without ingesting the same data into a workspace. It also adds guidance for updating existing workbooks and clarifies that queries enforce the user's underlying data permissions.

What Defender admins need to know

Ensure workbook users have the required Unified RBAC permissions and workload access; workbook access alone does not grant access to its data.

Summaries are generated from the documentation change itself.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

Create and manageUpdate workbooks with ISOC in Microsoft Defenderto use Advanced Hunting data - Microsoft Defender XDR | Microsoft Learn

Use workbooks with Integrated Security Operations Center (ISOC) inWorkbooks can query Microsoft Defender to create interactive dashboards that visualize and monitor securityXDR data directly by using advanced hunting queries.Advanced Hunting, without requiring the same data to be ingested into a workspace.

Note

This feature is in preview. Capabilities and availability might change during the preview period.You can update existing workbooks to use Advanced Hunting data or create new workbooks that query Microsoft Defender XDR data directly.

Prerequisites

  • To create and edit workbooks, either the Workbooks Unified RBAC permission with Manage access or the Security Administrator role.
  • Access to the scopes and workloads used by the workbook queries.

Explore example workbooks

UseWorkbook permissions don't grant access to the example workbooks to become familiar withunderlying data. Data access and scoping are enforced when the query runs.

For example, a user can open a workbook that contains Defender for Endpoint data, but the workbook experience and available visualizations.

  1. Sign intile returns an error if the user doesn't have access to the Microsoft Defender portal.
  2. Go to Microsoft Sentinel > Workbooks.
  3. Under Getting started, select an example workbook.
  4. Explore the workbook data and visualizations.

Screenshot showing example workbooks for device activity, email security, identity monitoring, and alerts and incidents.that data.

Example workbooks are provided for exploration. To build and save your own dashboard, create a new workbook.For more information, see Update permissions and roles with Unified RBAC.

Create a workbook using Advanced Hunting data

Create a workbookThe Workbooks page includes example workbooks that uses advanced hunting queries to visualizeuse Microsoft Defender XDR data.

  1. Sign in to the Microsoft Defender portal.

  2. Go to Workbooks.

  3. Select + Add workbook.

  4. Select Edit.

  5. Edit the existing query section or add a new query section.

  6. For Data source, select Advanced hunting.

  7. Enter an advanced hunting query.

  8. Select Run query to review the query results.

  9. Configure the query settings.

    Available settings include:

    • Time range
    • Visualization
    • Size
    • Visual formatting settings
  10. Select Apply changes.

  11. Add or edit other workbook sections as needed.

    You can add text, queries, and parameters.

  12. When you're done, select Done editing.

  13. Select Save.

  14. Enter a title for the workbook.

  15. Select Save.

The workbook is saved automatically at the tenant level.

View saved workbooks

Saved workbooks appear on the My workbooks tab.To create your own workbook:

  1. Sign in to the Microsoft Defender portal.
  2. Go to Workbooks.
  3. Select the My workbooks tab.
  4. Use search or the available filters to find a workbook.
  5. Select the workbook to view its details.
  6. Select View saved workbook.

Saved workbooks are visible to users with the Workbooks permission with Reader access or the Security Reader role. The data displayed depends on the user's access to the relevant scope and workload.

Edit a workbook

  1. Sign in to the Microsoft Defender portal.
  2. Go to Workbooks.
  3. On the My workbooks tab, select the workbook you want to update.
  4. Select View saved+ Add workbook.
  5. Select Edit.
  6. UpdateIn the query section, select Advanced Hunting as the data source.
  7. Add or update the query for the workbook sections, queries, parameters, or visualizations.tile.
  8. Select Apply changes after editing a section.
  9. When you're done, select Done editing.
  10. Select Save. the workbook.

Refresh workbook data

Refresh a workbook to display updated data.

In the workbook toolbar, select one of the following options:

  • Refresh to manually refresh the workbook data.
  • Auto refresh to refresh the workbook automatically at a configured interval.

Supported auto-refresh intervals range from 5 minutes to 1 day.

Auto refresh pauses while you're editing a workbook. The interval restarts when you return to view mode or manually refresh the workbook.

Auto refresh is turned off when you close the workbook. Turn it on again the next time you open the workbook, as needed.

Delete aUpdate an existing workbook

Warning

DeletingWhen you stop ingesting a workbook permanently removes the workbook and its customizations. This action can't be undone.supported Microsoft Defender XDR table into a workspace, update any workbooks that query that table.

  1. Sign in to the Microsoft Defender portal.
  2. Go to Workbooks.
  3. Select the My workbooks tab.
  4. Select and open the workbook you want to remove.update.
  5. Select DeleteEdit.
  6. SelectChange the query data source to YesAdvanced Hunting.
  7. Review the query and confirm that the table names are available in Advanced Hunting. Most table names remain the same.
  8. Update any table or column references that differ in the Advanced Hunting schema.
  9. Validate the workbook tiles, filters, and parameters.

For information about schema and data-type differences, see Update Microsoft Sentinel content to use Advanced Hunting tables.

Work with workbooks across workspaces

When one or more workspaces are connected, the Workbooks page includes a Workspace column that shows where each workbook is saved.

  • A workspace name indicates that the workbook is saved to confirm. that workspace.
  • None indicates that the workbook is saved at the tenant level.

You can filter the workbook list by workspace directly from the Workbooks page.

\ No newline at end of file When you save a workbook, choose whether to save it to a specific workspace or at the tenant level. \ No newline at end of file