Microsoft Entra ID Governance
Governance

Assign Azure resource roles in Privileged Identity Management

In brief

The article now documents eligible Azure resource role assignments for agents and agent identities, which require an E7 license, plus preview steps for converting permanent or time-bound active assignments to eligible assignments.

What Entra admins need to know

Administrators with Owner or User Access Administrator permissions can use the Assignments (Preview) blade to make assignments eligible; users must then activate them. No mandatory action is stated.

This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

Assign Azure resource roles in Privileged Identity Management

Privileged Identity Management supports both built-in and custom Azure roles. For more information on Azure custom roles, see Azure custom roles.

Role assignment conditions

You can use theUse Azure attribute-based access control (Azure ABAC) conditions to add conditions onlimit permissions in eligible Azure resource role assignments using Microsoft Entra PIM for Azure resources. With Microsoft Entra PIM, your end usersassignments. Assignees must activate an eligible role assignment to get permission to perform certain actions. Using conditions in Microsoft Entraassignments before they can use the permissions. PIM enables you not only to limit a user's role permissions to a resource usingcombines fine-grained conditions, but also to use Microsoft Entra PIM to secure the role assignmentresource conditions with a time-bound setting,assignments, approval workflow,workflows, and an audit trail, and so on.trail.

For more information, see What is Azure attribute-based access control (Azure ABAC).

::: zone pivot="portal"

Assign a role

Follow these steps to make a user eligible forassign an Azure resource role.role to a user, group, agent, or agent identity.

  1. Sign in to the Microsoft Entra admin center as at least a User Access Administrator.

    :::image type="content" source="./media/pim-resource-roles-assign-roles/resources-select-role.png" alt-text="Screenshot of the new assignment pane.":::

  2. Select a memberthe user, group, agent, or groupagent identity you want to assign to the role and then choose Select.

    :::image type="content" source="./media/pim-resource-roles-assign-roles/resources-select-member-or-group.png" alt-text="Screenshot that demonstrates how to select a member or group pane.":::

    Microsoft Entra PIM for Azure resources provides two distinct assignment types:

    • Eligible assignments require the member to activate the role before using it. Administrator mayDepending on the role settings, activation might require role member to perform certain actions before role activation, which might include performing a multifactor authentication (MFA) check, providing, a business justification, or requesting approval from designated approvers.

    • Active assignments don't require the member to activate the role before usage. Members assigned as active have the privileges assigned ready to use. This type of assignment is also available to customers who don't use Microsoft Entra PIM.

    :::image type="content" source="./media/pim-resource-roles-assign-roles/resources-new-assignment-notification.png" alt-text="Screenshot of a new assignment notification.":::

Convert active role assignments to eligible role assignments (Preview)

Use the 'Assignments (Preview)' blade to change selected active Azure resource role assignments to eligible role assignments.

Enhanced Azure role assignment conversion is in preview. You can convert permanent active and time-bound active Azure resource role assignments to eligible role assignments.

Existing PIM licensing for Azure resources applies unchanged to users and groups. Eligible assignments for agents and agent identities require an E7 license. See PIM licensing requirements.

The existing permissions for managing role assignments apply: you need the Owner or User Access Administrator role at the scope you want to manage.

When the role assignment conversion takes effect, the eligible role assignment replaces the active role assignment. The user must activate the eligible role assignment. The eligible role assignment's Start time and End time define when the user can request activation, not the duration of each role activation. Role activation duration follows the role's activation settings.

  1. Sign in to the Azure portal.

  2. Open Privileged Identity Management, select Azure resources, and select the Azure scope you want to manage.

  3. Select Assignments (Preview), and then select Active Assignments.

  4. Select the role assignments you want to change, and then select Manage Assignments.

    :::image type="content" source="media/pim-resource-roles-assign-roles/active-assignment-manage.png" alt-text="Screenshot of Active Assignments with a role assignment selected and the Manage Assignments action available." lightbox="media/pim-resource-roles-assign-roles/active-assignment-manage.png":::

  5. In Update Assignments, under Target Assignment Type, select Eligible (Recommended).

  6. Under Assignment duration, select Time-bound, and specify Start time and End time.

    :::image type="content" source="media/pim-resource-roles-assign-roles/update-assignment-to-eligible.png" alt-text="Screenshot of Update Assignments with Eligible and Time-bound selected and the eligibility start and end times shown." lightbox="media/pim-resource-roles-assign-roles/update-assignment-to-eligible.png":::

  7. Select Save.

  8. Review Eligible Assignments to check the role assignment type and duration.

After setup, users can activate their eligible Azure resource role assignments in My Access.

::: zone-end

::: zone pivot="api"

Assign a role using Azure Resource Manager API

Privileged Identity Management supports Azure Resource Manager (ARM) API commands to manage Azure resource roles, as documented in the PIM Azure Resource Manager API reference. For the permissions required to use the PIM API, see Understand the Privileged Identity Management APIs. }


::: zone-end

::: zone pivot="portal"

## Update or remove an existing role assignment

Follow these steps to update or remove an existing role assignment.

    For information about extending a role assignment, see [Extend or renew Azure resource roles in Privileged Identity Management](pim-resource-roles-renew-extend.md).

::: zone-end

## Next steps

- [Configure Azure resource role settings in Privileged Identity Management](pim-resource-roles-configure-role-settings.md)
Daily Entra.News

Get daily email updates

Get a concise summary of the latest Microsoft Entra updates delivered straight to your inbox.

Loading the secure signup form…