Skip to content

Microsoft Entra ID

Let your users sign in to Vipilink with their Microsoft Entra ID account.

You register one app in Microsoft Entra ID and add its client ID and secret in Vipilink.

Before you start

  • You're an admin in Microsoft Entra ID and in Vipilink.
  • Your company's domain, for example example.com, is verified in Microsoft Entra ID. You can check it in Entra ID → Domain names.
  • You know your Vipilink workspace address, for example https://example.vipilink.com. In the steps below, replace example with your workspace name.
  • Every user who signs in with Microsoft must already have a Vipilink account with the same email address. Signing in with Microsoft doesn't create Vipilink users.

Step 1: Register the app

  1. Sign in to the Microsoft Entra admin center.
  2. Go to Entra ID → App registrations (1) and click New registration (2).

    App registrations with App registrations and New registration numbered

  3. Fill in the form:

    Register an application with the name, supported account types and redirect URI numbered

    Field Value
    1 Name Vipilink
    2 Supported account types Single tenant only, followed by your tenant name
    3 Redirect URI Web, then https://example.vipilink.com/callback
  4. Click Register at the bottom of the page. The app's Overview opens.

Step 2: Copy the client ID

On the app's Overview, under Essentials, copy the Application (client) ID (1). You need it in Vipilink.

App overview with the Application (client) ID numbered

Step 3: Create a client secret

  1. In the app's menu, click Certificates & secrets (1). On the Client secrets tab (2), click New client secret (3).

    Certificates & secrets with Client secrets and New client secret numbered

  2. In Add a client secret, enter a Description, for example Vipilink (1), and choose when it Expires (2). Click Add.

    Add a client secret with the description and expiry numbered

  3. In the list, copy the Value of the new secret (1). Copy the Value, not the Secret ID.

    Client secrets list with the secret value numbered

Copy the value now

Microsoft Entra ID shows the secret's Value only right after you create it. If you lose it, create a new client secret.

Before the secret expires

When the client secret expires, users can't sign in with Microsoft anymore. Before that date, create a new client secret and add it in Vipilink: in the Microsoft Entra ID card's ... menu, click Edit Provider and enter the new Client Secret.

Step 4: Check your users' email

Vipilink finds the user by the email address that Microsoft Entra ID sends at sign-in. Microsoft Entra ID sends it only when the user's Email property is filled in. Users with a mailbox usually have it already.

For each user who signs in to Vipilink:

  1. Go to Entra ID → Users and open the user.
  2. On the Properties tab, check Email under Contact Information.
  3. If it's empty, click Edit properties, enter the user's email address under Contact Information, and save. Use the same address as the user's Vipilink account.
  1. In Vipilink, go to Settings → Identity Providers and click Add Provider.
  2. Choose Microsoft Entra ID (1) and click Next (2).

    Add Identity Provider with Microsoft Entra ID and Next numbered

  3. Fill in the form:

    Microsoft Entra ID form with the domain, client ID, client secret and Finish numbered

    Field What to enter
    1 Microsoft Entra ID Domain Your company's domain that is verified in Microsoft Entra ID, for example example.com. Enter only the domain, not a URL.
    2 Client ID The Application (client) ID from Step 2.
    3 Client Secret The secret Value from Step 3.

    Domain Aliases is optional: other email domains of your company that should sign in with Microsoft Entra ID, for example example.co.uk next to example.com.

  4. Click Finish (4). Microsoft Entra ID appears on the Identity Providers page with your domain under Domains.

    Identity Providers page with the Microsoft Entra ID provider highlighted

Step 6: Test the sign-in

  1. Open your workspace address in a private browser window. The sign-in page now has a Sign In With Microsoft Entra ID button. Click it.

    Vipilink sign-in page with Sign In With Microsoft Entra ID highlighted

  2. Sign in with a Microsoft Entra ID account that has a Vipilink account.

  3. The first time, Microsoft asks for Permissions requested. Click Accept.

    Permissions requested with Consent on behalf of your organization highlighted

    If you're an admin, you can select Consent on behalf of your organization before you click Accept. Then your other users don't see this screen.

Troubleshooting

Problem What to check
An error after you sign in with Microsoft The user's Email property in Microsoft Entra ID is empty. See Step 4.
The user can't sign in although the email is set The user needs a Vipilink account with the same email address. To add users, see Users.
"Unable to find a registered Entra ID domain." when you save the provider Microsoft Entra ID Domain must be a domain that is verified in Microsoft Entra ID, for example example.com, not a URL.
Sign-in stopped working for everyone The client secret may have expired. Create a new one and update it in Vipilink with Edit Provider.

SCIM provisioning

SCIM provisioning is available on the Enterprise plan. The setup guide for Microsoft Entra ID is coming soon. Contact support if you'd like help setting it up now.

Two-factor authentication and access

In the Microsoft Entra ID card's ... menu you can also:

  • Manage 2FA: ask Microsoft Entra ID users for a code from an authenticator app. See Two-factor authentication.
  • Manage Access: choose which Vipilink groups can sign in with Microsoft Entra ID. See Access groups.