How to set up the Azure Active Directory integration

A step by step guide to linking your Azure Active Directory to SwipedOn

To set up a sync from your Azure Active Directory to SwipedOn, click Setup on the Azure Active Directory card on the Integrations page, then follow the steps below. 

Connect to your Azure Active Directory account

Connect to your Azure Active Directory account by inputting the Tenant ID, Client ID and Client Secret, then click on the 'Connect' button. If you don't know how to find these details, check out this article.

Select the Azure Group you would like to map to SwipedOn

If you can choose to sync all users from Azure Active Directory, or only those within a group. Click on the drop-down button to the right to select the group you would like to map to SwipedOn or type in the name of the group if you have a large number to select from.

Once selected, click on the 'Map' button. To sync all users, click 'Skip.'

Map your SwipedOn employee custom fields to your Azure categories

Click on the drop-down arrow to select the Azure categories you would like to map to SwipedOn. 

By default, an employee's first name, last name, and email address will be synced with SwipedOn. You will also need to select a field to map to Location, such as Office or Street Address.

Choose the phone number field in Azure that contains mobile numbers to map to the 'Mobile' field within SwipedOn; this field ensures your employees can receive SMS notifications from SwipedOn.

Important note: please ensure the mapped phone field value recorded within Azure contains the prefix country code at the beginning of the phone record for each employee, e.g. 64 021 123 4567, when mapping against the 'Mobile' field.

If you wish to synchronise other data about employees from Azure, you can map fields to employee custom fields in SwipedOn. Useful examples could be Job Title or Department. So long as the custom field is set up in SwipedOn, you can select it from the relevant drop-down box to link it to an Active Directory field. Once you have fields linked, click the 'Map' button to continue.

Map your SwipedOn Locations to Azure

To map Locations, click on the drop-down arrow next to the relevant Location and select from the available values for the Location field that you mapped in the previous step. You can map multiple values from Azure to a single SwipedOn Location if you wish.

If you wish to assign users who don't have a value for your mapped Location field, use the checkbox at the bottom of the window and select your location from the drop-down.

Click on the 'Map' button to complete this step.

Final confirmation before sync

If any existing employees are already added within the SwipedOn web dashboard, and their email address doesn't match a user in Azure Active Directory, the below screen will appear. You can choose to remove these users from SwipedOn, which will archive them, or ignore them. Ignoring these employees will exclude them from any future synchronisation.

Once the locations have been mapped, the Azure Active Directory will generate the below report to confirm all data is input correctly. Click 'Sync' to complete setup and beginning synchronising users from Azure.

A sync report will then appear, if any employees did not sync across, a report will show below the 'Issues' header, please note these make the necessary changes to successfully sync the employee.