Merge pull request #93319 from VinceSmith/patch-32

Fixed some bugs in permission descriptions

Author: v-shils

articles/active-directory/users-groups-roles/roles-custom-available-permissions.md

@@ -20,32 +20,25 @@ ms.collection: M365-identity-device-management
 
 This article contains the currently available app registration permissions for custom role definitions in Azure Active Directory (Azure AD).
 
-## Single-tenant v. multi-tenant permissions
+## Permissions for managing single-directory applications
 
-Custom role permissions differ for single-tenant and multi-tenant applications. Single-tenant applications are available only to users in the Azure AD organization where the application is registered. Multi-tenant applications are available to all Azure AD organizations. Single-tenant applications are defined as having **Supported account types** set to "Accounts in this organizational directory only." In the Graph API, single-tenant applications have the signInAudience property set to "AzureADMyOrg."
+When choosing the permissions for your custom role, you have the option to grant access to manage only single-directory applications. Single-directory applications are available only to users in the Azure AD organization where the application is registered. Single-directory applications are defined as having **Supported account types** set to "Accounts in this organizational directory only." In the Graph API, single-directory applications have the signInAudience property set to "AzureADMyOrg."
 
-## Application registration subtypes and permissions
+To grant access to manage only single-directory applications, use the permissions below with the subtype **applications.myOrganization**. For example, microsoft.directory/applications.myOrganization/basic/update.
 
 See the [custom roles overview](roles-custom-overview.md) for an explanation of what the general terms subtype, permission, and property set mean. The following information is specific to application registrations.
 
-### Subtypes
-
-There is just one app registration subtype - applications.myOrganization. For example, microsoft.directory/applications.myOrganization/basic/update. This subtype is set on the **Authentication** page for a specific app registration, and corresponds to setting the signInAudience property to "AzureADMyOrg" using Graph API or PowerShell. The subtype restricts the permission to app registrations that are marked as accessible only by accounts in your organization (single-tenant applications).
-
-You can use the restricted permission to grant read or manage permissions to internal applications only without granting read or manage permissions to applications accessible by accounts in other organizations.
-
-There are applications.myOrganization versions of all read and update permissions as well as the delete permission. There is no applications.myOrganization version of create at this time. Standard permissions (for example, microsoft.directory/applications/basic/update) grant read or management permissions for all app registration types.
+### Create and delete
 
-![Declare a single-tenant application or multi-tenant application](./media/roles-custom-available-permissions/supported-account-types.png)
+There are two permissions available for granting the ability to create application registrations, each with different behavior:
 
-Details for the following permissions for the custom roles preview are listed in [Available custom role permissions in Azure Active Directory](roles-custom-available-permissions.md).
+#### microsoft.directory/applications/createAsOwner
 
-### Create and delete
+Assigning this permission results in the creator being added as the first owner of the created app registration, and the created app registration will count against the creator's 250 created objects quota.
 
-There are two permissions available for granting the ability to create application registrations, each with different behavior:
+#### microsoft.directory/applications/create
 
-- **microsoft.directory/applications/createAsOwner**: Assigning this permission results in the creator being added as the first owner of the created app registration, and the created app registration will count against the creator's 250 created objects quota.
-- **microsoft.directory/applicationPolicies/create**: Assigning this permission results in the creator not being added as the first owner of the created app registration, and the created app registration will not count against the creator's 250 created objects quota. Use this permission carefully, because there is nothing preventing the assignee from creating app registrations until the directory-level quota is hit. If both permissions are assigned, this permission takes precedence.
+Assigning this permission results in the creator not being added as the first owner of the created app registration, and the created app registration will not count against the creator's 250 created objects quota. Use this permission carefully, because there is nothing preventing the assignee from creating app registrations until the directory-level quota is hit. If both permissions are assigned, this permission takes precedence.
 
 If both permissions are assigned, the /create permission will take precedence. Though the /createAsOwner permission does not automatically add the creator as the first owner, owners can be specified during the creation of the app registration when using Graph APIs or PowerShell cmdlets.
 
@@ -74,81 +67,41 @@ All member users in the organization can read app registration information by de
 
 #### microsoft.directory/applications/allProperties/read
 
-Ability to read all properties of single-tenant and multi-tenant applications outside of sensitive properties like credentials.
+Ability to read all properties of single-tenant and multi-tenant applications outside of properties that cannot be read in any situation like credentials.
 
 #### microsoft.directory/applications.myOrganization/allProperties/read
 
 Grants the same permissions as microsoft.directory/applications/allProperties/read, but only for single-tenant applications.
 
-#### microsoft.directory/applications/standard/read: Grants access to all fields on the application registration branding page
-
-![This permission grants access to the app registration branding page](./media/roles-custom-available-permissions/app-registration-branding.png)
-
-#### microsoft.directory/applications.myOrganization/standard/read
-
-Grants the same permissions as microsoft.directory/applications/standard/read, but for only single-tenant applications.
-
 #### microsoft.directory/applications/owners/read
 
 Grants the ability to read owners property on single-tenant and multi-tenant applications. Grants access to all fields on the application registration owners page:
 
 ![This permissions grants access to the app registration owners page](./media/roles-custom-available-permissions/app-registration-owners.png)
 
-Grants access to the following properties on the application entity:
-
-- AllowActAsForAllClients
-- AllowPassthroughUsers
-- AppAddress
-- AppBrandingElements
-- AppCategory
-- AppCreatedDateTime
-- AppData
-- AppId
-- AppInformationalUrl
-- ApplicationTag
-- AppLogoUrl
-- AppMetadata
-- AppOptions
-- BinaryExtensionAttribute
-- BooleanExtensionAttribute
-- CountriesBlockedForMinors
-- CreatedOnBehalfOf
-- DateTimeExtensionAttribute
-- DisplayName
-- ExtensionAttributeDefinition
-- IntegerExtensionAttribute
-- KnownClientApplications
-- LargeIntegerExtensionAttribute
-- LegalAgeGroupRule
-- LocalizedAppBrandingElements
-- MainLogo
-- MsaAppId
-- ResourceApplicationSet
-- ServiceDiscoveryEndpoint
-- StringExtensionAttribute
-- TrustedCertificateSubject
-- WebApi
-- WebApp
-- WwwHomepage
+#### microsoft.directory/applications/standard/read
+
+Grants access to read standard application registration properties. This includes properties across application registration pages.
+
+#### microsoft.directory/applications.myOrganization/standard/read
+
+Grants the same permissions as microsoft.directory/applications/standard/read, but for only single-tenant applications.
 
 ### Update
 
 #### microsoft.directory/applications/allProperties/update
 
+Ability to update all properties on single-directory and multi-directory applications.
+
 #### microsoft.directory/applications.myOrganization/allProperties/update
 
 Grants the same permissions as microsoft.directory/applications/allProperties/update, but only for single-tenant applications.
 
 #### microsoft.directory/applications/audience/update
 
-Grants access to all fields on the application registration authentication page:
-
-![This permission grants access to app registration authentication page](./media/roles-custom-available-permissions/supported-account-types.png)
-
-Grants access to the following properties on the application resource:
+Ability to update the supported account type (signInAudience) property on single-directory and multi-directory applications.
 
-- AvailableToOtherTenants
-- SignInAudience
+![This permission grants access to app registration supported account type property on authentication page](./media/roles-custom-available-permissions/supported-account-types.png)
 
 #### microsoft.directory/applications.myOrganization/audience/update
 
@@ -160,20 +113,6 @@ Ability to update the reply URL, sign-out URL, implicit flow, and publisher doma
 
 ![Grants access to app registration authentication but not supported account types](./media/roles-custom-available-permissions/supported-account-types.png)
 
- Grants access to the following properties on the application resource:
-
-- AcceptMappedClaims
-- AccessTokenAcceptedVersion
-- AddIns
-- GroupMembershipClaims
-- IsDeviceOnlyAuthSupported
-- OAuth2LegacyUrlPathMatching
-- OauthOidcResponsePolicyBitmap
-- OptionalClaims
-- OrgRestrictions
-- PublicClient
-- UseCustomTokenSigningKey
-
 #### microsoft.directory/applications.myOrganization/authentication/update
 
 Grants the same permissions as microsoft.directory/applications/authentication/update, but only for single-tenant applications.
@@ -184,42 +123,6 @@ Ability to update the name, logo, homepage URL, terms of service URL, and privac
 
 ![This permission grants access to the app registration branding page](./media/roles-custom-available-permissions/app-registration-branding.png)
 
-Grants access to the following properties on the application resource:
-
-- AllowActAsForAllClients
-- AllowPassthroughUsers
-- AppAddress
-- AppBrandingElements
-- AppCategory
-- AppData
-- AppId
-- AppInformationalUrl
-- ApplicationTag
-- AppLogoUrl
-- AppMetadata
-- AppOptions
-- BinaryExtensionAttribute
-- BooleanExtensionAttribute
-- CountriesBlockedForMinors
-- CreatedOnBehalfOf
-- DateTimeExtensionAttribute
-- DisplayName
-- ExtensionAttributeDefinition
-- IntegerExtensionAttribute
-- KnownClientApplications
-- LargeIntegerExtensionAttribute
-- LegalAgeGroupRule
-- LocalizedAppBrandingElements
-- MainLogo
-- MsaAppId
-- ResourceApplicationSet
-- ServiceDiscoveryEndpoint
-- StringExtensionAttribute
-- TrustedCertificateSubject
-- WebApi
-- WebApp
-- WwwHomepage
-
 #### microsoft.directory/applications.myOrganization/basic/update
 
 Grants the same permissions as microsoft.directory/applications/basic/update, but only for single-tenant applications.
@@ -230,13 +133,6 @@ Ability to update the certificates and client secrets properties on single-tenan
 
 ![This permission grants access to the app registration certificates & secrets page](./media/roles-custom-available-permissions/app-registration-secrets.png)
 
-Grants access to the following properties on the application resource:
-- AsymmetricKey
-- EncryptedSecretKey
-- KeyDescription
-- SharedKeyReference
-- TokenEncryptionKeyId
-
 #### microsoft.directory/applications.myOrganization/credentials/update
 
 Grants the same permissions as microsoft.directory/applications/credentials/update, but only for single-directory applications.
@@ -247,9 +143,6 @@ Ability to update the owner property on single-tenant and multi-tenant. Grants a
 
 ![This permissions grants access to the app registration owners page](./media/roles-custom-available-permissions/app-registration-owners.png)
 
-Grants access to the following properties on the application resource:
-- Owners
-
 #### microsoft.directory/applications.myOrganization/owners/update
 
 Grants the same permissions as microsoft.directory/applications/owners/update, but only for single-tenant applications.
@@ -262,14 +155,6 @@ Ability to update the delegated permissions, application permissions, authorized
 
 ![This permissions grants access to the app registration Expose an API page](./media/roles-custom-available-permissions/app-registration-expose-api.png)
 
-Grants access to the following properties on the application resource:
-
-- AppIdentifierUri
-- Entitlement
-- PreAuthorizedApplications
-- RecordConsentConditions
-- RequiredResourceAccess
-
 #### microsoft.directory/applications.myOrganization/permissions/update
 
 Grants the same permissions as microsoft.directory/applications/permissions/update, but only for single-tenant applications.