Skip to content

Commit 809872c

Browse files
authored
Update roles-custom-overview.md
Adjusted opening paragraph a bit.
1 parent 0df6c2f commit 809872c

File tree

1 file changed

+5
-3
lines changed

1 file changed

+5
-3
lines changed

articles/active-directory/users-groups-roles/roles-custom-overview.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,11 @@ ms.collection: M365-identity-device-management
1818

1919
# Custom administrator roles in Azure Active Directory (preview)
2020

21-
This article describes how to understand the new custom roles in Azure Active Directory (Azure AD). Azure AD allows you to assign administrative privileges restricted to a customized Azure AD resource scope. Custom roles such as these are part of a preview release of the Azure AD role-based access control model. [Built-in roles](directory-assign-admin-roles.md) provide an adequate granularity for many situations, but when you want more fine-grained permissions, you can create custom roles to reduce the scope of control for the role to the level of a single Azure AD resource.
21+
This article describes how to understand the new custom RBAC (roles-based access control) and resource scopes in Azure Active Directory (Azure AD). Custom RBAC roles surfaces the underlying permissions of the [built-in roles](directory-assign-admin-roles.md) , so you can create and organize your own custom roles. Resource scopes gives you a way to assign the custom role to manage some resources (e.g. one application) without giving access to all resources (all applications).
2222

23-
The preview release of Azure AD role-based access control exposes two scopes: an organization-wide scope (allowing the permitted actions for all Azure AD resources in the organization) and a custom scope, with permissions restricted to application registrations. In this custom role, you can edit app registration permissions. Over time, additional permissions for organization resources like enterprise applications, users, and devices will be added.
23+
Granting permission using custom RBAC roles is a two-step process. First, you create a custom role definition and add permissions to it from the preset list. These are the same permissions used in the built-in roles. Once you’ve created your role, you assign it to someone by creating a role assignment. This two-step process allows you to create one role and assign it many times at different scopes. A custom role can be assigned at directory scope, or it can be assigned at an object scope. An example of an object scope would be a single application. This way the same role can be assigned to Sally over all applications in the directory and then Naveen over just the Contoso Expense Reports app.
24+
25+
This first release of custom RBAC roles includes the ability to create a role to assign permissions for managing app registrations. Over time, additional permissions for organization resources like enterprise applications, users, and devices will be added.
2426

2527
Preview features:
2628

@@ -75,4 +77,4 @@ A scope is the restriction of permitted actions on a particular Azure AD resourc
7577
## Next steps
7678

7779
- Create custom role assignments using [the Azure portal, Azure AD PowerShell, and Graph API](roles-create-custom.md)
78-
- [View the assignments for a custom role](roles-view-assignments.md#view-the-assignments-of-a-role-with-single-application-scope-using-the-azure-ad-portal-preview)
80+
- [View the assignments for a custom role](roles-view-assignments.md#view-the-assignments-of-a-role-with-single-application-scope-using-the-azure-ad-portal-preview)

0 commit comments

Comments
 (0)