×
Auto-create Digital Business Cards via SSO from Microsoft Entra ID

Auto-create Digital Business Cards via SSO from Microsoft Entra ID

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

Who is this article for?

This post is for companies who want to rollout digital business cards for their employees and give each employee the possibility to edit and manage his own digital business card.

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 does it work?

When an employee signs in via SSO for the first time on our portal his personal data is pulled from Microsoft Entra ID. An initial digital business card in the cooperate design containing basic data of the company is created.

After successfully login, the employee can enrich his digital business card with social links, videos, image galleries, custom C2A button and much more.

The company's administrator sets the boundaries. Depending on the policy, the admin can restrict what employees are allowed to change, for example by limiting everyone to a designated design template for the digital business card. People can update their details, while the corporate design stays untouched.

Every employee gets his own access via SSO to manage his own digital business card. This is the main difference from the Entra ID integration, where all cards are created in a single user instance.

Outdated cards can be deleted manually, automatically via SCIM or the API.

The following tutorial is for administrators that want to setup our platform so that employees of their company can create digital business cards. Please note that this is an enterprise feature. Please get in contact with us if you need help in setting up an enterprise account.

How to setup the Microsoft Entra ID to retrieve contact data via SSO

In the following steps you will learn how to log into our plattform, create a user and design a default business card template for all employees as an administrator of your company.

1. Log into your account as administrator

Please log into your administrator account on our QR Platform.

Login

Login
Login Form

2. Create a new user

When in the user overview, please click Create User and then log into the new user. 

Screenshot of User overview
Create a user for your business card template(s)

3. Create a Digital Business Card

Once logged into the user instance, please create your first business card. This card will be used as template for the imported cards, so it should have the full look and feel you are aiming for.

Screenshot Landing Page Editor
Create your template business card to be used for future imports.
We highly suggest using a CSS-template in your template business card, so future changes can be done centrally by editing the CSS-template.

Find more information on creating your first business card.

4. Connect your account to your Microsoft Entra ID

Now, please follow the instructions on connecting your MS Entra ID. Make sure to choose the 1:1-configuration (one user account per employee).

Screenshot MS Entra ID
Get in touch with your IT to set up the connection.
The article above contains technical details for IAM Admins or 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 the SSO connection. 

5. Enable profile pictures by setting up Microsoft Graph

a) Get and store your Client ID

Visit the tenant in question. In the Overview you will find the Application (client) ID. Copy and save it for later use.

Screenshot of Entra ID Client ID
Copy and save the Client ID.

b) Create a client secret

Go to Manage > Certificates & secrets and change to the tab Client secrets. Hit New client secret, choose a name and set an expiration date (max. 24 months).

Once the client secret has been created, please copy the Value (not Secret ID) immediatly and save it for later use.

Screenshot of EntraID client secret
Create and copy the client secret

c) Create an API permission

Next, please go to Manage > API permissions and click Add a permission. Select Microsoft Graph and then Application Permissions (NOT delegated).

Screenshot of Microsoft Graph
Choose Microsoft Graph > Application Permissions

Search for:

  • User.Read.All
  • User.ReadBasic.All

Check both boxes and click Add permissions.

Screenshot of API permissions
Add an API permission

Then confirm Grant admin consent for QR Planet GmbH. Now, you should see two green checkmarks in the list of API Permissions.

Screenshot of granted API permissions
If everything worked out, you should see something like this.

d) Add the data into your QR Code account

Log into your QR Planet account, go to Account > SSO > EntraID Advanced Settings, and enter your previously saved Client ID and Client Secret Value.

Screenshot of QR Planet account settings
Enter your ClientID and Client Secret Value.

6. Set the template in the account settings of the administrator

Please open your Account settings, navigate to Admin User Settings and choose your previously created template in the Business Card Template field.

Screenshot of admin account options
Set your business card template for all SSO-users under Account > Admin User Settings

You have successfully setup the platform so that employees of your company can login via SSO and manger their digital business card. Below, you will see the process of creating a business card via SSO-Login from user perspective.

How to set up your personal business card via SSO

1. Visit the business card page and log in via SSO

Visit your company's business card site, as provided by your administrator, e.g. id.yourcompany.com. Once there, use the SSO Login button to proceed.

Screenshot of SSO-Login Page
Hit SSO Login to start the process.

2. Choose your personal company Microsoft account

Next, a pop-up will appear in the browser. Please pick your Microsoft account or enter new credentials. 

Screenshot of Microsoft "pick an account" popup
Choose a connected account or use another one.
Your data will now be fetched from MS Entra ID and transmitted into your personal digital business card user, while you will be forwarded to the business card editor.

3. Edit and/or save the content of your future business card

Finally, check your data, change what needs changing, add what needs adding - and save your business card. 

Screenshot of Landing Page Editor
Add, alter and save your business card.
You can always change your card at any time by revisiting your company's business card page and logging in with the same Microsoft account via SSO.

Learn next how to store your digital business card to your Apple or Google Wallet in the related articles section.

Last update 2 days ago