Configure Microsoft Viva Engage for external content indexing

Register an OAuth 2.0 application in the Microsoft Entra admin center to allow the Microsoft Viva Engage external content connector to access your Microsoft Viva Engage source system.

Before you begin

You need the following credentials and permissions for your organization in the Microsoft Entra admin center:

• Login credentials
• Permission to register an application
• Permission to add API permissions to an application
• Permission to create client secrets for an application

Role required: none

About this task

The Microsoft Viva Engage external content connector retrieves content from your Microsoft Viva Engage source system using the Yammer API.

To enable the connector to access your Microsoft Viva Engage source system via these APIs, you must configure an OAuth 2.0 application in the Microsoft Entra admin center. Your connector administrator can use settings copied from this Microsoft Entra application to configure the Microsoft Viva Engage external content connector for proper connection to your Microsoft Viva Engage source system.

Procedure

1. Register a new application in the Microsoft Entra admin center.

   1. Log in to the Microsoft Entra admin center at https://entra.microsoft.com/.

      Note: If your Microsoft Viva Engage tenant is in the Microsoft 365 GCC or GCC High cloud or the Microsoft 365 DoD cloud, log in at https://entra.microsoft.us/ instead.

   2. Select Applications > App registrations.

   3. On the App registrations page, select New registration.

4.  On the Register an application form, fill in the following fields:

    |Field|Instructions|
    |-----|------------|
    |Name|Enter a unique name for your OAuth 2.0 application. For example, you might enter `Microsoft Viva Engage external content connector`.|
    |Supported account types|Select **Accounts in this organizational directory only \(&lt;instance-name&gt; only - Single tenant\)**, where `<instance-name>` is the name of your Microsoft Entra instance.|
    |Redirect URI \(optional\)|Select **Web** as the redirect URI type, then enter `https://<instance-name>.service-now.com/oauth_redirect.do` as the URI, replacing `<instance-name>` with the hostname for the ServiceNow AI Platform® instance where the Microsoft Viva Engage external content connector will be created.|

5.  Select **Register**.

    The new application's Overview page appears.

1. Record the values of the new application's Application (client) ID and Directory (tenant) ID properties in a secure location.

**Important:** Your connector administrator needs the application's tenant and client IDs to configure a Microsoft Viva Engage external content connector.

1. Create a client secret for the new application.

   1. In the application menu, select Manage > Certificates & secrets.

   2. Select Client secrets, then select New client secret.

3.  In the Add a client secret pane, enter a description for the secret and select its expiration period, then select **Add**.

    The new client secret appears in the Client secrets list.

4.  Copy the new client secret's **Value** and record it in a secure location.

    **Important:** Your connector administrator needs the value of this client secret to configure a Microsoft Viva Engage external content connector.

1. Add the Yammer API permission required by the Microsoft Viva Engage external content connector.

   1. In the application menu, select Manage > API permissions.

2.  Select **Add a permission**, then select **Yammer**.

3.  Select **Delegated permissions**, then select the option for the **user\_impersonation** permission and select **Add permissions**.

    The new Yammer API permission appears in the application's Configured permissions list.

What to do next

Provide the following items to your connector administrator:

• The OAuth 2.0 application's tenant ID and client ID that you recorded in step 2.
• The client secret value that you recorded in step 3.d.

Your connector administrator needs these items to configure a Microsoft Viva Engage external content connector to retrieve searchable content and security principals from your Microsoft Viva Engage instance.

For details on creating and configuring a Microsoft Viva Engage external content connector, see Create a Microsoft Viva Engage external content connector.

Parent Topic:Microsoft Viva Engage external content connector