Microsoft Entra ID Governance
Governance

Configure custom extensions for PIM role activation

In brief

The article no longer labels custom extensions for PIM role activation as preview, and removes the preview legal notice and beta endpoint note.

What Entra admins need to know

No administrator 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.

Configure custom extensions for Privileged Identity Management role activation (Preview)

Custom extensions in Microsoft Entra Privileged Identity Management (PIM) enable organizations to integrate custom business logic into the role activation process. These extensions are implemented as REST APIs that PIM calls during policy evaluation. The custom extension evaluates the activation request and returns a decision to PIM indicating whether the activation should be allowed or denied.

:::image type="content" source="media/privileged-identity-management-custom-extensions/custom-extension-architecture-flow.png" alt-text="Diagram that shows the PIM custom extension architecture flow from activation request through policy evaluation to the custom extension API and external services." lightbox="media/privileged-identity-management-custom-extensions/custom-extension-architecture-flow.png":::

License requirements

Using custom extensions with PIM requires an active Microsoft Entra ID Governance or Microsoft Entra Suite license. Microsoft Entra ID P2 alone doesn't include PIM custom extensions. For more information, see Microsoft Entra ID Governance licensing fundamentals.

  • An assignment of at least the Privileged Role Administrator role.

  • A REST API endpoint that accepts HTTP POST requests and returns evaluation responses in the format PIM expects. The API can be built in any language and hosted on any platform.

  • A Microsoft Entra ID application registration to secure communication between PIM and your custom extension endpoint.

  • The Microsoft Graph API beta endpoint is required because this feature is in preview.

  • The following delegated Microsoft Graph permissions, depending on the operation:

    | Operation | Permission (least privileged) |

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…