Skip to content

Azure AD integration with MFA

VC Hub identity provider supports integration with Azure AD (Microsoft Entra ID). After integration, users can sign in through Entra ID and use multi-factor authentication (MFA), which improves account security.

Prerequisites

  • Access to Azure portal: https://portal.azure.com/
  • Permission to create app registrations in Microsoft Entra ID
  • VC Hub login URL and logout URL
  • A test user account in Entra ID

Configure Microsoft Entra ID

  1. Sign in to the Azure portal, then open Microsoft Entra ID.

Open Microsoft Entra ID

  1. In the left panel, select App registrations, then select + New registration.

Create app registration

  1. Open Authentication for the app registration. In Web redirect URIs, add the VC Hub login URL and logout URL.

Configure redirect URIs

  1. Open Token configuration, then add the required optional claims.

Configure token claims

  1. Open Certificates & secrets, then create a client secret.

Create client secret

  1. Copy the Application (client) ID.

Copy client ID

  1. Copy the client secret value.

Copy client secret

  1. Open Overview, select Endpoints, then copy the OpenID Connect metadata document URL.

Copy OpenID metadata URL

Enable MFA for users

  1. Return to the root of Microsoft Entra ID, then open Users.

Open Users

  1. Select Per-user MFA.

    Open Per-user MFA

  2. Select the target users and choose Enable MFA.

    Enable MFA

Configure VC Hub identity provider

  1. In VC Hub, open the identity provider page and create a new provider using:

  2. Client ID

  3. Client secret
  4. OpenID Connect metadata document URL

    Create VC Hub provider

Verify the login flow

  1. In the Azure AD provider settings, select Login Test. The browser should redirect to the Microsoft sign-in page.

    Redirect to Microsoft sign-in

    Microsoft sign-in page

  2. Sign in with a personal or domain account. A number-matching challenge is displayed.

    Number-matching challenge

  3. Enter the number in Microsoft Authenticator on the mobile device to complete authentication.

    MFA authentication complete