Integrate the Address Book with Microsoft Entra ID

You can sync your Microsoft Entra ID directory with the FacilityOS Address Book to keep it automatically up to date.

Before you start

Read the following prerequisites before integrating the Address Book with Microsoft Entra ID:

• Make sure you have a Microsoft Entra ID Global Administrator account.
• Review the Security and confidentiality of data section.
• If your Address Book already contains Hosts that were added manually, syncing with Microsoft Entra ID will not update their information. To ensure Host details are updated automatically, delete any manually added Hosts. To learn how, see Delete a Host.

Integrate the Address Book with Microsoft Entra ID

1. Contact FacilityOS support to request the Address Book sync integration with Microsoft Entra ID. If your organization requires Gov Cloud to be enabled for the integration, make sure to mention it in your request.
2. After your request is processed, you will receive an integration URL. Open the URL.
3. Sign in with your Microsoft Entra ID credentials.
4. Review and approve the requested permissions. In your Microsoft Entra admin center, an enterprise application named "FacilityOS Entra ID" is added.
5. You will need to create a security group in Entra ID for each site in FacilityOS. To learn how to create groups in Entra ID, see Create a basic group and add members. 
6. After creating your groups, send FacilityOS support the group names and the sites they belong to so they can complete the integration.

Verify the sync in FacilityOS

1. In FacilityOS, from the left sidebar, click Manage, then select Address Book.
   
2. Successfully synced employees have a lock icon.

3. Select an employee to view details such as name, email address, phone number, and site assignment.

   Important:

   To edit an employee's details, make the changes in Microsoft Entra ID.