Success Portal

Set up the sync between Perform & Engage 365 and Microsoft Entra ID

Introduction

Required role: IT admins. Super admins with the Microsoft 365 global admin role can also set up the sync.

Perform & Engage 365 supports Microsoft Entra ID synchronization for organizations that use the previous synchronization experience. Organizations using the shared Zensai User Service use a separate synchronization workflow.

This article explains how to connect Microsoft Entra ID and configure the previous synchronization experience. For information about User Service synchronization, see this article.

 

IMPORTANT   

When you set up the sync between Perform & Engage 365 and Microsoft Entra ID, Super admins can still manually add new users, move users to other teams, and so on.

However, manual changes to information managed by the synchronization can be overwritten the next time synchronization runs.

 

Set up the sync between Perform & Engage 365 and Microsoft Entra ID

Required role: IT admins, Super admins with the Microsoft 365 global admin role.

1. Log in to Perform & Engage 365 on the web platform.

2. Select the cog icon > Integrations. The integrations page opens on the Teams tab.

3. Select the Microsoft Entra ID tab.

4. On the Microsoft Entra ID row, select Connect.

5. Sign in with your Microsoft 365 admin credentials.

Here, you'll see a list of permissions that are needed to set up the sync.

6. Review the permissions and when you're ready, select Accept for all the Microsoft permissions listed.

When the page reloads, you should see the Connected status on the Microsoft Entra ID row, with the following message: "Microsoft Entra ID is connected to Perform & Engage 365."

7. On the Microsoft Entra ID tab, select View details on the Microsoft Entra ID row. The User Sync - Microsoft Entra ID page opens on the Microsoft Entra ID Only tab.

8. Select Sync Settings to configure how Perform & Engage 365 synchronizes user information with Microsoft Entra ID. The Sync Settings dialog opens.

9. In the Strategy section, choose when synchronization runs:

  • Set the toggle to Manual refresh so you can control when synchronization starts.
  • Set the toggle to Daily refresh to set a sync schedule. Additional fields are displayed, where you can set the Refresh time by selecting from the drop-down. The time is shown in your local time zone, for example TZ: Europe/London. The time zone is taken from that specified in your user settings.

10. Choose how changes identified during synchronization are applied:

  • Select Manual comparison if you want an admin to review the differences between Perform & Engage 365 and Microsoft Entra ID before applying changes. The User Sync - Microsoft Entra ID page groups the results by synchronization status so the admin can review and act on them.
  • Select Auto-sync from Microsoft Entra ID if you want applicable Microsoft Entra ID changes to be applied automatically without manual approval.

11. In the Notifications section, choose whether you want to send an in-product notification when synchronization is complete.

  • Select No notification to skip the notification.
  • Select Send notification on refresh to send one. The Recipients drop-down is displayed, where you can select who receives the notification.

12. In the Filters section, choose whether you want to apply a Graph API filter. When enabled, the Definition text field is displayed, where you can enter or paste the Graph API filter.

13. To filter the synchronization scope by email address, enable Email. Enter text in Include emails containing and/or Exclude emails containing to control which email addresses are included in the synchronization scope.

14. To synchronize users from specific Microsoft Entra ID groups only, enable Group. In Groups, enter the Microsoft Entra ID group IDs you want to include in the synchronization scope. Separate multiple group IDs with commas.

15. Select Save.

If Manual refresh is configured, select Refresh on the User Sync - Microsoft Entra ID page when you want to start a synchronization.

 

Understand synchronization status

The User Sync - Microsoft Entra ID page groups users according to how their information compares between Perform & Engage 365 and Microsoft Entra ID:

  • Synchronised shows users whose details match between Perform & Engage 365 and Microsoft Entra ID.
  • Conflicts shows users who exist in both systems but whose details don't fully match.
  • Weekly10 Only shows users who exist in Perform & Engage 365 but don't have a matching account in Microsoft Entra ID.
  • Microsoft Entra ID Only shows users who exist in Microsoft Entra ID but not in Perform & Engage 365.

When you're using Manual comparison, the synchronization-status tabs enable you to review differences before applying the relevant changes.

For example, if the manager information doesn't match during user creation, the user is created in Perform & Engage 365 without a manager. Correct the manager information in Microsoft Entra ID, then run another synchronization to update the manager relationship in Perform & Engage 365.

 

Import users from Microsoft Entra ID

Users on the Microsoft Entra ID Only tab exist in Microsoft Entra ID but not in Perform & Engage 365.

When you select Import and create users, the selected users are created immediately in Perform & Engage 365 without asking for confirmation.

1. Select the users you want to import.

2. Select Import and create users.

If an imported user's manager doesn't yet exist in Perform & Engage 365, the user can still be created, but the manager isn't assigned. Review the Conflicts tab for the unresolved difference.

 

Stop the sync between Perform & Engage 365 and Microsoft Entra ID

Required role: IT admins, Super admins with the Microsoft 365 global admin role.

1. Log in to Perform & Engage 365 on the web platform.

2. Select the cog icon > Integrations. The integrations page opens on the Teams tab.

3. Select the Microsoft Entra ID tab.

4. On the Microsoft Entra ID row, select Disconnect.

Disconnecting the integration doesn't change existing user data in Perform & Engage 365. Existing synchronization settings are retained so they can be used if the integration is connected again.

 

If you encounter any issues while setting up the sync, contact Zensai Product Support.