Setting up SAML-based SSO login for Testsigma in Azure

With Azure (by Microsoft) Active Directory, users can automatically sign into their cloud-hosted/on-premise applications for a hassle-free, secure sign-in experience.

You can use the Azure Active Directory Admin Center to enable single sign-on (SSO) for Testsigma. After you configure SSO, your users can sign in to our application by using their Azure AD credentials.

Prerequisites

- Azure Account with Active Directory enabled

- Admin Access to Azure Account

I. Adding Testsigma Enterprise Application

1. Login to Azure portal using the URL : https://portal.azure.com

   You will be taken to the home page as shown below:

2. Click the View button below “Manage Azure Active Directory”.
3. In the Active Directory Overview page, click on + New application and choose Enterprise Application

4. Click on + Create your own application In the overlay that opens up on the right, enter the name of the app you are integrating, i.e., Testsigma. Select option, ‘Integrate any other Application (Non-gallery)’ and click the Create button.

   

   You’ll be taken to the newly added Testsigma overview page.

   

II. Adding Users to the Enterprise Application

1. Click the Assign users and groups card to add the users in Azure AD to the recently added Testsigma app.
2. Click on the + Add user/group on top
3. In the next page, Add Assignment, click on the None selected link to open up the Users overlay. Select the required users from the Users overlay that opens up on the right.
4. Click on the Select button to pick and finalize the users list. You can find the list of added Users at the left pane under Users.
5. To add assignments to these users, click Assign.

III. SAML Configuration on Azure in Testsigma

1. Back in Testsigma Overview page on Azure, click option 2 i.e, Set up single sign on.
2. Select the SAML authentication option. You will be taken to the Setup Single Sign-on with SAML screen as shown below:
3. Click on the Edit button on Section 1 - Basic SAML Configuration, enter the following details, and click Save:

  Entity ID : https://app.testsigma.com/saml//metadata

  Reply URL : https://app.testsigma.com/saml//callback

  Sign on URL : (Leave it empty)

  Relay State : https://app.testsigma.com/saml//callback

  Logout URL : (Leave it empty)

Back in your Testsigma account, navigate to Settings > Security. Choose the SAML card and click Proceed.

You will see an exclusive SAML token identifier for your account.

4. You need to put this identifier in place of <id> in Step 3 and click Save.
5. Click on the Edit button of Section 2 - User Attributes & Claims. Under Required claim, click the Claim name/Claim value.
6. In the Manage Claim page that now appears, select Source attribute as user.email from the dropdown.
7. Click Save and go back to the previous SAML-based Sign-on page.
8. Click on the Edit button for section 3 - SAML Signing Certificate, enter the following details, and click Save:

  Signing Option: SAML response and assertion

  Signing Algorithm: SHA-256

That's all the configuration you need to perform on Azure App for SAML-based Sign-on.

9. Now, navigate back to the SAML Sign-on page Download the XML file, ‘Federation Metadata XML’ by clicking the Download link under Section 3 - SAML Signing Certificate.
10. Open the XML File and copy the value under the key EntityDescriptor > Signature > KeyInfo > X509Data > X509Certificate

You can just search for <X509Certificate> and copy the value between first occurrence of <X509Certificate> and <X509Certificate>

11. Note down the following values from Section 4 - Set Up Testsigma App.

  Azure AD Identifier

  Login URL

We will use the X509Certificate value, also the values above in Testsigma app in the next section.

IV. Azure Specific SAML Configuration in Testsigma

Inside your Testsigma account, navigate to Settings>Security

1. Click Proceed under SAML

Enter the following details:

• Entity ID: same as Azure AD Identifier (obtained from Section 4 in Azure SAML Setup page)
• SSO URL: same as Login URL (obtained from Section 4 in Azure SAML Setup page)
• SAML certificate: downloaded <X509Certificate> value (obtained in previous section from downloaded XML file). This value resides within the tag: <X509Certificate><X509Certificate> Paste this value.

2. Click the Confirm button to finalize the changes.

SAML will now be enabled,

Let’s test the SSO.

V. Test the SAML Config

1. On Section 5 of the Single Sign-On option, you will find the option to test. Click Test.
2. To test the sign-in, click on the ‘Sign in as current user’ option.

This will test the SAML-based login with the currently logged-in user.

This will automatically log you into Testsigma.