/
Microsoft Entra ID integration

Microsoft Entra ID integration

Manually managing user data is time-consuming and often leads to errors, especially for larger teams. To solve this, Cosmos now supports Microsoft Entra ID integration, making it easy to sync accurate employee information directly into your intranet.

Microsoft has rebranded Azure Active Directory (Azure AD) to Microsoft Entra ID to better reflect its multi-cloud capabilities and reduce confusion with Windows Server Active Directory. Despite the new name, features, licensing, and integrations remain unchanged. Existing setups will continue to work without any action required → Read More.

Prerequisites

Before proceeding with the integration of Microsoft Entra ID with the Cosmos Employee Database, ensure you meet the following criteria:

  1. Administrator access to Microsoft Entra ID portal: You need administrative access to configure settings and manage integrations within Azure.

  2. Administrator permissions for Cosmos: Full administrative rights in Confluence and Cosmos to enable and manage the Entra ID integration.

Before connecting Microsoft Entra ID, make sure all Confluence users are synced to the Cosmos Employee Database as described in this step.

Step-by-step guide

  1. In the top right corner, click on the Connect MS Entra ID button.

  2. Go to the Microsoft Azure Portal.

  3. Copy the Tenant ID.

Screenshot 2024-06-18 at 10.56.56.png

  1. Return to Cosmos and enter your Tenant ID. Choose whether to match users by User Principal Name or Email.

This is an important step, as the email in Confluence must match the selected field. This information is used to match users between the two systems and sync their data.

  1. Click the Connect button.

  2. A new tab will open with the Microsoft Entra ID authentication screen. Approve the connection.

  3. Once authorized, return to the Cosmos Employee Database and select the Entra fields you want to sync.

Following Entra ID fields are available: Manager, Job Title, Department, Office Location, Hire Date, Leave Date, Company, City, State, Country, Postal Code, and Street Address.

This is not the final list of supported features. Support for additional Entra ID fields required for a fully functional intranet in Confluence will be added soon.

  1. Click the Complete button to start the sync process.

  2. A progress bar will appear, showing the remaining time to finalize the integration.

Syncing approximately 10,000 Confluence users takes around 2–3 minutes. Please do not refresh the page or close the tab during this process.

Screenshot 2024-06-18 at 11.06.20.png

Data sync after connection

After the initial connection, a webhook connection is created. All changes in Entra ID are then automatically reflected in the Employee Database, without the need for manual or repeated syncing.

Once connected, Entra ID fields are read-only and cannot be edited from Confluence. There is no two-way sync, data flows only from Entra ID to the Cosmos Employee Database, ensuring consistency with your organization's source of truth.

Entra ID settings

The Employee Database offers flexible options for managing Entra ID sync. Admins have full control over field selection, sync behavior, and integration status.

  • Enable or disable fields: All Entra ID fields are listed in the settings and can be turned on or off anytime without requiring a new sync.

  • Manual sync: Useful if some data appears missing, unavailable, or if there were any issues with the webhook connection.

  • Disconnect integration: The connection can be removed at any time. Once disconnected, all synced data will be deleted and hidden from the Employee Database.

Screenshot 2025-06-01 at 07.04.54.png

Utilization of MS Entra ID fields

Integrating Microsoft Entra ID with your Cosmos Employee Database enriches your intranet with valuable data. Here's how you can use these fields across Cosmos:

  • People Network filters: Use fields like department or job title to refine searches and help users find colleagues easily.

  • Collections: Group users by attributes such as department, location, or job title.

  • Dashboard Widgets: Use the Hire Date field to show upcoming work anniversaries and new starters. Personalize widgets by role, department, or location.

  • Org Charts: Build dynamic org charts using the manager field to visualize team structures.