Auto-Import Entra ID (Active Directory) Contacts to Digital Business Cards

Auto-Import Entra ID (Active Directory) Contacts to Digital Business Cards

book reader icon
3 Minutes
facebook logo gray
linkedin logo gray
mail logo gray

This article will guide you how to import contacts from your Microsoft Entra ID (Active Directory) and to create Digital Business Cards for them in bulk.

This post contains technical details for your IT department managing Microsoft Azure Entra ID (Active Directory). Please get in touch with an IT expert on your end to help you in setting up everything. Please make sure that the person who is doing the configuration on Microsoft Azure has the necessary Administrator permissions.

What is a Digital Business Card?

A Digital Business Card is a Landing Page containing a person's or legal entity's contact data and business information. In addition, you can also embed a YouTube video or link your social media accounts like LinkedIn or Instagram.

You can quickly and easily share your Digital Business Card with a QR
Code from your Apple or Google Wallet, so current and future business partners may directly save contacts on their devices.

How the Integration with Active Directory/Entra ID works

To integrate your Microsoft Azure Active Directory/Entra ID with our QR Code Platform we use a connector to exchange information between your system and our system. We just need a couple of access credentials to be able to retrieve the needed data from your Entra ID.

How to Auto-Import Entra ID Contacts to Digital Business Cards

1. Create Enterprise Application in Entra ID

In order to set up your Active Directory/Entra ID you need to do 2 steps. First, create an Enterprise Application and second Grant API Permissions for that Enterprise Application. Lets start with the first step.

To connect our QR Code Platform to your Active Directory/Entra ID you need to create a so-called Enterprise Application. This Enterprise Application is a representation of our QR Code Platform in your Microsoft Azure Account.

First, make sure that you are logged into your Microsoft Azure Account. You can reach the Microsoft Azure Portal via portal.azure.com.

Next, open the Entra ID Service. You can find the Service with a search in the search bar by typing "Microsoft Entra ID".

Open the Microsoft Entra ID service
Open the Microsoft Entra ID service

In the Microsoft Entra ID service click on the menu Enterprise Applications in the section Manage (on the left side).

Go to Enterprise applications
Go to Enterprise applications

To create a new Enterprise Application click on New application.

click on New application
click on New application

Click on Create your own application.

Click on Create your own application
Click on Create your own application

Enter a name (we will use QR Code Platform in our example) for the application and choose option 3 (Non-gallery). Then click on Create.

Enter a name for the application and choose option 3 (Non-gallery)
Enter a name for the application and choose option 3 (Non-gallery)

Now we have to go into the App Overview. In order to get there we have to enter into the Entra ID Service once again.

Click in the top right of the screen either on Home or on Microsoft Azure - both should work. You will land on the Azure Homepage.

Click on Home OR on Microsoft Azure
Click on Home OR on Microsoft Azure

Now open the Entra ID service again. You can find the Service with a search in the search bar by typing "Microsoft Entra ID".

Open the Microsoft Entra ID service
Open the Microsoft Entra ID service

In the left menu of Entra ID open the submenu Manage and then choose App registrations. Then click above the list on All applications and then choose in the list the App that you just created - in our case thats QR Code Platform.

Go to Manager > App registrations, choose All applications and click on the App you just created
Go to Manager > App registrations, choose All applications and click on the App you just created

On the Overview area of the new application copy both Application (client) and Directory (tenant) ID; paste them into a word document and note which is which. Then, click Add Client credentials.

Click on Add Client credentials
Click on Add Client credentials

Click on New client secret.

Click on New client secret
Click on New client secret

Enter a Description for the client secret like Digital Business Card and click on the Add button. Choose the expiration date of the secret depending on if and when you want to use the Auto-Import feature again in the future - default is 180 days. If you just need it today you can choose a shorter time-frame.

Enter a description and click on the button Add
Enter a description and click on the button Add

Copy the code from the Value column (NOT the Secret ID column) into a word document and write Client Secret Value next to it so you know later which value it is. We will need them later.

Copy the Value as Client Secret Value
Copy the Value as Client Secret Value

2. Grant API Permissions in Entra ID

Now its time to grant API permissions to our just created app. On the left menu sidebar click on the menu API permissions and then on Add a permission.

Click on the menu API permissions and then on the button Add a permission.
Click on the menu API permissions and then on the button Add a permission.

Then choose Microsoft Graph with type Application permissions and on the screen search and add the following permissions: User.Read.All and Directory.Read.All. Make sure that the permission is checked in the list.

Choose Microsoft Graph and then add User.Read.All and Directory.Read.All permissions.
Choose Microsoft Graph and then add User.Read.All and Directory.Read.All permissions.

Now its necessary that a user with admin privileges grants his consent via clicking on the button Grant admin consent for Your Company.

Make sure a user with admin privileges grants the API permissions by clicking on Grant admin consent
Choose Microsoft Graph and then add User.Read.All and Directory.Read.All permissions.

Now Entra ID is ready for the data to be fetched.

3. Log into your QR platform

Please log into your account on our QR Platform.

Login

Login
Login Form

4. Open your account's Integrations Page

Once logged in, go to Integrations and choose Entra ID (Active Directory) Import.

Choose Entra ID Import
Choose Entra ID Import

5. Connect to Entra ID

Then its time to enter the Client ID and Client Secret. Use the copied values from before. For the Client ID use the value from "Application (client) ID" and for the Client Secret use the value from the "Value" column from before that you saved into your word document as Client Secret Value. At last, fill in the "Directory (tenant) ID" from before. 

Paste in the Client Id, Client Secret and Tenant ID from before.
Paste in the Client Id, Client Secret and Tenant ID from before.

6. Set Import Parameters

Choose the type of import, template and folder you want to import to.
Business Card Import Options
Business Card Import Options

Automatically sync daily

Activate this option to automatically synchronize your contacts on a daily basis.

Auto sync of Business Cards
Auto sync of Business Cards

7. Connect your accounts

Hit Connect.

Connect Button
Conntect button.

Now, a message will be displayed at the top of the screen, informing you about the successful connection of your accounts.

Success message
Success message

8. Import your contacts

Skip any unwanted contacts

Please choose which contacts should be imported; by default, any contacts not already imported by another user of your account (or yourself) will be selected. Deselect any unwanted contacts.

Contact import page.
Contact import page.

Hit Import

Last but not least, click Import to start the process.
Import Button.
Hit the button!

You are ready to go

After a short moment, you will find all imported entries in the selected folder or the root directory of your account.

Congratulations, you've successfully auto-imported contacts via an integration!

Imported Contacts
Imported Contacts
Last update 2 days ago