Skip to main content

Set up Microsoft Entra Agent ID for Microsoft Agent 365 integration (preview)

Create a governed Microsoft Entra Agent ID and its associated agent user while deploying a new Azure SRE Agent. Use the Agent ID for native Teams integration and configuration with Microsoft Purview and Microsoft Defender through Microsoft Agent 365.

The identity is separate from the agent's user-assigned managed identity (UAMI) for Azure resource access.

Prerequisites​

  • An Azure subscription and permissions to create an SRE Agent.
  • The object ID of a sponsor: a user, or a Microsoft 365 or dynamic-membership group, in the subscription's tenant. Security groups aren't supported. In the Microsoft Entra admin center, find the user under Users or the group under Groups > All groups, and copy its Object ID.
  • The subscription's Microsoft Entra tenant ID, plus an agreed user name, domain, and display name for the agent user.

Create an agent with an agent identity​

important

Agent ID may result in data being sent to the customer's sign-up regions. For more details, review Agent 365 data handling.

  1. Go to the SRE Agent portal, sign in, and select Create agent.

  2. Complete Basics, including the subscription, resource group, name, region, model provider, and Application Insights. Configure the UAMI for Azure access as needed. See Configure basics.

  3. Select Next to open Advanced setup.

  4. Under Agent identity (preview), select the Set up agent identity checkbox and complete the identity and agent user fields:

    FieldWhat to provide
    Identity nameA name for the governed identity, such as sre-ops. Required.
    Sponsor object IDThe Object ID of the sponsoring user or group. Required.
    Tenant IDLeave the prefilled subscription tenant. Only that tenant is accepted.
    Display nameRequired. The service appends (SRE Agent) to the agent user's display name.
    User name and DomainBoth required; together they form the agent user's email address, such as sre-oncall@contoso.com.
    ManagerYour signed-in user account. It can't be changed in the wizard.
  5. Continue to Review + create. Verify the agent configuration, identity, sponsor, tenant, and agent user.

  6. Start deployment and follow Deploy until it succeeds.

Verify the provisioned identity​

  1. Open the agent and go to Settings > General.
  2. Confirm Agent identity shows your identity name. Select it to open the identity in Microsoft Entra.

Next steps​

For the distinction between governed identities and managed identities, see Agent identity.

Was this page helpful?