All Collections
Cards (Digital Business Cards)
Integrations
Create digital business cards for your employees using Microsoft Azure AD + Uniqode Cards integration
Create digital business cards for your employees using Microsoft Azure AD + Uniqode Cards integration

Integrate Uniqode Cards with your organization's Azure Active Directory to easily create digital business cards for your employees.

Sreenidhi MJ avatar
Written by Sreenidhi MJ
Updated over a week ago

Microsoft Entra ID (Azure Active Directory (AD)) 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 enroll 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 (Azure AD) active account with administrator privileges.

Integrate your Uniqode account with Entra ID (Azure AD)

Get your Uniqode account's API Key and Tenant URL

  1. Sign in to your Uniqode account.

  2. Click Cards in the top-left.

  3. 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 (Azure AD) from the top-right corner near bell icon.


    Note: If you are an admin of any other organization, you can only integrate Entra ID (Azure AD) with that specific organization.


  4. Click Integrations in the left menu, then click Active Directory.

  5. Copy YOUR API KEY and Tenant URL.

Add your Uniqode account to Entra ID (Azure AD)

  1. Now, sign in to your Entra ID (Azure AD) account, then click Enterprise applications.

  2. Click New application in the All applications tab.

  3. Click Create your own application.

  4. Name the app "Uniqode", then select Integrate any other application you don't find in the gallery (Non-gallery).

  5. Click Create.

Configure Entra ID (Azure AD) to integrate with Uniqode

  1. Click Provisioning under the Manage section in the left menu.

  2. Click Get started.

  3. Choose Automatic for the Provisioning Mode.

  4. Paste the copied Tenant URL and YOUR API KEY in the Tenant URL and Secret Token fields, respectively.

  5. Click Test Connection.

  6. Wait until the connection is tested successfully, then click Save in the top-left corner.

Create and configure your Cards template

  1. Go back to your Uniqode account.

  2. Click Cards in the top-left.

  3. Click Integrations in the left menu, then click Active Directory.

  4. Click Manage Configuration.

  5. Under the Templates tab, select the desired template that you want to assign for your employees' cards.

  6. 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 Azure Active Directory to their cards. To obtain the credentials:

      1. Sign in to your Azure Active Directory account.

      2. Click Microsoft Entra ID.

      3. Click App registrations in the left menu.

      4. Click on the app “Uniqode” from All Applications.

      5. Copy the Application (client) ID and Directory (tenant) ID.

      6. Click API permissions in the left menu.

      7. Click + Add a permission, then click Microsoft Graph.

      8. Click Application permissions, then search for User.Read.All and select it.

      9. Click Add permissions.

      10. Now, click Certificates & secrets, then click + New client secret.

      11. Provide a description of the secret to be “Uniqode profile picture” and choose the expiry date. Click Add.

      12. Copy the Value.

      13. 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.

  7. Click Save changes.

Integrate Entra ID (Azure AD) 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 Unioqde for different purposes and requires Entra ID (Azure AD) integration. In this scenario, you can integrate each organization in Unioqde with Entra ID (Azure AD) separately. Similar to integrating Entra ID (Azure AD) with a single organization, you would select the organization, create an enterprise application in Entra ID (Azure AD), and assign users. You can only create one enterprise application in Entra ID (Azure AD) for one organization. But, you can create and integrate multiple enterprise applications for one organization. So, to integrate with other organizations, you can repeat this process for the other organizations as well.

To integrate Entra ID (Azure AD) with multiple organizations:

  1. Sign in to Unioqde as the account owner.

  2. Click Cards in the top-left corner.

  3. Choose the organization that you want to integrate with Entra ID (Azure AD) from the top-right corner near bell icon.


  4. Note: While naming your app, give another name with respect to the organization for which you are integrating your Entra ID (Azure AD).


Test your Entra ID (Azure AD) integration

  1. Go back to the Enterprise applications, then click "Unioqde". Click Provisioning under the Manage section in the left menu.

  2. Click Edit provisioning.

  3. Expand the Mappings option, then disable Provision Azure Active Directory Groups. Click Save, then again click Save in the pop-up that appears.

  4. 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:

    1. 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.

    2. Click Add user/group, then click User. Select a user for whom you want to test the card creation.

    3. 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 will take about 40 minutes to create cards for the new employees who are being added to Entra ID (Azure AD). To know when your account has been last synced with Entra ID (Azure AD), 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:

  1. Click on your profile in the top-right corner.

  2. Click User management.

  3. Select the users to whom you want to send the invite.

  4. Click Send Invite.

  5. 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 delete a user from your Entra ID (Azure AD), they are automatically removed from Unioqde account, and/or their card will also be deleted in the following cases:

  1. When you add a user to Uniqode via Entra ID (Azure AD), a user seat will be consumed, and their card will be created. If you remove that user from your Entra ID (Azure AD), their account and card will be deleted from Beaconstac, and the user seat will be freed.

  2. 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 (Azure AD), when you sync, a card will be created for that user automatically. When you delete that user from your Entra ID (Azure AD), only their card will be deleted from your Beaconstac account. You need to manually remove that user from your organization in Beaconstac.

Please note that users with Viewers or Editors cannot delete the users or cards created via Entra ID (Azure AD) in your organization in Uniqode.


Note: If you are trying to delete an admin or owner who has integrated Entra ID (Azure AD) with Uniqode, please transfer their ownership to another user.


Did this answer your question?