learn.microsoft.com Open in urlscan Pro
2600:141b:7000:483::3544  Public Scan

Submitted URL: https://docs.microsoft.com/en-us/azure/active-directory/active-directory-privileged-identity-management-configure
Effective URL: https://learn.microsoft.com/en-us/entra/id-governance/privileged-identity-management/pim-configure
Submission: On January 16 via manual from US — Scanned from US

Form analysis 3 forms found in the DOM

Name: site-header-search-form-mobileGET /en-us/search/

<form class="flex-grow-1" method="GET" role="search" id="ms--site-header-search-form-mobile" data-bi-name="site-header-search-form-mobile" name="site-header-search-form-mobile" aria-label="Search" action="/en-us/search/">
  <div class="autocomplete display-block" data-bi-name="autocomplete"><!---->
    <div class="field-body control ">
      <input role="combobox" maxlength="100" aria-autocomplete="list" autocapitalize="off" autocomplete="off" autocorrect="off" spellcheck="false" id="site-header-search-autocomplete-input-mobile"
        data-test-id="site-header-search-autocomplete-input-mobile" class="autocomplete-input input 
						
						width-full" type="search" name="terms" aria-expanded="false" aria-owns="ax-1-listbox" aria-controls="ax-1-listbox" aria-activedescendant="" aria-label="Search" aria-describedby="ms--site-header-search-autocomplete-input-mobile-description"
        placeholder="Search" data-bi-name="site-header-search-autocomplete-input-mobile" pattern=".*">
      <span aria-hidden="true" class="autocomplete-loader loader has-text-primary " hidden=""></span>
      <span hidden="" id="ms--site-header-search-autocomplete-input-mobile-description"> Suggestions will filter as you type </span>
    </div>
    <ul role="listbox" id="ax-1-listbox" data-test-id="site-header-search-autocomplete-input-mobile-listbox" class="autocomplete-suggestions is-vertically-scrollable padding-xxs " aria-label="Suggestions" hidden="">
    </ul>
    <!---->
  </div>
  <!-- mobile safari will not dispatch submit event unless there's a submit button that is not display:none -->
  <button type="submit" class="visually-hidden" tabindex="-1" aria-hidden="true"></button>
  <input name="category" hidden="" value="">
</form>

Name: site-header-search-formGET /en-us/search/

<form class="flex-grow-1" method="GET" role="search" id="ms--site-header-search-form" data-bi-name="site-header-search-form" name="site-header-search-form" aria-label="Search" action="/en-us/search/">
  <div class="autocomplete display-block" data-bi-name="autocomplete"><!---->
    <div class="field-body control ">
      <input role="combobox" maxlength="100" aria-autocomplete="list" autocapitalize="off" autocomplete="off" autocorrect="off" spellcheck="false" id="site-header-search-autocomplete-input" data-test-id="site-header-search-autocomplete-input" class="autocomplete-input input input-sm
						
						width-full" type="search" name="terms" aria-expanded="false" aria-owns="ax-0-listbox" aria-controls="ax-0-listbox" aria-activedescendant="" aria-label="Search" aria-describedby="ms--site-header-search-autocomplete-input-description"
        placeholder="Search" data-bi-name="site-header-search-autocomplete-input" pattern=".*">
      <span aria-hidden="true" class="autocomplete-loader loader has-text-primary " hidden=""></span>
      <span hidden="" id="ms--site-header-search-autocomplete-input-description"> Suggestions will filter as you type </span>
    </div>
    <ul role="listbox" id="ax-0-listbox" data-test-id="site-header-search-autocomplete-input-listbox" class="autocomplete-suggestions is-vertically-scrollable padding-xxs " aria-label="Suggestions" hidden="">
    </ul>
    <!---->
  </div>
  <!-- mobile safari will not dispatch submit event unless there's a submit button that is not display:none -->
  <button type="submit" class="visually-hidden" tabindex="-1" aria-hidden="true"></button>
  <input name="category" hidden="" value="">
</form>

javascript:

<form action="javascript:" role="search" aria-label="Search" class="margin-bottom-xxs"><label class="visually-hidden" for="ax-2">Search</label>
  <div class="autocomplete display-block" data-bi-name="autocomplete"><!---->
    <div class="field-body control has-icons-left">
      <input role="combobox" maxlength="100" aria-autocomplete="list" autocapitalize="off" autocomplete="off" autocorrect="off" spellcheck="false" id="ax-2" data-test-id="ax-2" class="autocomplete-input input input-sm
						control has-icons-left
						width-full" type="text" aria-expanded="false" aria-owns="ax-3-listbox" aria-controls="ax-3-listbox" aria-activedescendant="" aria-describedby="ms--ax-2-description" placeholder="Filter by title" pattern=".*">
      <span aria-hidden="true" class="icon is-small is-left">
        <span class="has-text-primary docon docon-filter-settings"></span>
      </span>
      <span aria-hidden="true" class="autocomplete-loader loader has-text-primary " hidden=""></span>
      <span hidden="" id="ms--ax-2-description"> Suggestions will filter as you type </span>
    </div>
    <ul role="listbox" id="ax-3-listbox" data-test-id="ax-2-listbox" class="autocomplete-suggestions is-vertically-scrollable padding-xxs " aria-label="Suggestions" hidden="">
    </ul>
    <!---->
  </div>
</form>

Text Content

Skip to main content


This browser is no longer supported.

Upgrade to Microsoft Edge to take advantage of the latest features, security
updates, and technical support.

Download Microsoft Edge More info about Internet Explorer and Microsoft Edge

Learn
Suggestions will filter as you type
Sign in


 * Profile
 * Settings

Sign out

Learn
   
 * Discover
      
    * Documentation
      
      In-depth articles on Microsoft developer tools and technologies
   
      
    * Training
      
      Personalized learning paths and courses
   
      
    * Credentials
      
      Globally recognized, industry-endorsed credentials
   
      
    * Q&A
      
      Technical questions and answers moderated by Microsoft
   
      
    * Code Samples
      
      Code sample library for Microsoft developer tools and technologies
   
      
    * Assessments
      
      Interactive, curated guidance and recommendations
   
      
    * Shows
      
      Thousands of hours of original programming from Microsoft experts
   
      
   
   Microsoft Learn for Organizations
   
   Boost your team's technical skills
   
   Access curated resources to upskill your team and close skills gaps.

   
 * Product documentation
      
    * ASP.NET
      
    * Azure
      
    * Dynamics 365
      
    * Microsoft 365
      
    * Microsoft Copilot
      
    * Microsoft Edge
      
    * Microsoft Entra
      
    * Microsoft Graph
      
    * Microsoft Intune
      
    * Microsoft Purview
      
    * Microsoft Teams
      
    * .NET
      
    * Power Apps
      
    * Power BI
      
    * Power Platform
      
    * PowerShell
      
    * SQL
      
    * Sysinternals
      
    * Visual Studio
      
    * Windows
      
    * Windows Server
      
   
   View all products
   
   Microsoft Learn for Organizations
   
   Boost your team's technical skills
   
   Access curated resources to upskill your team and close skills gaps.

   
 * Development languages
      
    * C++
      
    * C#
      
    * DAX
      
    * Java
      
    * OData
      
    * OpenAPI
      
    * Power Query M
      
    * VBA
      
   
   Microsoft Learn for Organizations
   
   Boost your team's technical skills
   
   Access curated resources to upskill your team and close skills gaps.

   
 * Topics
      
    * Artificial intelligence
      
    * Compliance
      
    * DevOps
      
    * Platform engineering
      
    * Security
      
   
   Microsoft Learn for Organizations
   
   Boost your team's technical skills
   
   Access curated resources to upskill your team and close skills gaps.

   

Suggestions will filter as you type
Sign in


 * Profile
 * Settings

Sign out
Microsoft Entra
   
 * Microsoft Entra ID
   
 * External ID
   
 * Global Secure Access
   
 * ID Governance
   
 * Permissions Management
   
 * Microsoft Security documentation
   
 * Troubleshooting
   
 * More
     
   * Microsoft Entra ID
     
   * External ID
     
   * Global Secure Access
     
   * ID Governance
     
   * Permissions Management
     
   * Microsoft Security documentation
     
   * Troubleshooting
     
   

Admin center
Table of contents Exit focus mode

Search
Suggestions will filter as you type
 * Privileged Identity Management documentation
 * Overview
   * What is Microsoft Entra PIM?
 * Concepts
 * How-to guides
   * Deploy PIM
   * Start using PIM
   * Bring under management
   * Assign
   * Activate
   * Approve
   * Extend or renew
   * Set role settings
   * Set up alerts
   * Audits
   * Review access
   * Discovery & Insights for Microsoft Entra roles
   * Elevate access to manage Azure subscriptions
   * Troubleshoot resource access denied
 * Reference

Download PDF
    
 1. Learn
    
    
 2. Microsoft Entra
    
    
 3. Microsoft Entra ID Governance
    
    
 4. Privileged Identity Management
    

    
 1. Learn
    
    
 2. Microsoft Entra
    
    
 3. Microsoft Entra ID Governance
    
    
 4. Privileged Identity Management
    

Read in English Save
 * Add to Collections
 * Add to Plan

Table of contents Read in English Add to Collections Add to Plan Edit


--------------------------------------------------------------------------------

SHARE VIA

Facebook x.com LinkedIn Email

--------------------------------------------------------------------------------

Print
Table of contents


WHAT IS MICROSOFT ENTRA PRIVILEGED IDENTITY MANAGEMENT?

 * Article
 * 01/06/2025
 * 23 contributors

Feedback


IN THIS ARTICLE

     
 1.  Reasons to use
     
 2.  License requirements
     
 3.  What does it do?
     
 4.  What can I do with it?
     
 5.  Who can do what?
     
 6.  Terminology
     
 7.  Role assignment overview
     
 8.  Scenarios
     
 9.  Microsoft Graph APIs
     
 10. Next steps
     

Show 6 more

Privileged Identity Management (PIM) is a service in Microsoft Entra ID that
enables you to manage, control, and monitor access to important resources in
your organization. These resources include resources in Microsoft Entra ID,
Azure, and other Microsoft Online Services such as Microsoft 365 or Microsoft
Intune. The following video explains important PIM concepts and features.






REASONS TO USE

Organizations want to minimize the number of people who have access to secure
information or resources, because that reduces the chance of

 * a malicious actor getting access
 * an authorized user inadvertently impacting a sensitive resource

However, users still need to carry out privileged operations in Microsoft Entra
ID, Azure, Microsoft 365, or SaaS apps. Organizations can give users
just-in-time privileged access to Azure and Microsoft Entra resources and can
oversee what those users are doing with their privileged access.


LICENSE REQUIREMENTS

Using Privileged Identity Management requires licenses. For more information on
licensing, see Microsoft Entra ID Governance licensing fundamentals .


WHAT DOES IT DO?

Privileged Identity Management provides time-based and approval-based role
activation to mitigate the risks of excessive, unnecessary, or misused access
permissions on resources that you care about. Here are some of the key features
of Privileged Identity Management:

 * Provide just-in-time privileged access to Microsoft Entra ID and Azure
   resources
 * Assign time-bound access to resources using start and end dates
 * Require approval to activate privileged roles
 * Enforce multifactor authentication to activate any role
 * Use justification to understand why users activate
 * Get notifications when privileged roles are activated
 * Conduct access reviews to ensure users still need roles
 * Download audit history for internal or external audit
 * Prevents removal of the last active Global Administrator and Privileged Role
   Administrator role assignments


WHAT CAN I DO WITH IT?

Once you set up Privileged Identity Management, you'll see Tasks, Manage, and
Activity options in the left navigation menu. As an administrator, you can
choose between options such as managing Microsoft Entra roles, managing Azure
resource roles, or PIM for Groups. When you choose what you want to manage, you
see the appropriate set of options for that option.




WHO CAN DO WHAT?

For Microsoft Entra roles in Privileged Identity Management, only a user who is
in the Privileged Role Administrator or Global Administrator role can manage
assignments for other administrators. Global Administrators, Security
Administrators, Global Readers, and Security Readers can also view assignments
to Microsoft Entra roles in Privileged Identity Management.

For Azure resource roles in Privileged Identity Management, only a subscription
administrator, a resource Owner, or a resource User Access Administrator can
manage assignments for other administrators. Users who are Privileged Role
Administrators, Security Administrators, or Security Readers don't by default
have access to view assignments to Azure resource roles in Privileged Identity
Management.


TERMINOLOGY

To better understand Privileged Identity Management and its documentation, you
should review the following terms.

Expand table

Term or concept Role assignment category Description eligible Type A role
assignment that requires a user to perform one or more actions to use the role.
If a user is eligible for a role, they can activate the role when they need to
perform privileged tasks. There's no difference in the access given to someone
with a permanent versus an eligible role assignment. The only difference is that
some people don't need that access all the time. active Type A role assignment
that doesn't require a user to perform any action to use the role. Users
assigned as active have the privileges assigned to the role. activate The
process of performing one or more actions to use a role that a user is eligible
for. Actions might include performing a multifactor authentication (MFA) check,
providing a business justification, or requesting approval from designated
approvers. assigned State A user that has an active role assignment. activated
State A user that has an eligible role assignment, performed the actions to
activate the role, and is now active. Once activated, the user can use the role
for a preconfigured period of time before they need to activate again. permanent
eligible Duration A role assignment where a user is always eligible to activate
the role. permanent active Duration A role assignment where a user can always
use the role without performing any actions. time-bound eligible Duration A role
assignment where a user is eligible to activate the role only within start and
end dates. time-bound active Duration A role assignment where a user can use the
role only within start and end dates. just-in-time (JIT) access A model in which
users receive temporary permissions to perform privileged tasks, which prevents
malicious or unauthorized users from gaining access after the permissions
expire. Access is granted only when users need it. principle of least privilege
access A recommended security practice in which every user is provided with only
the minimum privileges needed to accomplish the tasks they're authorized to
perform. This practice minimizes the number of Global Administrators and instead
uses specific administrator roles for certain scenarios.


ROLE ASSIGNMENT OVERVIEW

The PIM role assignments give you a secure way to grant access to resources in
your organization. This section describes the assignment process. It includes
assign roles to members, activate assignments, approve or deny requests, extend
and renew assignments.

PIM keeps you informed by sending you and other participants email
notifications. These emails might also include links to relevant tasks, such
activating, approve or deny a request.

The following screenshot shows an email message sent by PIM. The email informs
Patti that Alex updated a role assignment for Emily.




ASSIGN

The assignment process starts by assigning roles to members. To grant access to
a resource, the administrator assigns roles to users, groups, service
principals, or managed identities. The assignment includes the following data:

 * The members or owners to assign the role.
 * The scope of the assignment. The scope limits the assigned role to a
   particular set of resources.
 * The type of the assignment
   * Eligible assignments require the member of the role to perform an action to
     use the role. Actions might include activation, or requesting approval from
     designated approvers.
   * Active assignments don't require the member to perform any action to use
     the role. Members assigned as active have the privileges assigned to the
     role.
 * The duration of the assignment, using start and end dates or permanent. For
   eligible assignments, the members can activate or requesting approval during
   the start and end dates. For active assignments, the members can use the
   assigned role during this period of time.

The following screenshot shows how administrator assigns a role to members.



For more information, check out the following articles: Assign Microsoft Entra
roles, Assign Azure resource roles, and Assign eligibility for a PIM for Groups


ACTIVATE

If users are eligible for a role, then they must activate the role assignment
before using the role. To activate the role, users select specific activation
duration within the maximum (configured by administrators), and the reason for
the activation request.

The following screenshot shows how members activate their role to a limited
time.



If the role requires approval to activate, a notification appears in the upper
right corner of the user's browser informing them the request is pending
approval. If an approval isn't required, the member can start using the role.

For more information, check out the following articles: Activate Microsoft Entra
roles, Activate my Azure resource roles, and Activate my PIM for Groups roles


APPROVE OR DENY

Delegated approvers receive email notifications when a role request is pending
their approval. Approvers can view, approve, or deny these pending requests in
PIM. After the request is approved, the member can start using the role. For
example, if a user or a group was assigned with Contribution role to a resource
group, they are able to manage that particular resource group.

For more information, check out the following articles: Approve or deny requests
for Microsoft Entra roles, Approve or deny requests for Azure resource roles,
and Approve activation requests for PIM for Groups


EXTEND AND RENEW ASSIGNMENTS

After administrators set up time-bound owner or member assignments, the first
question you might ask is what happens if an assignment expires? In this new
version, we provide two options for this scenario:

 * Extend – When a role assignment nears expiration, the user can use Privileged
   Identity Management to request an extension for the role assignment
 * Renew – When a role assignment expires, the user can use Privileged Identity
   Management to request a renewal for the role assignment

Both user-initiated actions require an approval from a Global Administrator or
Privileged Role Administrator. Admins don't need to be in the business of
managing assignment expirations. You can just wait for the extension or renewal
requests to arrive for simple approval or denial.

For more information, check out the following articles: Extend or renew
Microsoft Entra role assignments, Extend or renew Azure resource role
assignments, and Extend or renew PIM for Groups assignments


SCENARIOS

Privileged Identity Management supports the following scenarios:


PRIVILEGED ROLE ADMINISTRATOR PERMISSIONS

 * Enable approval for specific roles
 * Specify approver users or groups to approve requests
 * View request and approval history for all privileged roles


APPROVER PERMISSIONS

 * View pending approvals (requests)
 * Approve or reject requests for role elevation (single and bulk)
 * Provide justification for my approval or rejection


ELIGIBLE ROLE USER PERMISSIONS

 * Request activation of a role that requires approval
 * View the status of your request to activate
 * Complete your task in Microsoft Entra ID if activation was approved


MICROSOFT GRAPH APIS

You can use Privileged Identity Management programmatically through the
following Microsoft Graph APIs:

 * PIM for Microsoft Entra roles APIs
 * PIM for groups APIs


NEXT STEPS

 * License requirements to use Privileged Identity Management
 * Securing privileged access for hybrid and cloud deployments in Microsoft
   Entra ID
 * Deploy Privileged Identity Management





--------------------------------------------------------------------------------


FEEDBACK

Was this page helpful?

Yes No
Provide product feedback

--------------------------------------------------------------------------------


ADDITIONAL RESOURCES



--------------------------------------------------------------------------------

Training

Module

Examine Privileged Identity Management - Training

This module examines how Microsoft Entra Privileged Identity Management (PIM)
ensures users in your organization have just the right privileges to perform the
tasks they need to accomplish.

Certification

Microsoft Certified: Identity and Access Administrator Associate -
Certifications

Demonstrate the features of Microsoft Entra ID to modernize identity solutions,
implement hybrid solutions, and implement identity governance.



English (United States)
California Consumer Privacy Act (CCPA) Opt-Out Icon Your Privacy Choices
Theme
 * Light
 * Dark
 * High contrast

 * 
 * Previous Versions
 * Blog
 * Contribute
 * Privacy
 * Terms of Use
 * Trademarks
 * © Microsoft 2025


ADDITIONAL RESOURCES



--------------------------------------------------------------------------------

Training

Module

Examine Privileged Identity Management - Training

This module examines how Microsoft Entra Privileged Identity Management (PIM)
ensures users in your organization have just the right privileges to perform the
tasks they need to accomplish.

Certification

Microsoft Certified: Identity and Access Administrator Associate -
Certifications

Demonstrate the features of Microsoft Entra ID to modernize identity solutions,
implement hybrid solutions, and implement identity governance.




IN THIS ARTICLE



English (United States)
California Consumer Privacy Act (CCPA) Opt-Out Icon Your Privacy Choices
Theme
 * Light
 * Dark
 * High contrast

 * 
 * Previous Versions
 * Blog
 * Contribute
 * Privacy
 * Terms of Use
 * Trademarks
 * © Microsoft 2025