Microsoft Entra ID (Azure Active Directory) is a cloud identity and access management solution for managing your employees' identities securely and effectively. Integrating your Uniqode Cards account with Entra ID allows you to create digital business cards for your employees as soon as they enrol in your organization. For example, if you want to generate cards for ten employees who recently joined your organization, you can easily create and distribute cards for all the employees simultaneously.
Prerequisites
Uniqode Business+ plan with admin privileges.
Microsoft Entra ID active account with administrator privileges.
Integrate your Uniqode account with Microsoft Entra ID
Get your Uniqode account's API Key and Tenant URL
Sign in to your Uniqode Card saccount
If you are the account owner or admin of the master organization (super admin) and have multiple organizations, choose the organization that you want to integrate with Entra ID from the top-right corner near bell icon.
Note: If you are an admin of any other organization, you can only integrate Entra ID with that specific organization.
Click Integrations in the left menu, then click Microsoft Entra ID
Copy YOUR API KEY and Tenant URL
Add your Uniqode account to Entra ID
Now, sign in to your Entra ID account, then click Enterprise applications.
Click New application in the All applications tab
Click Create your own application
Name the app "Uniqode", then select Integrate any other application you don't find in the gallery (Non-gallery).
Click Create
Configure Entra ID to integrate with Uniqode
Click Provisioning under the Manage section in the left menu
Click Get started
Choose Automatic for the Provisioning Mode
Paste the copied Tenant URL and YOUR API KEY in the Tenant URL and Secret Token fields, respectively.
Click Test Connection
Wait until the connection is tested successfully, then click Save in the top-left corner.
Create and configure your Cards template
Go back to your Uniqode Cards account
Click Integrations in the left menu, then click Active Directory.
Click Manage Configuration
Under the Templates tab, select the desired template that you want to assign for your employees' cards.
In the Settings tab, you have the following options:
Note: Auto-save business cards, GPS location, and Two-way contact sharing settings are now managed under Organization Settings. If any of these settings are enabled or disabled, they will be applied to cards that will be created from then on.
Send user invite email - Enable to send an invite to join your organization and password reset link to the newly onboarded users via email to make them join your organization and reset their Uniqode account passwords.
Automatic domain-based user assignment - Enable to automatically assign users to their respective organization based on their domain.
Note: This feature can be enabled/disabled only by the organization’s owner or the admin of the master organization (super admin).Sync profile image of users - Enable to automatically import the newly onboarded users’ profile picture from Microsoft Entra ID to their cards. To obtain the credentials:
Sign in to your Azure Active Directory account
Click Microsoft Entra ID
Click App registrations in the left menu
Click on the app “Uniqode” from All Applications
Copy the Application (client) ID and Directory (tenant) ID.
Click API permissions in the left menu
Click + Add a permission, then click Microsoft Graph.
Click Application permissions, then search for User.Read.All and select it.
Click Add permissions
Now, click Certificates & secrets, then click + New client secret.
Provide a description of the secret to be “Uniqode profile picture” and choose the expiry date. Click Add.
Copy the Value
Go back to Uniqode, then paste the Application (client) ID, Directory (tenant) ID, and Value in the Application ID, Directory ID, and Client secret fields, respectively.
Click Save changes.
Integrate Entra ID with multiple organizations
Imagine you are the IT manager of a large IT company with three distinct departments. Each department is created as a separate Organization in Uniqode for different purposes and requires Entra ID integration. To do this, you need to integrate each organization individually.
For each organization:
1. Select the organization in Uniqode
2. Create an enterprise application in Entra ID
3. Assign users to this application
You can only create one enterprise application per organization in Entra ID. However, you can create multiple applications within a single organization if needed. To integrate the other departments, just repeat these steps for each organization.
To integrate Entra ID with multiple organizations:
Sign in to Uniqode Cards as the account owner
Choose the organization that you want to integrate with Entra ID from the top-right corner near bell icon
Note: While naming your app, give another name with respect to the organization for which you are integrating your Entra ID.
Test your Entra ID integration
Go back to the Enterprise applications, then click "Uniqode". Click Provisioning under the Manage section in the left menu.
Click Edit provisioning
Expand the Mappings option, then disable Provision Azure Active Directory Groups. Click Save, then again click Save in the pop-up that appears.
Go back to Provisioning. Expand the Settings option, then choose the Scope of the provisioning either for all users and groups or only for the assigned users. We recommend selecting Sync-only assigned users and groups to implement the provisioning among a small pool of users to check whether the integration is successful. For testing purposes, you can assign it to one user alone and check whether a card is created for them in the Unioqde dashboard QR Codes view. To assign the app to a specific user:
Click Save in the top-left corner to save the settings you have done so far. Go back to the app's page by clicking Uniqode | Provisioning, then click Users and groups under the Manage section in the left menu.
Click Add user/group, then click User. Select a user for whom you want to test the card creation.
Click Select, then click Assign.
Note: If you want to test whether the users are assigning properly, you can also enable provision on-demand for a small set of users by, clicking Provision on demand in the left menu, and assigning a user or a group.
5. Toggle the Provisioning Status to On, then click Save in the top-left corner.
Note: Please note that it may take up to 40 minutes to create cards for the new employees who are being added to Entra ID. To know when your account has been last synced with Entra ID, go back to your Uniqode Cards dashboard. Go to Integrations, then click Active Directory. You can view the time and date of the last sync.
Once done, all your employee cards will be listed on the Organization Cards page.
Resend email invites to the users
If your users haven't already accepted the invite to join your organization, you can re-send the invite emails again to them. To do so:
Click on your profile in the top-right corner
Click User management
Select the users to whom you want to send the invite
Click Send Invite
Click Confirm
Note: If you try to send the invite to a user who has already accepted the invite and joined your organization, they won't receive this email.
Delete users and their cards
When you permanently delete a user from your Entra ID, they are automatically removed from Unioqde account, and/or their card will also be deleted in the following cases:
When you add a user to Uniqode via Entra ID, a user seat will be consumed, and their card will be created. If you remove that user from your Entra ID, their account and card will be deleted from Uniqode, and the user seat will be freed.
When you add a user directly to your organization in Uniqode by inviting them, a user seat will be consumed. If the same user also exists in Entra ID, when you sync, a card will be created for that user automatically. When you delete that user from your Entra ID, only their card will be deleted from your Uniqode account. You need to manually remove that user from your organization in Uniqode.
Please note that users with Viewers or Editors cannot delete the users or cards created via Entra ID in your organization in Uniqode.
In case you mark a user inactive on Entra ID, their card will not be deleted from the Uniqode account. You can manually delete the card on Uniqode Cards or permanently delete the user from Entra ID to delete the card and user from your Uniqode account.
Note: If you are trying to delete an admin or owner who has integrated Entra IDwith Uniqode, please transfer their ownership to another user.