Skip to content

Commit ef913ea

Browse files
committed
tenant group rename
1 parent d918f27 commit ef913ea

File tree

4 files changed

+36
-36
lines changed

4 files changed

+36
-36
lines changed

unified-secops-platform/TOC.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -108,8 +108,8 @@
108108
href: mto-tenants.md
109109
- name: Create and manage endpoint security policies
110110
href: mto-endpoint-security-policy.md
111-
- name: Manage content distribution with tenant groups
112-
href: mto-tenantgroups.md
111+
- name: Manage content distribution with profiles
112+
href: mto-distribution-profiles.md
113113
- name: Manage tenants in other Microsoft clouds
114114
href: mto-cross-cloud.md
115115
- name: Troubleshoot issues

unified-secops-platform/mto-cross-cloud.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -122,7 +122,7 @@ To remove tenants from the list, select the tenant, then select **Remove tenants
122122
After successfully adding tenants from other clouds, you can view these tenants in other multitenant pages like the incidents and device inventory pages.
123123

124124
> [!NOTE]
125-
> When a cross-cloud tenant is added to a tenant group and subsequently removed from cross-cloud visibility, the tenant's name is removed from the tenant list and won’t be available for content management. This is a recognized limitation of cross-cloud visibility and is currently under review. See [Troubleshooting issues](mto-troubleshoot.md#content-assignment-failure-in-cross-cloud-tenant-management) for more information.
125+
> When a cross-cloud tenant is added to a distribution profile and subsequently removed from cross-cloud visibility, the tenant's name is removed from the tenant list and won’t be available for content management. This is a recognized limitation of cross-cloud visibility and is currently under review. See [Troubleshooting issues](mto-troubleshoot.md#content-assignment-failure-in-cross-cloud-tenant-management) for more information.
126126
127127
## Next steps
128128

unified-secops-platform/mto-tenantgroups.md

Lines changed: 31 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Content distribution using tenant groups in multitenant management
3-
description: Overview of content distribution through tenant groups in multitenant management in Microsoft Defender XDR.
2+
title: Content distribution using distribution profiles in multitenant management
3+
description: Overview of content distribution through distribution profiles in multitenant management in Microsoft Defender XDR.
44
ms.service: unified-secops-platform
55
ms.author: diannegali
66
author: diannegali
@@ -19,12 +19,12 @@ appliesto:
1919

2020
# Content distribution in multitenant management
2121

22-
Content distribution helps you manage content at scale, across tenants in multitenant management in Microsoft Defender XDR. In content distribution, you can create tenant groups to copy existing content, like custom detection rules, from the source tenant to the target tenants you assign during tenant group creation. The content then runs on the target tenant's devices or device groups that you set in the tenant group scope.
22+
Content distribution helps you manage content at scale, across tenants in multitenant management in Microsoft Defender XDR. In content distribution, you can create distribution profiles to copy existing content, like custom detection rules, from the source tenant to the target tenants you assign during distribution profile creation. The content then runs on the target tenant's devices or device groups that you set in the distribution profile scope.
2323

2424
Distributing content in this manner, across tenants, enables you to organize tenants and content based on categories like business groups or location.
2525

2626
> [!NOTE]
27-
> Multitenant management currently supports adding custom detection rules to a tenant group. Additional content types will be added in the future.
27+
> Multitenant management currently supports adding custom detection rules to a distribution profile. Additional content types will be added in the future.
2828
2929
## Requirements
3030

@@ -36,61 +36,61 @@ The following table lists the requirements for content distribution in multitena
3636
|Permissions |Users must be assigned the correct roles and permission at the individual tenant level to view and manage the associated data in multitenant management. <br/> Access to content distribution is granted through the Security settings (manage) or Security Data Basic (read) permission in [Microsoft 365 Defender Unified role-based access control (URBAC)](/defender-xdr/manage-rbac). Both of these roles are assigned to the Security Administrator and Security Reader Microsoft Entra built-in roles by default.|
3737
|Delegate access |Delegated access via [Azure B2B](/entra/external-id/add-users-administrator) or [GDAP (CSP Parters only)](/microsoft-365/lighthouse/m365-lighthouse-setup-gdap) must be obtained for at least one other tenant.|
3838

39-
## Create tenant groups
39+
## Create distribution profiles
4040

41-
To create a new tenant group:
41+
To create a new distribution profile:
4242

43-
1. Go to the [Tenant groups page](https://mto.security.microsoft.com/tenantgroups) in multitenant management in Microsoft Defender XDR.
44-
2. Select **Create tenant group**. In the **Tenants** page, select **Add tenant** to see a list of available tenants that you can add to your tenant group. Choose the tenants you want to add to the tenant group, then select **Add**.
43+
1. Go to the [distribution profiles page](https://mto.security.microsoft.com/tenantgroups) in multitenant management in Microsoft Defender XDR.
44+
2. Select **Create distribution profile**. In the **Tenants** page, select **Add tenant** to see a list of available tenants that you can add to your distribution profile. Choose the tenants you want to add to the distribution profile, then select **Add**.
4545

46-
:::image type="content" source="media/mto-tenantgroups/mto-add-tenants-small.png" alt-text="Screenshot of the tenant group creation wizard." lightbox="media/mto-tenantgroups/mto-add-tenants.png":::
46+
:::image type="content" source="media/mto-tenantgroups/mto-add-tenants-small.png" alt-text="Screenshot of the distribution profile creation wizard." lightbox="media/mto-tenantgroups/mto-add-tenants.png":::
4747

48-
3. In the **Content selection** page, select the content to be distirbuted across all tenants in your tenant group, then select **Next**.
48+
3. In the **Content selection** page, select the content to be distirbuted across all tenants in your distribution profile, then select **Next**.
4949

5050
:::image type="content" source="media/mto-tenantgroups/mto-add-content-small.png" alt-text="Screenshot of content selection wizard." lightbox="media/mto-tenantgroups/mto-add-content.png":::
5151

5252
> [!NOTE]
53-
> The content type selection is currently limited to adding custom detection rules to a tenant group.
53+
> The content type selection is currently limited to adding custom detection rules to a distribution profile.
5454
55-
4. In the **Custom detection rules** page, select **Add content** to add specific detection rules to your tenant group.
55+
4. In the **Custom detection rules** page, select **Add content** to add specific detection rules to your distribution profile.
5656

5757
:::image type="content" source="media/mto-tenantgroups/mto-add-custom-small.png" alt-text="Screenshot of custom detection rules addition wizard." lightbox="media/mto-tenantgroups/mto-add-custom.png":::
5858

59-
5. In the **Select detection rules** page, filter the source tenant of the content, then select **Apply**. Choose the content you want to add to your tenant group from the list.
59+
5. In the **Select detection rules** page, filter the source tenant of the content, then select **Apply**. Choose the content you want to add to your distribution profile from the list.
6060

6161
:::image type="content" source="media/mto-tenantgroups/mto-select-content-small.png" alt-text="Screenshot of the detection rules selection pane." lightbox="media/mto-tenantgroups/mto-select-content.png":::
6262

6363
6. In the **Device groups** page, select the devices or specific device groups that need to be in your tenant's scope.
6464

6565
:::image type="content" source="media/mto-tenantgroups/mto-select-device-small.png" alt-text="Screenshot of the device selection pane." lightbox="media/mto-tenantgroups/mto-select-device.png":::
6666

67-
7. Add a tenant group name and description about your tenant group in the Details page.
68-
8. Review the details of the tenant group you created in the **Summary** page. Leave the **Sync all authorized tenants** option checked if content needs to be synchronized now or uncheck it if the sync is planned for a later time.
67+
7. Add a distribution profile name and description about your distribution profile in the Details page.
68+
8. Review the details of the distribution profile you created in the **Summary** page. Leave the **Sync all authorized tenants** option checked if content needs to be synchronized now or uncheck it if the sync is planned for a later time.
6969

70-
:::image type="content" source="media/mto-tenantgroups/mto-summary-tenantgroups-small.png" alt-text="Screenshot of summary of tenant groups with the checkbox highlighted." lightbox="media/mto-tenantgroups/mto-summary-tenantgroups.png":::
70+
:::image type="content" source="media/mto-tenantgroups/mto-summary-tenantgroups-small.png" alt-text="Screenshot of summary of distribution profiles with the checkbox highlighted." lightbox="media/mto-tenantgroups/mto-summary-tenantgroups.png":::
7171

72-
9. Select **Submit** to finish your tenant group creation.
72+
9. Select **Submit** to finish your distribution profile creation.
7373

7474
> [!TIP]
7575
> If you choose to **Sync all authorized tenants**, all the tenants and scope within the tenants you have permission automatically syncs.
7676
77-
Your newly created tenant group appears in the Tenant groups page after creation. Select the tenant group from the list to add or remove content, add, edit, or remove tenants, or sync the tenant group.
77+
Your newly created distribution profile appears in the distribution profiles page after creation. Select the distribution profile from the list to add or remove content, add, edit, or remove tenants, or sync the distribution profile.
7878

79-
:::image type="content" source="media/mto-tenantgroups/mto-group-sample-small.png" alt-text="Screenshot of a tenant group page and the actions available within the page." lightbox="media/mto-tenantgroups/mto-group-sample.png":::
79+
:::image type="content" source="media/mto-tenantgroups/mto-group-sample-small.png" alt-text="Screenshot of a distribution profile page and the actions available within the page." lightbox="media/mto-tenantgroups/mto-group-sample.png":::
8080

8181
Check the sync results under the **Last sync result** column. If the result is *partially successful* or *failed*, select the result to investigate the cause. When selecting the result, a side pane containing the errors, recommendations, and impacted assets appears. Here's an example.
8282

8383
:::image type="content" source="media/mto-tenantgroups/mto-sync-results-small.png" alt-text="Screenshot of sync results side pane." lightbox="media/mto-tenantgroups/mto-sync-results.png":::
8484

8585
> [!NOTE]
86-
> The maximum number of published items per publish operation is 9,500. Published items are calculated as the number of tenants multiplied by the number of templates. For example, if you publish 10 tenant groups with 10 target tenants and 95 content templates, then the published items equals to 9,500.
86+
> The maximum number of published items per publish operation is 9,500. Published items are calculated as the number of tenants multiplied by the number of templates. For example, if you publish 10 distribution profiles with 10 target tenants and 95 content templates, then the published items equals to 9,500.
8787
88-
## Syncing content among tenant groups
88+
## Syncing content among distribution profiles
8989

90-
To sync content across tenant groups for the tenants you have permission for:
90+
To sync content across distribution profiles for the tenants you have permission for:
9191

92-
1. Go to the [Tenant groups page](https://mto.security.microsoft.com/tenantgroups).
93-
2. Select the checkbox next to the tenant group you want to sync, then select **Sync tenant group**.
92+
1. Go to the [distribution profiles page](https://mto.security.microsoft.com/tenantgroups).
93+
2. Select the checkbox next to the distribution profile you want to sync, then select **Sync distribution profile**.
9494
3. Select **Sync** on the prompt that appears.
9595
4. Once the sync is completed, you see one of the following statuses:
9696
- Success
@@ -101,16 +101,16 @@ To sync content across tenant groups for the tenants you have permission for:
101101

102102
Sync results show the number of synced tenants and content. Synced tenants indicate how many tenants had custom detection rules applied successfully. For example, if all rules are applied in 3 out of 3 tenants, the count is 3; if only 2 tenants succeed, the count is 2. Synced content represents the total custom detection rules synced across all target tenants.
103103

104-
## Edit tenant groups
104+
## Edit distribution profiles
105105

106-
1. Go to the [Tenant groups page](https://mto.security.microsoft.com/tenantgroups).
107-
2. Select the checkboxes next to the tenant group you want to edit, then select **Edit tenant group**.
108-
3. Edit the tenant group name and description, then select **Save**.
106+
1. Go to the [distribution profiles page](https://mto.security.microsoft.com/tenantgroups).
107+
2. Select the checkboxes next to the distribution profile you want to edit, then select **Edit distribution profile**.
108+
3. Edit the distribution profile name and description, then select **Save**.
109109

110-
## Remove tenant groups
110+
## Remove distribution profiles
111111

112-
1. Go to the [Tenant groups page](https://mto.security.microsoft.com/tenantgroups).
113-
2. Select the checkboxes next to the tenant group you want to remove, then select **Remove tenant group**.
112+
1. Go to the [**Distribution profiles** page](https://mto.security.microsoft.com/tenantgroups).
113+
2. Select the checkboxes next to the distribution profile you want to remove, then select **Remove distribution profile**.
114114

115115
## Troubleshooting
116116

unified-secops-platform/mto-troubleshoot.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -51,11 +51,11 @@ Here’s an example of the policy setting in the Microsoft Entra admin center.
5151

5252
## Content assignment failure in cross-cloud tenant management
5353

54-
You see the following error when assigning content to tenant groups:
54+
You see the following error when assigning content to distribution profiles:
5555

5656
:::image type="content" source="media/mto-troubleshoot/tenant-perms-error-small.png" alt-text="Screenshot of permissions error when assigning content to tenants" lightbox="media/mto-troubleshoot/tenant-perms-error.png":::
5757

58-
When a cross-cloud tenant is added to a tenant group and subsequently removed from cross-cloud visibility, the tenant's name is removed from the tenant list and won't be available for content management, which causes the error. This is a recognized limitation of cross-cloud tenant management and is currently under review.
58+
When a cross-cloud tenant is added to a distribution profile and subsequently removed from cross-cloud visibility, the tenant's name is removed from the tenant list and won't be available for content management, which causes the error. This is a recognized limitation of cross-cloud tenant management and is currently under review.
5959

6060
## Related content
6161

0 commit comments

Comments
 (0)