Skip to main content

Configure Azure AD as SAML-Based SSO Provider

To use Azure Active Directory (AD) as the SSO identity provider (IdP) with Virtana Platform, you must add Virtana Platform to Azure AD as a managed SaaS application. You then assign users to the application in Azure.

About This Task

  • After configuring the IdP, you must copy the metadata URL, which is needed for Virtana Platform


You need an Administrator role in Microsoft Azure with privileges to create applications and assign users and groups.

  • You must have set up a SAML 2.0 application with your IdP.

  • You must have administrator privileges in both IdP and Virtana Platform.

  • You must have an appropriate Virtana Platform license to use SSO.


  1. Log in to Microsoft Azure as Administrator.

  2. Click the hamburger menu in the navigation pane and select Azure Active Directory>Enterprise applications.

    Screenshot of Azure UI, select Enterprise applications
  3. Click New application and Create your own application, then complete the following:

    1. Enter the name of the application.

    2. Select Integrate any other application you don't find in the gallery (Non-gallery).

    3. Click Create.

  4. Navigate back to Azure Active Directory>Enterprise applications>All applications and select the application you just created.

    It might take a minute before the new application displays.

  5. In the left navigation pane, click Single sign-on and select the SAML option.

  6. On the SAML-based Sign-on page, click Edit for Basic SAML Configuration and complete the following:

    If Keycloak is disabled:

    • Set the Identifier (Entity ID) to

    • Set Reply URL (Assertion Consumer Service URL) to

    If keycloak is enabled:

    • Set the Identifier (Entity ID) to https://keycloak.oc.<env><org_id>

    • Set Reply URL (Assertion Consumer Service URL) to: https://keycloak.oc.<env><org_id>/broker/<org_id>-saml-config/endpoint


      <env> is the variable used for your locale. For example:

      <org_id> is the organisational UUID for the given organisation. You can contact Virtana Support team to get your UUID.

  7. Click Edit for Attributes & Claims and add or update the following fields, which will be used to authenticate the user

    If Keycloak is disabled:

    • externalId: user.mail

    • firstName: user.givenname

    • lastName: user.surname

    If Keycloak is enabled:

    • firstName: user.givenname

    • lastName: user.surname

    • email: user.mail

    • username: user.mail

    Leave name and Unique User Identifier unchanged.


    The Azure AD user profile must have firstName, lastName, and Mail configured. Otherwise, the integration will fail.

  8. Ensure the Claim name for externalId, firstName, and lastName are properly configured.

    If Keycloak is disabled:

    On the Attributes & Claims edit page, make sure the Claim names for externalId, firstName and lastName do NOT have a Namespace URI (XML schema URL) prepended, like the other two attributes. If the format of these fields is changed, SSO will not work properly with Virtana.

    screenshot of Azure attributes & claims page, showing expected configuration

    If Keycloak is enabled:

    Ensure the Claim name for email, username, firstName, and lastName are properly configured.

    On the Attributes and Claims edit page, make sure the Claim names for email, username, firstName and lastName do NOT have a Namespace URI (XML schema URL) prepended, like the other two attributes. If the format of these fields is changed, SSO will not work properly with Virtana.

  9. In the SAML Certificates section, copy the value for App Federation Metadata Url.

    You will need to add this URL in Virtana Platform when you configure SSO.

  10. Navigate to Users and Groups , click Add user/group and select the users or groups to be added to the SSO application.

    If you do not have the required privileges to manage users and groups, contact the administrator at your company with those rights.


    The username must be in the form firstName.lastName@companyName.extension. Example:

This completes the creation and configuration of the SSO application in Azure. You can log in to Virtana Platform to proceed with setup.

Next Steps:

Add the Azure SSO configuration to Virtana Platform.