This page lists what to configure in your Microsoft tenant for the Microsoft Agent 365 Registry POP. You register an application in Microsoft Entra ID, give it read access to the agent registry, and collect the values the POP needs. For how to do each task in Microsoft Entra ID, follow the linked Microsoft documentation.
The Platform signs in to your tenant as this application and only reads the agent registry. Each POP uses one application. After you finish, create the POP with the values you collected. See POP Setup for more information.
Prerequisites
Before you start, ensure you have:
- A Microsoft tenant with Microsoft Agent 365, and agents in its registry.
- Permission in that tenant to register applications.
- A Global Administrator or Privileged Role Administrator to grant admin consent in Step 3.
Step 1: Register the Application
Register an application in Microsoft Entra ID with these settings. See Register an application in the Microsoft documentation.
| Setting | Value |
|---|---|
| Supported account types | Single tenant (accounts in your organizational directory only). |
| Redirect URI | None. The Platform signs in without it. |
Step 2: Create a Client Secret
Add a client secret to the application. See Add and manage application credentials in the Microsoft documentation.
Copy the secret's value, not its secret ID. Microsoft shows the value only once. Note the expiry date: when the secret expires, the POP stops discovering agents. See Rotating the Client Secret in POP Setup.
Step 3: Grant Registry Permissions
Add this Microsoft Graph permission to the application, then have a Global Administrator or Privileged Role Administrator grant admin consent for your tenant:
| Permission | Type |
|---|---|
CopilotPackages.Read.All |
Application |
See Configure an application to access a web API and Grant tenant-wide admin consent to an application in the Microsoft documentation.
The POP only reads the registry. Don't add write permissions.
Step 4: Collect the Connection Values
Copy these values from the application. You enter them when you create the POP:
| Value in Microsoft Entra ID | POP field |
|---|---|
| Directory (tenant) ID | Tenant ID |
| Application (client) ID | Client ID |
| Client secret value from Step 2 | Client Secret |
Store the client secret securely until you enter it in the POP.