Skip to content

Commit 5a5ecc5

Browse files
authored
Update how-to-create-user-assigned-managed-identity.md
score fixes
1 parent 9ed949e commit 5a5ecc5

File tree

1 file changed

+15
-17
lines changed

1 file changed

+15
-17
lines changed

articles/operator-service-manager/how-to-create-user-assigned-managed-identity.md

Lines changed: 15 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -12,42 +12,40 @@ ms.service: azure-operator-service-manager
1212

1313
In this how-to guide, you learn how to:
1414
- Create a User Assigned Managed Identity (UAMI) for your Site Network Service (SNS).
15-
- Assign that User Assigned Managed Identity permissions.
16-
17-
The requirement for a User Assigned Managed Identity and the required permissions depend on the Network Service Design (NSD) and must have been communicated to you by the Network Service Designer.
15+
- Assign that User Assigned Managed Identity permissions for use by Azure Operator Service Manager (AOSM)
1816

1917
> [!WARNING]
20-
> UAMI is required where an expected SNS operation may run for 4 or more hours. If UAMI isn't used during long running SNS operations, the SNS may report a false failed status before component operations complete.
18+
> UAMI is required where an expected SNS operation may run for four or more hours. If UAMI isn't used during long running SNS operations, the SNS may report a false failed status before component operations complete.
2119
2220
## Prerequisites
2321

24-
- You must have created a custom role via [Create a custom role](how-to-create-custom-role.md). This article assumes that you named the custom role 'Custom Role - AOSM Service Operator access to Publisher.'
22+
- You must create a custom role via [Create a custom role](how-to-create-custom-role.md). This article assumes that you named the custom role 'Custom Role - AOSM Service Operator access to Publisher.'
2523

26-
- Your Network Service Designer must have told you which other permissions your Managed Identity requires and which Network Function Definition Version (NFDV) your SNS uses.
24+
- You must work with your Network Service Designer to understand the permissions your Managed Identity requires and which Network Function Definition Version (NFDV) your SNS uses.
2725

28-
- To perform this task, you need either the 'Owner' or 'User Access Administrator' role over the Network Function Definition Version resource from your chosen Publisher. You also must have a Resource Group over which you have the 'Owner' or 'User Access Administrator' role assignment in order to create the Managed Identity and assign it permissions.
26+
- You need either the 'Owner' or 'User Access Administrator' role over the Network Function Definition Version resource from your chosen Publisher. You also must have a Resource Group over which you have the 'Owner' or 'User Access Administrator' role assignment.
2927

3028
## Create a UAMI
3129

32-
Firust, create a UAMI. Refer to [Create a User Assigned Managed Identity for your SNS](/azure/active-directory/managed-identities-azure-resources/how-manage-user-assigned-managed-identities?pivots=identity-mi-methods-azp) for details.
30+
First, create a UAMI. Refer to [Create a User Assigned Managed Identity for your SNS](/azure/active-directory/managed-identities-azure-resources/how-manage-user-assigned-managed-identities?pivots=identity-mi-methods-azp) for details.
3331

3432
## Assign custom role to UAMI
3533

3634
Next, assign a custom role to your new UAMI. Choose a scope-based approach and then allow the proper permission across that scope.
3735

3836
### Choose scope for assigning custom role
3937

40-
Either assign the custom role individually to a child resources, like a NFDV, or to a parent resource, such as the publisher resource group or Network Function Definition Group (NFDG). Assigning the role to a parent resource grants equal access over all child resources. For proper SNS operations, either the parent resource must include all below resources, or the following resources must be assigned the custom role individually:
38+
Either assign the custom role individually to a child resources, like an NFDV, or to a parent resource, such as the publisher resource group or Network Function Definition Group (NFDG). Assigning the role to a parent resource grants equal access over all child resources. For proper SNS operations, either the parent resource must include all below resources, or the following resources must be assigned the custom role individually:
4139

42-
- All the Network Function Definition Version(s)
43-
- All the Network Function Definition Groups and Versions.
44-
- All the Network Service Design Groups and Versions.
45-
- All the Configuration Group Schemas.
40+
- All the Network Function Definition Versions (NSDV).
41+
- All the Network Function Definition Groups (NFDG) and Versions
42+
- All the Network Service Design Groups (NSD) and Versions.
43+
- All the Configuration Group Schemas (CGS).
4644
- All the custom locations.
4745

48-
### Allow proper permissions for the choosen scope
46+
### Allow proper permissions for the chosen scope
4947

50-
The UAMI needs the following indivudal permissions to execute required SNS operations:
48+
The UAMI needs the following individual permissions to execute required SNS operations:
5149

5250
- On the NFDV
5351
- Microsoft.HybridNetwork/publishers/networkFunctionDefinitionGroups/networkFunctionDefinitionVersions/use/**action**
@@ -66,11 +64,11 @@ The UAMI needs the following indivudal permissions to execute required SNS opera
6664
If using a parent resource scope approach, then the required permissions would be applied to the parent resource.
6765

6866
> [!NOTE]
69-
> Do not provide write or delete access to any of these publisher resources.
67+
> Don't provide write or delete access to any of these publisher resources.
7068
7169
### Assign custom role
7270

73-
1. Access the Azure portal and open your chosen resource scope; eg. Publisher Resource Group or Network Function Definition Version.
71+
1. Access the Azure portal and open your chosen resource scope; for example, Publisher Resource Group or Network Function Definition Version.
7472

7573
2. In the side menu of this item, select **Access Control (IAM)**.
7674

0 commit comments

Comments
 (0)