Configure QAComplete Application in Azure Active Directory

Applies to QAComplete 14.5, last modified on August 06, 2024

To start using Azure Active Directory to log in to QAComplete, you need to add your QAComplete application to your Azure instance first.

  1. Log in to Azure Portal using an administrator account.

  2. On the menu bar on the left, select Azure Active Directory:

    Azure Active Directory: The Azure Active Directory menu item

    Click the image to enlarge it.

  3. The Overview screen will appear. In the Manage section on the left, select Enterprise applications:

    Azure Active Directory: The Enterprise applications menu item

    Click the image to enlarge it.

  4. Double-click New Application:

    Azure Active Directory: The New application button

    Click the image to enlarge it.

  5. In the subsequent Add an Application form, double-click Non-gallery application:

    Azure Active Directory: The Non-gallery application button

    Click the image to enlarge it.

  6. In the Name edit box, specify a comprehensive name that will be used for your QAComplete instance throughout Azure Active Directory:

    Azure Active Directory: The Add your own application form

    Click the image to enlarge it.

  7. Click Add at the bottom of the form.

  8. Wait a bit – your application will be added to your Azure instance. After that, the Overview screen will appear:

    Azure Active Directory: The application overview screeen

    Click the image to enlarge it.

  9. In the Manage section on the left, select Single sign-on:

    Azure: The Single sign-on menu item

    Click the image to enlarge it.

  10. In the form that appears, select SAML:

    Azure: The SAML method

    Click the image to enlarge it.

  11. Provide information about your QAComplete instance:

    Azure: QAComplete credentials

    Click the image to enlarge it.

    Option QAComplete SaaS QAComplete On-Premises
    Identifier (Entity ID)1 https://qacomplete.smartbear.com https://<your server name>
    Reply URL https://<your SaaS domain>2.qacomplete.smartbear.com/sso/callback https://<your server name>/sso/callback
    Sign on URL Select Show advanced URL settings to show this edit box.
    The value in it should be identical to the Reply URL value.

    1 It will be Identity Provider Issuer in QAComplete. Store this value in a safe location.

    2 Use the value of the Domain name field. You can find it in  > Setup > Security > Single Sign-On Administration in QAComplete.

    For QAComplete On-Premises users: Please keep in mind that Azure Active Directory supports the HTTPS protocol only. You will not be able to configure the connection between Azure Active Directory and a QAComplete instance that uses the HTTP protocol.

  12. In User Identifier below, select user.mail.

  13. Select the View and edit all other user attributes check box and make sure the following mapping rules are configured:

    Name Value
    firstName user.givenname
    lastName user.surname

    See the screenshot below:

    Azure: SAML token attributes

    Click the image to enlarge it.

  14. Next, scroll down to the Configuration section and click Configure application.

  15. Retrieve the necessary data to configure QAComplete:

    Azure: Single sign-on service credentials

    Click the image to enlarge it.

    • entityId (Identity Provider Issuer): Identifier (Entity ID)
    • Identity provider Single Sign-On URL: SAML Single Sign-On Service URL
    • From SAML XML Metadata:
      • X.509 certificate: The text between the <X509Data> tags.

    Store this data in a safe location.

  16. Click Save.

    Azure Active Directory: The Save button

    Click the image to enlarge it.

Now, your QAComplete instance should be available as an application in Azure Active Directory.

Next steps

  1. Assign users to the QAComplete application in Azure Active Directory.

  2. Configure QAComplete to use Azure Active Directory single sign-on.

See Also

Assign Users to Applications in Azure
Configure QAComplete for Single Sign-On
Azure Active Directory

Highlight search results