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.
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 serviceIn the Microsoft Entra ID service click on the menu Enterprise Applications in the section Manage (on the left side).
Go to Enterprise applicationsTo create a new Enterprise Application click on New application.
click on New applicationClick on Create your own application.
Click on Create your own applicationEnter 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)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 AzureNow 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 serviceIn 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 createdOn 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 credentialsClick on New client secret.
Click on New client secretEnter 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 AddCopy 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 Value2. 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.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.Now its necessary that a user with admin privileges grants his consent via clicking on the button Grant admin consent for Your Company.
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.
4. Open your account's Integrations Page
Once logged in, go to Integrations and choose Entra ID (Active Directory) Import.
Choose Entra ID Import5. 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.6. Set Import Parameters
Business Card Import OptionsAutomatically sync daily
Activate this option to automatically synchronize your contacts on a daily basis.
Auto sync of Business Cards7. Connect your accounts
Conntect button.Now, a message will be displayed at the top of the screen, informing you about the successful connection of your accounts.
Success messagePlease 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.Hit Import
Last but not least, click Import to start the process.
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