Merge pull request #164532 from memildin/asc-melvyn-containerwork

Tweaks to workbooks & permissions

Author: v-ccolin

articles/security-center/custom-dashboards-azure-workbooks.md

@@ -15,76 +15,76 @@ ms.date: 06/13/2021
 
 Workbooks provide a rich set of capabilities for visualizing your Azure data. For detailed examples of each visualization type, see the [visualizations examples and documentation](../azure-monitor/visualize/workbooks-text-visualizations.md). 
 
-Within Azure Security Center, you can access the built-in reports to track your organization’s security posture. You can also build custom reports to view a wide range of data from Security Center or other supported data sources.
+Within Azure Security Center, you can access the built-in workbooks to track your organization’s security posture. You can also build custom workbooks to view a wide range of data from Security Center or other supported data sources.
 
-:::image type="content" source="media/custom-dashboards-azure-workbooks/secure-score-over-time-snip.png" alt-text="Secure score over time report.":::
+:::image type="content" source="media/custom-dashboards-azure-workbooks/secure-score-over-time-snip.png" alt-text="Secure score over time workbook.":::
 
 ## Availability
 
 | Aspect                          | Details                                                                                                                                      |
 |---------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------|
 | Release state:                  | General Availability (GA)                                                                                                                    |
 | Pricing:                        | Free                                                                                                                                         |
-| Required roles and permissions: | To save workbooks, you must have at least Workbook Contributor permissions on the target resource group                                      |
+| Required roles and permissions: | To save workbooks, you must have at least [Workbook Contributor](../role-based-access-control/built-in-roles.md#workbook-contributor) permissions on the target resource group                                      |
 | Clouds:                         | ![Yes](./media/icons/yes-icon.png) Commercial clouds<br>![Yes](./media/icons/yes-icon.png) National/Sovereign (US Gov, Azure China) |
 |                                 |                                                                                                                                              |
 
 ## Workbooks gallery in Azure Security Center
 
-With the integrated Azure Workbooks functionality, Azure Security Center makes it straightforward to build your own custom, interactive reports. Security Center also includes a workbook gallery with the following reports ready for your customization:
+With the integrated Azure Workbooks functionality, Azure Security Center makes it straightforward to build your own custom, interactive workbooks. Security Center also includes a gallery with the following workbooks ready for your customization:
 
 - **Secure Score Over Time** - Track your subscriptions' scores and changes to recommendations for your resources
 - **System Updates** - View missing system updates by resources, OS, severity, and more
 - **Vulnerability Assessment Findings** - View the findings of vulnerability scans of your Azure resources
 
 :::image type="content" source="media/custom-dashboards-azure-workbooks/workbooks-gallery-security-center.png" alt-text="Gallery of built-in workbooks in Azure Security Center.":::
 
-Choose one of the supplied reports or create your own.
+Choose one of the supplied workbooks or create your own.
 
 > [!TIP]
-> Use the **Edit** button to customize any of the supplied reports to your satisfaction. When you're done editing, select **Save** and your changes will be saved to a new workbook.
+> Use the **Edit** button to customize any of the supplied workbooks to your satisfaction. When you're done editing, select **Save** and your changes will be saved to a new workbook.
 > 
 > :::image type="content" source="media/custom-dashboards-azure-workbooks/editing-supplied-workbooks.png" alt-text="Editing the supplied workbooks to customize them for your particular needs.":::
 
-### Use the 'Secure Score Over Time' report
+### Use the 'Secure Score Over Time' workbook
 
-This report uses secure score data from your Log Analytics workspace. That data needs to be exported from the continuous export tool as described in [Configure continuous export from the Security Center pages in Azure portal](continuous-export.md?tabs=azure-portal).
+This workbook uses secure score data from your Log Analytics workspace. That data needs to be exported from the continuous export tool as described in [Configure continuous export from the Security Center pages in Azure portal](continuous-export.md?tabs=azure-portal).
 
 When you set up the continuous export, set the export frequency to both **streaming updates** and **snapshots**.
 
 :::image type="content" source="media/custom-dashboards-azure-workbooks/export-frequency-both.png" alt-text="For the secure score over time workbook you'll need to select both of these options from the export frequency settings in your continuous export configuration":::
 
 > [!NOTE]
-> Snapshots get exported weekly, so you'll need to wait at least one week for the first snapshot to be exported before you can view data in this report.
+> Snapshots get exported weekly, so you'll need to wait at least one week for the first snapshot to be exported before you can view data in this workbook.
 
 > [!TIP]
 > To configure continuous export across your organization, use the supplied Azure Policy 'DeployIfNotExist' policies described in [Configure continuous export at scale](continuous-export.md?tabs=azure-policy).
 
-The secure score over time report has five graphs for the subscriptions reporting to the selected workspaces:
+The secure score over time workbook has five graphs for the subscriptions reporting to the selected workspaces:
 
 
 |Graph  |Example  |
 |---------|---------|
-|**Score trends for the last week and month**<br>Use this section to monitor the current score and general trends of the scores for your subscriptions.|:::image type="content" source="media/custom-dashboards-azure-workbooks/secure-score-over-time-table-1.png" alt-text="Trends for secure score on the built-in report.":::|
+|**Score trends for the last week and month**<br>Use this section to monitor the current score and general trends of the scores for your subscriptions.|:::image type="content" source="media/custom-dashboards-azure-workbooks/secure-score-over-time-table-1.png" alt-text="Trends for secure score on the built-in workbook.":::|
 |**Aggregated score for all selected subscriptions**<br>Hover your mouse over any point in the trend line to see the aggregated score at any date in the selected time range.|:::image type="content" source="media/custom-dashboards-azure-workbooks/secure-score-over-time-table-2.png" alt-text="Aggregated score for all selected subscriptions.":::|
 |**Recommendations with the most unhealthy resources**<br>This table helps you triage the recommendations that have had the most resources changed to unhealthy over the selected period.|:::image type="content" source="media/custom-dashboards-azure-workbooks/secure-score-over-time-table-3.png" alt-text="Recommendations with the most unhealthy resources.":::|
 |**Scores for specific security controls**<br>Security Center's security controls are logical groupings of recommendations. This chart shows you, at a glance, the weekly scores for all of your controls.|:::image type="content" source="media/custom-dashboards-azure-workbooks/secure-score-over-time-table-4.png" alt-text="Scores for your security controls over the selected time period.":::|
 |**Resources changes**<br>Recommendations with the most resources that have changed state (healthy, unhealthy, or not applicable) during the selected period are listed here. Select any recommendation from the list to open a new table listing the specific resources.|:::image type="content" source="media/custom-dashboards-azure-workbooks/secure-score-over-time-table-5.png" alt-text="Recommendations with the most resources that have changed health state.":::|
 
-### Use the 'System Updates' report
+### Use the 'System Updates' workbook
 
-This report is based on the security recommendation "System updates should be installed on your machines".
+This workbook is based on the security recommendation "System updates should be installed on your machines".
 
-The report helps you identify machines with outstanding updates.
+The workbook helps you identify machines with outstanding updates.
 
 You can view the situation for the selected subscriptions according to:
 
 - The list of resources with outstanding updates
 - The list of updates missing from your resources
 
-:::image type="content" source="media/custom-dashboards-azure-workbooks/system-updates-report.png" alt-text="Security Center's system updates report based on the missing updates security recommendation":::
+:::image type="content" source="media/custom-dashboards-azure-workbooks/system-updates-report.png" alt-text="Security Center's system updates workbook based on the missing updates security recommendation":::
 
-### Use the 'Vulnerability Assessment Findings' report
+### Use the 'Vulnerability Assessment Findings' workbook
 
 Security Center includes vulnerability scanners for your machines, containers in container registries, and SQL servers.
 
@@ -101,9 +101,9 @@ Findings for each of these scanners are reported in separate recommendations:
 - Vulnerability assessment findings on your SQL databases should be remediated
 - Vulnerability assessment findings on your SQL servers on machines should be remediated
 
-This report gathers these findings and organizes them by severity, resource type, and category.
+This workbook gathers these findings and organizes them by severity, resource type, and category.
 
-:::image type="content" source="media/custom-dashboards-azure-workbooks/vulnerability-assessment-findings-report.png" alt-text="Security Center's vulnerability assessment findings report":::
+:::image type="content" source="media/custom-dashboards-azure-workbooks/vulnerability-assessment-findings-report.png" alt-text="Security Center's vulnerability assessment findings workbook":::
 
 
 ## Import workbooks from other workbook galleries
@@ -143,4 +143,4 @@ You'll find your saved workbook in the **Recently modified workbooks** category.
 This article described Security Center's integrated Azure Monitor Workbooks page with built-in reports and the option to build your own custom, interactive reports.
 
 - Learn more about [Azure Monitor Workbooks](../azure-monitor/visualize/workbooks-overview.md)
-- The built-in reports pull their data from Security Center's recommendations. Learn about the many security recommendations in [Security recommendations - a reference guide](recommendations-reference.md)
+- The built-in workbooks pull their data from Security Center's recommendations. Learn about the many security recommendations in [Security recommendations - a reference guide](recommendations-reference.md)

articles/security-center/index.yml

@@ -76,7 +76,7 @@ landingContent:
           - text: Exempt a resource from a recommendation
             url: exempt-resource.md
           - text: Track your scores over time
-            url: custom-dashboards-azure-workbooks.md#use-the-secure-score-over-time-report
+            url: custom-dashboards-azure-workbooks.md#use-the-secure-score-over-time-workbook
 
   # Card
   - title: Mitigate threats

articles/security-center/release-notes-archive.md

@@ -188,7 +188,7 @@ These tools have been enhanced and expanded in the following ways:
 
 - **Regulatory compliance assessment data added (in preview).** You can now continuously export updates to regulatory compliance assessments, including for any custom initiatives, to a Log Analytics workspace or Event Hub. This feature is unavailable on national/sovereign clouds.
 
-    :::image type="content" source="media/release-notes/continuous-export-regulatory-compliance-option.png" alt-text="The options for including regulatory compliant assessment information with your continuous export data.":::
+    :::image type="content" source="media/release-notes/continuous-export-regulatory-compliance-option.png" alt-text="The options for including regulatory compliance assessment information with your continuous export data.":::
 
 ## November 2020