How to Connect Microsoft Copilot Using a Client Secret

Use this topic when your organisation cannot use the Sign in with Microsoft OAuth flow and needs to connect Microsoft Copilot using a manually registered Microsoft Entra app and a client secret instead.

Before you begin

Note: For a video walkthrough of this procedure, see Copilot Connector video.

You need Global Administrator access in Microsoft Entra ID and access to the Forcepoint Data Security Cloud Platform.

Note: Microsoft Copilot monitoring depends on the Microsoft 365 Copilot (business) licence, which exposes the Copilot Compliance API. The Copilot Chat included with a Microsoft 365 E3 licence is not covered. At least one user in your tenant must hold a Microsoft 365 Copilot licence before any activity appears.

Use the following steps to register the Forcepoint connector app in Microsoft Entra ID, generate a client secret, and connect it in the Forcepoint Data Security Cloud Platform.

Steps

  1. Open the Entra admin center.
  2. On the Home page, copy the Tenant ID.

    You will need this value later when connecting the app in the Forcepoint Data Security Cloud Platform.

  3. Navigate to App registrations and click New registration.
    1. Enter a name for the app.
    2. Click Register.
  4. On the app's Overview page, copy the Application (client) ID.

    You will need this value later.

  5. Navigate to API permissions and click Add a permission.
    1. Click Microsoft Graph, then click Application permissions.
    2. Select the following permissions:
      • AgentIdentity.Read.All
      • AiEnterpriseInteraction.Read.All
      • Files.Read.All
      • Files.ReadWrite.All
      • Group.Read.All
      • Reports.Read.All
      • Sites.Read.All
      • Sites.ReadWrite.All
      • User.Read.All
    3. Click Add permissions.
    4. Click Grant admin consent for your organisation.
    5. Click Yes to confirm.
  6. Click Add a permission again.
    1. Click Office 365 Management APIs, then click Application permissions.
    2. Select ActivityFeed.Read.
    3. Click Add permissions.
  7. Navigate to Certificates & secrets and click Client secrets.
  8. Click New client secret, enter a description and an expiration, then click Add.
    Important: Copy the Value immediately. It becomes unavailable once you navigate away from this page — if you lose it, you must generate a new secret.
  9. Sign in to the Forcepoint Data Security Cloud Platform.
  10. Navigate to Connector > App Connector.
  11. Click Microsoft Copilot, then click Connect Microsoft Copilot.
  12. Under Authentication, select Client secret.
  13. Enter the Client ID, Client Secret, and Tenant ID you copied earlier.
  14. Click Connect.

Result

Microsoft Copilot is now connected using a client secret. The connector status updates to Connected in the Forcepoint Data Security Cloud Platform.

Note: After the connector is added, activity from the last seven days is backfilled. Microsoft provisions the Compliance API at its own pace, so data can take anywhere from a few minutes to a few hours to appear. If nothing appears after several hours, confirm that the monitored users hold a Microsoft 365 Copilot licence.