Skip to main content

Set Up Microsoft 365 User Sync Services

Set up Microsoft 365 User Sync in Yeeflow for seamless user integration and management, ensuring alignment with Azure AD updates

Microsoft 365 sign-in and directory synchronization serve different purposes. This guide sets up directory synchronization for the users and profile fields you select.

Connect the Microsoft 365 directory (Microsoft Entra ID, formerly Azure AD) to add users within the selected sync scope and update mapped profile fields when they change in Microsoft 365. Review the scope before starting the first sync.

Deleting a user from Microsoft 365 does not automatically remove their Yeeflow account. Review that account separately in Yeeflow user management. To revoke access, follow the steps to deactivate the Yeeflow user.

Use a Yeeflow system administrator account and a Microsoft 365 administrator who is authorized to approve the requested directory access.

Before you start

Before you start, here are some things to know before this process.

  • You need to be an administrator in Microsoft 365 directory to connect it.

  • You need to understand which users or groups in Microsoft 365 directory should be Yeeflow users.

  • You need to decide which information in Microsoft 365 directory should be updated in Yeeflow.

  • You need to add or update the user fields of Yeeflow which will sync from Microsoft 365.

Set up the sync service

Firstly, login to Yeeflow with the system admin account, then go to the Admin center. From the left navigation panel click to expand the "User management", and click "User sync":

Earlier Admin Center navigation with User management expanded and User sync highlighted.

If you haven't configure the Microsoft 365 user sync service yet, the status will show as "Not connected".

Click on this section to open the Microsoft 365 user sync configuration page.

Click the "Connect Microsoft 365" button to start the step by step configuration.

Firstly, the system requires to connect with your Microsoft 365 tenant with the Microsoft 365 administrator account. Click the "Connect" button to login with your Microsoft 365 account.

Sign in to the intended Microsoft 365 tenant and review the organization and requested permissions. Select Accept if you’re authorized to approve the request and it matches the planned sync.

After login, the next step is to choose which Microsoft 365 user properties you want to include when sync users to Yeeflow.

The left column shows the name of the user properties in Microsoft 365, while the right column show the mapped Yeeflow user properties (fields of Yeeflow users list). By default, the UPN from Microsoft 365 is automatically mapped with Yeeflow login account.

Select + Add field to map another attribute. For example, choose DisplayName on the Microsoft 365 side and User Name on the Yeeflow side, then select OK.

Please refer to below [Configuring Parameters] for directory mapping.

Configuring Parameters

Use the table to compare the Microsoft 365 source property with its Yeeflow destination and check any mapping rules.

Grid in AAD

Name in AAD

Name in Office 365

Name in Yeeflow

ID(Yeeflow)

Field Type

Remarks(Yeeflow)

Identity

userPrincipalName

UPN (userPrincipalName)

Login Account (SPAccount)

Login Account

String

ReadOnly and defaulted;
e.g. alias@domain

Identity

Name

DisplayName (displayName)

User Name (Name)

Name_CN

String

Shown as an added mapping in the earlier wizard. Check the current mapping controls.

Identity

User name

Email (mail)

Email(Email)

Email

String

Customizable

Identity

Last name

Surname (surname)

String

New and Customizable

Identity

First name

GivenName (givenName)

String

New and Customizable

Identity

User type

UserType (userType)

String

New and Customizable

Summary

Image

Photo (special_photo)

Profile Picture (Photo)

Profile Picture

Image

Customizable

Job info

Job title

JobTitle (jobTitle)

Job Title (JobTitle)

JobTitle

String

Customizable

Job info

Manager

LineManagers (special_lineManager)

Line Manager (LineManager)

Line Manager

User

Customizable;
Manager should be in Yeeflow users or sync list, else it will be blank

Job info

Department

Department (special_department)

Department (DepartmentID)

Department

String

Create a new one when first syncing

Contact info

Country or region

Country (country)

String

New and Customizable

Contact info

Office

OfficeLocation (officeLocation)

String

New and Customizable

Contact info

City

City (city)

String

New and Customizable

Contact info

Mobile phone

mobilePhone (mobilePhone)

Mobile No. (Mobile)

Mobile

String

Customizable

Contact info

ZIP or postal code

PostalCode (postalCode)

String

New and Customizable

CompanyName (companyName)

String

New and Customizable

EmployeeId (employeeId)

Employee No.(EmployeeNo)

EmployeeNo

String

Customizable

FaxNumber (faxNumber)

String

New and Customizable

After the mapping of selected fields are set, click the "Continue" button to jump to the next step.

Choose Sync all users or Specific groups. For example, use Specific groups to limit synchronization to members of the Sales Team, Designers, Engineering, and Marketing groups.

Specific groups selected in the earlier Microsoft 365 user sync wizard.

You can find the available user groups from your Microsoft 365 admin center.

Click "Continue" and click the "Start syncing users" button on the next step to complete the configuration.

The service page shows Job Running while the job is in progress. After it finishes, select Manage users and check that an expected member appears with the intended login account and a correctly mapped field. If a member is missing, check the sync status, scope, and directory group membership.

Job Running status next to Manage users on the connected Microsoft 365 sync page.

Manage the sync service

After your configuration, you may need to know more about how to managing this services.

Please go to Monitoring and Managing User Sync Services . You may run a manual sync, edit the services or stop it.


​
​

Did this answer your question?