Service Principal Account Management

To access resources that are secured by an Microsoft Entra ID tenant, the entity that requires access must be represented by a security principal. This requirement is true for both users (user principal) and applications (service principal). The security principal defines the access policy and permissions for the user/application in the Microsoft Entra ID tenant.

With this feature, the connector supports managing such Service Principals for enterprise applications as Accounts.

The following features are supported for the Azure Service Principal:

Operations

Service Principal

Aggregation

Yes

Get Account

Yes

Create

Yes

Update

Yes

Enable and Disable Users

Yes

Add and Remove Entitlements

  • Add and Remove Roles

  • Add and Remove User's Group Membership

  • Add and Remove Application Role Memberships (appRoleAssignments)

  • Add and Remove PIM Role Memberships (azureActiveRoles and AzureADActiveRoles)

  • Add and Remove RBAC Role Memberships (azureRoleAssignments)

    Note
    For more details and the required prerequisites, refer to Group Management for Azure Cloud Objects.

  • Add and Remove Admin Consented Delegated Permissions (spn_adminConsentedPermissions)

  • Remove User Consented Delegated Permissions (spn_userConsentedPermissions)

Yes

Administrator Permissions

Purpose

Type

Permissions

Aggregation of Service Principals

Application

Application.Read.All

Create and Update Service Principals

Application

Application.ReadWrite.All

Add and Remove Owners

Application

Application.ReadWrite.OwnedBy

Add and Remove Application Roles for Service Principals

Application

AppRoleAssignment.ReadWrite.All

Aggregation of Application Roles

Application

Application.Read.All

Aggregation and Add/Remove Microsoft Entra ID Group and Roles for Service Principals

 

Refer to Required Permissions.

Aggregation and Add/Remove RBAC Roles for Service Principals

 

Refer to Group Attributes for Azure Cloud Objects.

Aggregation and Add/Remove PIM Azure Active and Microsoft Entra ID Roles for Service Principals

 

Refer to Azure Privileged Identity Management (PIM).

Aggregation of Admin/User Consented Permissions for Service Principals

Application

DelegatedPermissionGrant.Read.All

Add/Remove Admin Consented Delegated Permissions for Service Principals

Application

DelegatedPermissionGrant.ReadWrite.All

Remove User Consented Delegated Permissions for Service Principals

Application

DelegatedPermissionGrant.ReadWrite.All

Supported Schema Attributes

To aggregate service principal related information for the user during account aggregation, ensure that the service principal attributes are present in the account schema. For more information, refer to Service Principal as Accounts Attributes.

Supported Provisioning Attributes

To provision service principal related information, ensure that the attributes in Account Profile for Service Principal are present in your provisioning policy.

Configure Microsoft Entra Service Principals as Accounts in Source

  1. Go to Feature Management.

  2. Select Manage Microsoft Entra Service Principals as Accounts to aggregate Azure Service Principals along with Users during the account aggregation process. By default, when this is enabled, entitlements are not fetched. You must select the entitlements you want to fetch from the available list. When this is turned off, you see a black X. If it is turned on, you see a blue ✔.

  3. In the Service Principal Account Filter field, enter filter statements to ensure only the correct Azure Service Principals are included in the aggregation process. The default filter is servicePrincipalType eq 'Application'

    Note
    Advanced queries are not supported.

    Example filters:

    • For a filter to match the Enterprise Application default view on the Azure portal use the following:

      tags/Any(x: x eq 'WindowsAzureActiveDirectoryIntegratedApp')

    • For a filter to exclude Microsoft's built-in service principals use the following:

      appOwnerOrganizationId ne f8cdef31-a31e-4b4a-93e4-5f571e91255a&$top=100

  4. Select the Manage Azure PIM Role Memberships checkbox to manage Azure PIM Active Role memberships for Service Principal.

  5. Select the Manage Microsoft Entra PIM Role Memberships checkbox to manage Microsoft Entra ID PIM Active Role memberships for Service Principal.

  6. Select the Manage Role Memberships checkbox to manage Directory Role memberships for Service Principal.

  7. Select the Manage Application Role Memberships checkbox to manage Azure Application Role memberships for Service Principal.

  8. Select the Manage Group Memberships checkbox to manage Microsoft Entra ID Group memberships for Service Principal.

  9. Select the Manage Microsoft Entra Role Assignment Memberships checkbox to manage Azure Cloud Group memberships for Service Principals.

  10. Select the Manage Admin Consented Permission Memberships checkbox to manage Azure admin consented permissions for Service Principals.

    Note
    This is for delegated permissions.

  11. Select Save.